ClipboardItem: supports() статический метод

Статический метод supports() интерфейса ClipboardItem возвращает true, если заданный тип MIME поддерживается буфером обмена, и false в противном случае.

Обратите внимание, что API буфера обмена требует поддержки обычного текста, HTML и файлов PNG. Метод supports() всегда вернёт true для этих типов MIME, поэтому проверять их нет необходимости.

type

Строка, обозначающая тип MIME для проверки.

Эти типы MIME всегда поддерживаются:

• text/plain
• text/html
• image/png

Эти типы MIME могут поддерживаться:

• image/svg+xml
• Форматы пользовательских типов MIME, начинающиеся с "web ". Пользовательский тип (без префикса "web " ), должен иметь правильный формат для типа MIME.

true если заданный тип MIME поддерживается буфером обмена, false в противном случае.

В следующем примере извлекается изображение SVG, представляется как Blob, а затем записывается в буфер обмена.

Мы используем supports() для проверки, поддерживает ли буфер обмена тип MIME "image/svg+xml" перед извлечением изображения и записью его с помощью clipboard.write(). Мы также оборачиваем все тело функции в оператор try...catch для перехвата других ошибок, например, если сам ClipboardItem не поддерживается.

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 to clipboard.");
    } else {
      console.log("SVG image not supported by clipboard");
    }
  } catch (err) {
    console.error(err.name, err.message);
  }
}

• Clipboard API
• Статья об поддержке изображений для Async Clipboard