剪贴板项目:types 属性

基线 2024

最新可用

2024 年 6 月起,此功能在最新设备和浏览器版本上均可使用。此功能可能无法在旧设备或浏览器上使用。

安全上下文:此功能仅在安全上下文(HTTPS)中可用,在一些或所有支持浏览器中可用。

ClipboardItem 接口的只读types 属性返回一个包含ClipboardItem 中可用的MIME 类型Array

可用的MIME 类型数组。

示例

在下面的示例中,我们将通过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);
  }
}

规范

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

浏览器兼容性

BCD 表格仅在浏览器中加载

另请参阅