Web/API/ClipboardItem/types

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 eventsThe definition of 'ClipboardItem' in that specification.	Working Draft	Initial definition.

Browser compatibility

Update compatibility data on GitHub

	Desktop						Mobile
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	Android webview	Chrome for Android	Firefox for Android	Opera for Android	Safari on iOS	Samsung Internet
`types` Experimental'	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.