Draft This page is not complete.
The getType()
method of the ClipboardItem
interface returns a Promise
that resolves with a Blob
of the requested MIME type or an error if the MIME type is not found.
Syntax
var blob = clipboardItem.getType(type);
Parameters
type
- A valid MIME type.
Return value
A Promise
that resolves with a Blob
object.
Exceptions
DOMException
- The
type
does not match a known MIME type. TypeError
- No parameter is specified or the
type
is not that of theClipboardItem
.
Examples
In the following example, we're returning all items on the clipboard via the clipboard.read()
method. Then utilizing the ClipboardItem.types
property to set the getType()
argument and return the corresponding blob object.
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 eventsThe 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.
Update compatibility data on GitHub
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
|
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 9.0 |
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.
See also
ClipboardItem.getType() by Mozilla Contributors is licensed under CC-BY-SA 2.5.