剪贴板项：getType() 方法

基线 2024

新可用

自 2024 年 6 月起，此功能在最新的设备和浏览器版本中有效。此功能可能在旧设备或浏览器中无效。

安全上下文：此功能仅在 安全上下文 (HTTPS) 中，在某些或所有 支持的浏览器 中可用。

ClipboardItem 接口的 getType() 方法返回一个 Promise，该方法解析为请求的 MIME 类型 的 Blob，如果未找到 MIME 类型，则会返回错误。

语法

js
getType(type)

参数

type

有效的 MIME 类型。

返回值

一个解析为 Blob 对象的 Promise。

异常

NotFoundError DOMException

type 与已知的 MIME 类型 不匹配。

TypeError

未指定参数或 type 不是 ClipboardItem 的类型。

示例

在以下示例中，我们通过 clipboard.read() 方法返回剪贴板上的所有项目。然后利用 ClipboardItem.types 属性设置 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);
  }
}

规范

规范
剪贴板 API 和事件
# dom-clipboarditem-gettype

浏览器兼容性

BCD 表格仅在启用了 JavaScript 的浏览器中加载。

另请参阅