ClipboardItem

ClipboardItem()

Creates a new ClipboardItem object, with the MIME type as the key and Blob as the value.

This interface provides the following properties.

types Read only

Returns an Array of MIME types available within the ClipboardItem.

presentationStyle Read only

Returns one of the following: "unspecified", "inline" or "attachment".

This interface defines the following methods.

ClipboardItem.supports()

Checks whether a given MIME type is supported by the clipboard. This enables a website to detect whether a MIME type is supported by the clipboard before attempting to write data.

This interface defines the following methods.

getType()

Returns a Promise that resolves with a Blob of the requested MIME type, or an error if the MIME type is not found.

Here we use supports() to check whether the image/svg+xml MIME data type is supported. If it is, we fetch the image with the "Fetch API", and then read it into a Blob, which we can use to create a ClipboardItem that is written to the clipboard.

async function writeClipImg() {
  try {
    if (ClipboardItem.supports("image/svg+xml")) {
      const imgURL = "/my-image.svg";
      const data = await fetch(imgURL);
      const blob = await data.blob();
      await navigator.clipboard.write([
        new ClipboardItem({
          [blob.type]: blob,
        }),
      ]);
      console.log("Fetched image copied.");
    } else {
      console.log("SVG images are not supported by the clipboard.");
    }
  } catch (err) {
    console.error(err.name, err.message);
  }
}

Here 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);
  }
}

• Clipboard API
• Image support for Async Clipboard article