ClipboardItem: types 屬性

Baseline 2024
新推出

自 2024 年 6 月起,此功能已在最新的裝置和瀏覽器版本中可用。此功能可能不適用於較舊的裝置或瀏覽器。

安全上下文: 此功能僅在安全上下文(HTTPS)中可用,且支援此功能的瀏覽器數量有限。

ClipboardItem 介面的只讀屬性 types 返回一個 Array,其中包含 ClipboardItem 中可用的 MIME 型別

一個包含可用 MIME 型別Array

示例

在下面的示例中,我們使用 Clipboard.read() 方法返回剪貼簿上的所有專案,然後檢查 types 屬性以獲取可用型別,最後使用 ClipboardItem.getType() 方法將每個資料項作為 Blob 返回。如果未找到指定型別的剪貼簿內容,則返回錯誤。

js
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 和事件
# dom-clipboarditem-types

瀏覽器相容性

另見