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 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 | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
getType | 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.