ClipboardItem: types property
Baseline 2024
Newly available
Since June 2024, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.
Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.
The read-only types
property of the ClipboardItem
interface returns an Array
of MIME types available within the ClipboardItem
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 |
---|
Clipboard API and events # dom-clipboarditem-types |
Browser compatibility
BCD tables only load in the browser