Clipboard

Baseline 广泛可用 *

此功能已经成熟，并可在许多设备和浏览器版本上使用。自 ⁨2020 年 3 月⁩起，它已在各浏览器中推出。

* 此特性的某些部分可能存在不同级别的支持。

安全上下文： 此功能仅在安全上下文（HTTPS）中可用，且支持此功能的浏览器数量有限。

Clipboard 接口，属于 Clipboard API，提供对系统剪贴板内容的读写访问。这允许 Web 应用程序实现剪切、复制和粘贴功能。

系统剪贴板通过全局 Navigator.clipboard 属性暴露。

Clipboard API 的所有方法都以异步方式运行；它们返回一个 Promise，该 Promise 在剪贴板访问完成后被解析。如果剪贴板访问被拒绝，则 Promise 被拒绝。

所有方法都需要安全上下文。有关使用该 API 的其他要求，请参阅 API 概述主题的安全注意事项部分。

实例方法

Clipboard 基于 EventTarget 接口，并包含其方法。

read(): 从剪贴板请求任意数据（如图像），返回一个 Promise，该 Promise 会解析为一个包含剪贴板内容的 ClipboardItem 对象数组。
readText(): 从系统剪贴板请求文本，返回一个 Promise，当文本可用时，该 Promise 会以包含剪贴板文本的字符串来 fulfilled。
write(): 将任意数据写入系统剪贴板，返回一个 Promise，该 Promise 在操作完成后被解析。
writeText(): 将文本写入系统剪贴板，返回一个 Promise，该 Promise 在文本完全复制到剪贴板后被解析。

规范
Clipboard API 和事件 # clipboard-interface

此页面最后修改于 2024年1月9日，由 MDN 贡献者编辑。