Skip to content

Commit

Permalink
Clarify notes about clipboard permissions
Browse files Browse the repository at this point in the history 
The notes about version 85 appear to be about this change:
https://chromestatus.com/feature/5767075295395840

However, there is no requirement to use the feature policy or permission
policy, that is only used to constrain a page more than the default,
typically to disallow requesting a permission at all.

It was confirmed that the two permissions go back to Chrome 66, by
testing `navigator.permissions.query({name: "clipboard-read"})` and
"clipboard-write" in DevTools in Chrome 66.

The only remaining noteworthy thing is the behavior around user
activation. The existing claims in the notes weren't double checked,
just carried forward while updating permissions language.

Drive-by: fix surpressed typo in Firefox notes
  • Loading branch information
@foolip
foolip committed Jul 10, 2024
1 parent e1af2c2 commit 09fa945
Showing 1 changed file with 10 additions and 10 deletions.
20 changes: 10 additions & 10 deletions api/Clipboard.json
View file
Original file line number Diff line number Diff line change
Expand Up @@ -46,7 +46,7 @@
"support": {
"chrome": {
"version_added": "66",
"notes": "From version 85, the <code>Permissions-Policy clipboard-read</code> header is required."
"notes": "The user must grant the <code>clipboard-read</code> permission."
},
"chrome_android": "mirror",
"edge": "mirror",
Expand All @@ -55,7 +55,7 @@
"notes": [
"This method must be called within user gesture event handlers.",
"Web extensions require the <code>clipboardRead</code> permission in manifest to read data. With this permission, the extension does not require a user interaction and does not display a paste prompt.",
"A paste prompt is displayed when the clipboard is read. If the clipboard contains same-origin content, the prompt is surpressed."
"A paste prompt is displayed when the clipboard is read. If the clipboard contains same-origin content, the prompt is suppressed."
]
},
"firefox_android": "mirror",
Expand Down Expand Up @@ -124,7 +124,7 @@
"support": {
"chrome": {
"version_added": "66",
"notes": "From version 85, the <code>Permissions-Policy clipboard-read</code> header is required."
"notes": "The user must grant the <code>clipboard-read</code> permission."
},
"chrome_android": "mirror",
"edge": "mirror",
Expand All @@ -133,7 +133,7 @@
"notes": [
"This method must be called within user gesture event handlers.",
"Web extensions require the <code>clipboardRead</code> permission in manifest to read data. With this permission, the extension does not require a user interaction and does not display a paste prompt.",
"A paste prompt is displayed when the clipboard is read. If the clipboard contains same-origin content, the prompt is surpressed."
"A paste prompt is displayed when the clipboard is read. If the clipboard contains same-origin content, the prompt is suppressed."
]
},
"firefox_android": "mirror",
Expand Down Expand Up @@ -267,8 +267,8 @@
"chrome": {
"version_added": "66",
"notes": [
"From version 107, this method must be called within user gesture event handlers, or the page must include the <code>Permissions-Policy clipboard-write</code> header.",
"From version 85, the <code>Permissions-Policy clipboard-write</code> header is required."
"From version 107, this method must be called within user gesture event handlers, or the user must grant the <code>clipboard-write</code> permission.",
"Before version 107, the user must grant the <code>clipboard-write</code> permission."
]
},
"chrome_android": "mirror",
Expand All @@ -280,7 +280,7 @@
"notes": [
"This method must be called within user gesture event handlers.",
"Web extensions require the <code>clipboardWrite</code> permission in manifest to read data. With this permission, the extension does not require a user interaction and does not display a paste prompt.",
"A paste prompt is displayed when the clipboard is read. If the clipboard contains same-origin content, the prompt is surpressed."
"A paste prompt is displayed when the clipboard is read. If the clipboard contains same-origin content, the prompt is suppressed."
]
},
"firefox_android": "mirror",
Expand Down Expand Up @@ -315,8 +315,8 @@
"chrome": {
"version_added": "66",
"notes": [
"From version 107, this method must be called within user gesture event handlers, or the page must include the <code>Permissions-Policy clipboard-write</code> header.",
"From version 85, the <code>Permissions-Policy clipboard-write</code> header is required."
"From version 107, this method must be called within user gesture event handlers, or the user must grant the <code>clipboard-write</code> permission.",
"Before version 107, the user must grant the <code>clipboard-write</code> permission."
]
},
"chrome_android": "mirror",
Expand All @@ -326,7 +326,7 @@
"notes": [
"This method must be called within user gesture event handlers.",
"Web extensions require the <code>clipboardRead</code> permission in manifest to read data. With this permission, the extension does not require a user interaction and does not display a paste prompt.",
"A paste prompt is displayed when the clipboard is read. If the clipboard contains same-origin content, the prompt is surpressed."
"A paste prompt is displayed when the clipboard is read. If the clipboard contains same-origin content, the prompt is suppressed."
]
},
"firefox_android": "mirror",
Expand Down

0 comments on commit 09fa945

Please sign in to comment.