ClipboardItem: getType() method

Secure context

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

getType(type)

Parameters

• type
  • : A valid MIME type.

Return value

A Promise that resolves with a Blob object.

Exceptions

• NotFoundError DOMException
  • : The type does not match a known MIME type.
• TypeError
  • : No parameter is specified or the type is not that of the ClipboardItem.

Examples

In the following example, we’re returning all items on the clipboard via the read() method. For each one, we pass the types property to the getType() method, which returns 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

Browser compatibility

See also

• Clipboard API
• Image support for Async Clipboard article