FF122 Clipboard async API in preview/late beta #21667

hamishwillee · 2023-12-19T00:30:15Z

FF122 enables the dom.events.asyncClipboard.clipboardItem and dom.events.asyncClipboard.readText on preview ( @IS_EARLY_BETA_OR_EARLIER@) in https://bugzilla.mozilla.org/show_bug.cgi?id=1809106

This updates the corresponding Clipboard and ClipboardItem interfaces to be in preview, deleting some of the older versions.

Note that it is in draft while I confirm some behaviours: https://bugzilla.mozilla.org/show_bug.cgi?id=1809106#c14

Related docs work can be tracked in mdn/content#31104

api/Clipboard.json

…ard.clipboardItem items

api/Clipboard.json

hamishwillee · 2024-01-02T00:18:04Z

I'm still waiting on confirmations on whether there are additional off-spec restrictions, but I think this is correct.

hamishwillee · 2024-01-05T01:38:28Z

@queengooborg @Elchi3 Any chance I could get some advice on this - not nagging - just aware I am away for a couple of weeks after Tuesday. If you can't do it, then no worries.

hamishwillee · 2024-01-05T02:57:14Z

EDITED.

Spec says

secure context for read write.
read clipboard with transient activation
read clipboard with prompt for content initiated from browser/OS "paste element" (i.e. a menu)
write with permission API, which may or may not require transient activation.

---Chromium---

This went in in 107 https://chromium.googlesource.com/chromium/src/+/10300ac7da93a7e322274f1e

Writes of plain text/image will require either a user gesture or a permission grant. (but no gesture if permission granted).
Previously anything could be written anytime
Reading requires permission grant but no transient activation.

Also requires Permission-Policy from 85 https://chromestatus.com/feature/5767075295395840

There's a new API for reading unsanitised data https://chromestatus.com/feature/5716132676763648 in 122. It is Chrome only, and likely to remain Chrome only.

--- Firefox ---

Firefox requires secure context and transient activation to read or write to the clipboard.
It does not use, or plan to use Permission API permissions.
For reading, the spec expects a prompt when reading content due to interaction with a user-agent or browser paste element. Firefox suppresses this prompt when pasting content copied from a same-origin page.

The Firefox security considerations for Web Extensions are slightly different:

Reading text is only available for extensions with the Web Extension clipboardRead permission.
With this permission the extension does not require transient activation or a paste prompt.
Writing text is available in secure context and transient activation.
With the Web Extension clipboardWrite permission transient activation is not required.

hamishwillee · 2024-01-08T09:47:33Z

api/Clipboard.json

+            "chrome": {
+              "version_added": "66",
+              "partial_implementation": true,
+              "notes": [
+                "From version 86, the <code>text/html</code> MIME type is supported.",
+                "From version 85, Requires Permission-Policy <code>clipboard-read</code> permission.",
+                "From version 76, the <code>image/png</code> MIME type is supported.",
+                "From version 66, the <code>text/plain</code> MIME type is supported.",
+                "Requires Permission API <code>clipboard-read</code> permission. Does not require transient activation."
+              ]
+            },


FYI, given that these are all partial implementations, combining the notes like this makes them much easier to use (this is what was done in the other methods). We could consider adding a subfeature for the supported MIME types.

I'm a bit unclear why Chrome is marked partial_implementation when other browsers have similar (amounts of) notes and aren't marked partial.

Maybe "Does not require transient activation." is the thing that Chrome should have in order to be not-partial?

@Elchi3 TBH I did not modify partial and did not really think about it. TLDR; - my take is that probably should make this no longer partial - do you want me to take care of it?

I suspect that this was partial originally waiting on From version 85, Requires Permission-Policy clipboard-read permission.",. The spec now no longer requires clipboard-read so you could argue it should always have been full implementation. Either way we never remove "full implementation" due to later changes, so it should be full now.

The whole thing is messy because all the other browsers are using transient activation and never intend to implement permissions. The spec has PRs against it to change it this way, but they are unlikely to be accepted without consensus with Chrome. So you might argue that the other browsers are partial implementations against the current spec. I think that just complicates things so we'd best just make them all full.

If you need a more detailed explanation might be best to have a call with me or WillB who have worked through it.

TLDR; - my take is that probably should make this no longer partial - do you want me to take care of it?

yeah, I think we should treat everyone the same at least. Thanks for dealing with the messy compat story here.

api/Clipboard.json

hamishwillee · 2024-01-08T09:50:40Z

Updated to reflect the information gathered in #21667 (comment).

It omits the new subfeatures discussed in https://chromestatus.com/feature/5716132676763648. I'll probably do those in a follow on.

…o ff122_clipboard_async

…ee/browser-compat-data into ff122_clipboard_async

api/Clipboard.json

Elchi3

I'm going to merge this. It seems like an overall improvement and we can follow-up with more if needed.

This status for read() and readText() isn't clearly explained by the notes, but seems to have been carried forward when merging compat statements in mdn#21667. Since the required formats are now supported, it doesn't make sense to continue to claim partial implementation. mdn#7991 would make this clearer still.

github-actions bot added the data:api Compat data for Web APIs. https://developer.mozilla.org/docs/Web/API label Dec 19, 2023

hamishwillee commented Dec 19, 2023

View reviewed changes

api/Clipboard.json Outdated Show resolved Hide resolved

hamishwillee commented Dec 19, 2023

View reviewed changes

api/Clipboard.json Outdated Show resolved Hide resolved

hamishwillee commented Dec 19, 2023

