JS - 获取剪切板内容 Clipboard API

1，需求

一个问题咨询表单页，可以上传图片。因为有截图的场景，所以需要得先截图保存在本地再上传，比较繁琐。

想从剪切板获取截图后，直接上传。

最终效果

2，实现

从剪切板获取的内容分为文本和非文本，分别对应2个API，

• navigator.clipboard.readText()
• navigator.clipboard.read()，可以用它来获取图片。

获取的内容是 ClipboardItem 对象。

示例

完整代码：

<template><div ref="refPasteBox"></div><button @click="getClipImg">获取剪切板图片</button>
</template><script setup lang="ts">
import { ref } from "vue";const refPasteBox = ref<HTMLDivElement>();
const getClipImg = async () => {try {const clipboardContent = await navigator.clipboard.read();const clipboardItem = clipboardContent[0];let noImg = true;for (const type of clipboardItem.types) {if (type === "image/png") {noImg = false;const blob = await clipboardItem.getType(type);const url = URL.createObjectURL(blob);// 如果需要 File 对象const file = new File([blob], "clipboard-image.png", { type });console.log(file);const img = document.createElement("img");img.src = url;img.width = 300;img.onload = () => {URL.revokeObjectURL(img.src);};refPasteBox.value?.appendChild(img);}}if (noImg) {alert("当前剪切板中没有图片。\n Windows 系统可通过快捷键\n ⌘+V \n查看剪切板");}} catch (err: any) {if (err.name === "NotAllowedError") {console.log("用户拒绝了访问剪贴板");} else {console.error("无法读取剪贴板内容: ", err);}}
};
</script>

3，注意点

1，只支持安全上下文环境

安全上下文，可以简单理解为只支持 https 协议和本地 http://127.0.0.1、http://localhost。

在 http 环境下是 undefined，

2，只能读取当前页面的剪切板

有5个区域：

1. 页面内容显示区域
2. 地址栏
3. 书签栏
4. 控制台
5. 其他应用

在执行 await navigator.clipboard.read() 相关 API 时，必须聚焦到区域1，否则会有如下报错！

正常情况下通过按钮点击来执行 API 时，都是满足的。

如果想在控制台中简单测试，可以用计时器。在控制台执行后，迅速点击页面区域就可以正常执行。

setTimeout(async () => {const clipboardContent = await navigator.clipboard.read();console.log(clipboardContent);
}, 2000);

3，权限获取问题

当第一次请求剪切板【读权限】时，也就是执行 await navigator.clipboard.read() 时，会弹出确认弹窗：

允许后就可以正常使用了。如果禁止了，无法通过再次执行代码打开该弹窗！只能手动重置权限。

4，获取内容的 MIME_TYPE 问题

const getClipImg = async () => {try {const clipboardContent = await navigator.clipboard.read();const clipboardItem = clipboardContent[0];console.log(clipboardItem);for (const type of clipboardItem.types) {if (type === "image/png") {const blob = await clipboardItem.getType(type);}}} catch (err) {console.log(err)}
};

示例代码中，通过 for 循环获取了剪切板内容的 type，它有几个特点：

1，文本内容

无论是从什么地方手动复制的文本，type 都是2个：text/plain 和 text/html。

2，图片内容

1，如果是截图，type 统一为 image/png。

2，如果是从网页上复制的图片（无论原图片是什么格式），type 统一都是2个：text/html 和 image/png。

所以，只需要判断 MIME 类型为 image/png 即可获取对应的图片。

另外，从本地复制的文件（图片，excel等） 无法通过 await navigator.clipboard.read() API 获取。

5，只能获取剪切板内容的 blob 类型

// ...
for (const type of clipboardItem.types) {if (type === "image/png") {const blob = await clipboardItem.getType(type);}
}

通过 getType 可以获取剪切板的内容，结果为 blob 类型，

如果需要预览，需要转换为 url。

const url = URL.createObjectURL(blob);

如果需要 File 对象（比如上传），需要手动转换。

const file = new File([blob], "clipboard-image.png", { type });

6，URL.revokeObjectURL 的时机

if (type === "image/png") {const blob = await clipboardItem.getType(type);const url = URL.createObjectURL(blob);const img = document.createElement("img");img.src = url;img.width = 300;img.onload = () => {URL.revokeObjectURL(img.src);};document.body.appendChild(img);
}

当通过 URL.createObjectURL() 创建可用于预览的对象 url 后，不能通过 URL.revokeObjectURL 立即释放该对象，否则图片无法显示。需要等到图片加载完成才行，或者不释放问题也不大。

4，其他

剪切板 API 获取的内容，和 paste 事件得到的内容是有区别的。

paste 事件一般用于富文本编辑，粘贴各种类型的文件。

• 剪切板不能获取本地复制的文件，paste 事件可以。
• MIME 类型问题，从网页复制的是 type/html，但却可以获取 File 对象。为了兼容，应该用 event.clipboardData?.files[0] 并加判断，而不是 items[0].getAsFile()， getAsFile-参考。
• 获取的 DataTransfer 对象，虽然 MDN 上的解释是拖动获取的内容，但其实也是粘贴事件获取的内容。

paste 事件简单举例

注意，ClipboardEvent 对象中部分内容通过 console.log 是看不到输出的，类似打印 currentTarget 得到的是 null，但是可以使用的。

<template><div ref="refClipBox" class="clip-box" @paste="getPasteImage" contenteditable="true"></div>
</template><script setup lang="ts">
import { ref } from "vue";const refClipBox = ref<HTMLDivElement>();
function getPasteImage(event: ClipboardEvent) {event.preventDefault();console.log(event);// 检查剪贴板项目const items = event.clipboardData?.items || [];if (items[0].type.indexOf("image") === 0 || items[0].type === "text/html") {// const blob = items[0].getAsFile();const blob = event.clipboardData?.files[0];const url = URL.createObjectURL(blob);const img = document.createElement("img");img.src = url;img.width = 300;img.onload = () => {URL.revokeObjectURL(img.src);};refClipBox.value?.appendChild(img);} else {console.log("不是图片");}
}
</script>
<style>
.clip-box {width: 300px;height: 300px;border: 1px solid #000;
}
</style>

---

以上。

参考