Draft
This page is not complete.
The read-only types
property of the ClipboardItem
interface returns an Array
of MIME types available within the ClipboardItem
Syntax
var types = clipboardItem.types;
Value
An Array
of available MIME types.
Examples
In the below example, we're returning all items on the clipboard via the clipboard.read()
method. Then checking the types
property for available types before utilizing the ClipboardItem.getType()
method to return the Blob
object. If no clipboards contents is found for the specified type, an error is returned.
async function getClipboardContents() { try { const clipboardItems = await navigator.clipboard.read(); for (const clipboardItem of clipboardItems) { for (const type of clipboardItem.types) { const blob = await clipboardItem.getType(type); // we can now use blob here } } } catch (err) { console.error(err.name, err.message); } }
Specifications
Specification | Status | Comment |
---|---|---|
Clipboard API and events The definition of 'ClipboardItem' in that specification. |
Working Draft | Initial definition. |
Browser compatibility
The compatibility table in this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
types | Chrome Full support 66 | Edge Full support ≤79 | Firefox No support No | IE No support No | Opera Full support Yes | Safari No support No | WebView Android Full support 66 | Chrome Android Full support 66 | Firefox Android No support No | Opera Android Full support Yes | Safari iOS No support No | Samsung Internet Android Full support Yes |
Legend
- Full support
- Full support
- No support
- No support
- Experimental. Expect behavior to change in the future.
- Experimental. Expect behavior to change in the future.