View reviewed changes

api/Clipboard.json Outdated Show resolved Hide resolved

hamishwillee mentioned this pull request Dec 19, 2023

[WebAPI] Enable dom.events.asyncClipboard.clipboardItem and dom.events.asyncClipboard.readText on Nightly mdn/content#31104

Closed

10 tasks

evilpie mentioned this pull request Dec 19, 2023

Updates for Firefox 122 beta #21678

Merged

hamishwillee commented Dec 28, 2023

View reviewed changes

api/Clipboard.json Outdated Show resolved Hide resolved

hamishwillee changed the title ~~Ff122 clipboard async~~ FF122 Clipboard async API in preview/late beta Dec 28, 2023

hamishwillee commented Dec 28, 2023

View reviewed changes

api/Clipboard.json Outdated Show resolved Hide resolved

This comment was marked as spam.

Sign in to view

kailando reviewed Dec 31, 2023

View reviewed changes

api/Clipboard.json Outdated Show resolved Hide resolved

hamishwillee commented Jan 1, 2024

View reviewed changes

api/Clipboard.json Outdated Show resolved Hide resolved

hamishwillee commented Jan 1, 2024

View reviewed changes

api/Clipboard.json Outdated Show resolved Hide resolved

hamishwillee added 8 commits January 2, 2024 10:48

FF122 Clipboard and ClipboardItem in nightly - dom.events.asyncClipbo…

3750bce

…ard.clipboardItem items

Clipboard - readText works for users not just extensions

91be803

Clipboard.readText looks supported too

d2c13a0

Update api/Clipboard.json

b3219d1

Update api/Clipboard.json

942ed95

Update api/Clipboard.json

720af4a

Update api/Clipboard.json

417f1db

Fix up and rebase

64b2998

hamishwillee force-pushed the ff122_clipboard_async branch from 316df88 to 64b2998 Compare January 1, 2024 23:53

hamishwillee commented Jan 2, 2024

View reviewed changes

api/Clipboard.json Outdated Show resolved Hide resolved

Update api/Clipboard.json

477f47e

hamishwillee commented Jan 2, 2024

View reviewed changes

api/Clipboard.json Outdated Show resolved Hide resolved

hamishwillee commented Jan 2, 2024

View reviewed changes

api/Clipboard.json Outdated Show resolved Hide resolved

hamishwillee marked this pull request as ready for review January 2, 2024 00:16

hamishwillee requested a review from queengooborg January 2, 2024 00:16

hamishwillee requested a review from kailando January 5, 2024 01:37

hamishwillee added 3 commits January 5, 2024 14:06

Chrome uses permissions and not transient activation

1530208

Chrome make read match write methods using single feature and notes

f467c80

Chrome features now in one entry with notes - much more readable

1729785

hamishwillee commented Jan 8, 2024

View reviewed changes

api/Clipboard.json Outdated Show resolved Hide resolved

Update api/Clipboard.json

4f33d1e

hamishwillee added 3 commits January 8, 2024 22:25

Fix write

ae16292

Merge branch 'main' of https://github.com/mdn/browser-compat-data int…

165472c

…o ff122_clipboard_async

Merge branch 'ff122_clipboard_async' of https://github.com/hamishwill…

f26dc3f

…ee/browser-compat-data into ff122_clipboard_async

hamishwillee commented Jan 8, 2024

View reviewed changes

api/Clipboard.json Outdated Show resolved Hide resolved

Update api/Clipboard.json

2148c84

Elchi3 approved these changes Jan 22, 2024

View reviewed changes

Elchi3 merged commit b80c12b into mdn:main Jan 22, 2024
6 checks passed

foolip mentioned this pull request Jul 10, 2024

Remove partial implementation status from async clipboard #23735

Closed

foolip mentioned this pull request Jul 10, 2024

Clipboard API: clean up notes and create subfeatures for MIME types #23593

Merged

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

FF122 Clipboard async API in preview/late beta #21667

FF122 Clipboard async API in preview/late beta #21667

hamishwillee commented Dec 19, 2023 •

edited

Loading

This comment was marked as spam.

hamishwillee commented Jan 2, 2024

hamishwillee commented Jan 5, 2024

hamishwillee commented Jan 5, 2024 •

edited

Loading

hamishwillee Jan 8, 2024

Elchi3 Jan 22, 2024

Elchi3 Jan 22, 2024

hamishwillee Jan 25, 2024

Elchi3 Jan 26, 2024

hamishwillee commented Jan 8, 2024

Elchi3 left a comment

FF122 Clipboard async API in preview/late beta #21667

FF122 Clipboard async API in preview/late beta #21667

Conversation

hamishwillee commented Dec 19, 2023 • edited Loading

This comment was marked as spam.

hamishwillee commented Jan 2, 2024

hamishwillee commented Jan 5, 2024

hamishwillee commented Jan 5, 2024 • edited Loading

hamishwillee Jan 8, 2024

Choose a reason for hiding this comment

Elchi3 Jan 22, 2024

Choose a reason for hiding this comment

Elchi3 Jan 22, 2024

Choose a reason for hiding this comment

hamishwillee Jan 25, 2024

Choose a reason for hiding this comment

Elchi3 Jan 26, 2024

Choose a reason for hiding this comment

hamishwillee commented Jan 8, 2024

Elchi3 left a comment

Choose a reason for hiding this comment

hamishwillee commented Dec 19, 2023 •

edited

Loading

hamishwillee commented Jan 5, 2024 •

edited

Loading