[WebAPI] ClipboardItem

[chrisdavidmills]

Acceptance criteria

1. • The listed features are documented sufficiently on MDN
2. • BCD is updated
3. • Interactive example and data repos are updated if appropriate
4. • The content has been reviewed as needed

Features to document

1. ClipboardItem

Related Gecko bugs

1. • Implement ClipboardItem

This is already documented for the most part, but the docs are not quite finished. The whole lot could do with checking. Also the BCD needs updating.

For folks helping with Firefox-related documentation features — make sure above AC have been done, but also:

• Set bugs to dev-doc-complete
• Add entry to Firefox release notes if feature is enabled in release
• Add entry to Firefox experimental features page if feature is not yet enabled in release

[Rumyra]

OK so... 😅 ClipboardItem...

The spec has changed since I last published the initial docs in June-ish time. There are a few extra properties and methods. These are:

• ClipboardItem.createDelayed()
• item.presentationStyle
• item.lastModified
• item.delayed
• Review what's there

EDIT: Due to BCD feedback I'm going to remove members which are not implemented by any browser at this time - rather than the placeholders... I can add them back in pretty easily later 👍

See: #2829

However these are not implemented in either FF or Chrome, apart from item.presentationStyle in FF. Now I'm happy to whip up a page for this, however none of the above have any explainer within the spec https://www.w3.org/TR/clipboard-apis/#clipboard-interface

Presentation style seems to represent whether an item is to be pasted as an attachment or inline. This is quite difficult to explain without an example, which is also quite difficult to create as there is no other functionality around pasting something as an attachment.

However BCD looks up to date so there is that :) I spoke too soon - There's a few inconsistencies in implementations which should go in, so I need to spend a bit of time on this

• BCD - see Clipboard Item updates browser-compat-data#9330
• Added note to experimental Adding clipboarditem to experimental notes #2857

[jpmedley]

I can't even find that any work is being done on these in Chrome. By the way, presence of an item in draft spec is no guarantee that it will survive in that form (or at all) into a production version of any browser. In fact the last proposed enhancement to this API made it (if I remember correctly) nearly to an origin trial before being killed on security grounds. This is why I never document anything until we're very close to having product in the can.

In spite of that, I went ahead and reviewed the draft. (Not really thinking things through today, but oh well.) In the review I poked one of the spec authors on a few items. This should start a dialog that will get us some clarity on where this is heading. (See if these features don't also get tied up in security issues.)

[Rumyra]

Last thing:

Removing members that haven't been implemented as they are not added to BCD. It's easy enough to add them back in when they are 👍 #2934

[jpmedley]

👍

[chrisdavidmills]

OK, this is all looking good, so I think we're done here!