Clipboard

Baseline Widely available *

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨2020年3月⁩.

* Some parts of this feature may have varying levels of support.

安全上下文: 此特性仅在一些支持的浏览器的安全上下文（HTTPS）中可用。

Clipboard API 的 Clipboard 接口提供系统剪贴板读写访问的权限。这让 Web 应用程序可以实现剪切、复制和粘贴功能。

系统剪贴板暴露于全局属性 Navigator.clipboard 之中。

所有 Clipboard API 方法都是异步的；它们返回一个 Promise 对象，在剪贴板访问完成后被兑现。如果剪贴板访问被拒绝，promise 也会被拒绝。

所有的方法也都需要安全上下文。使用 API 的其他要求在 API 概述主题的安全考虑部分进行了讨论。

方法

Clipboard 继承自 EventTarget 接口，因此拥有它的方法。

read(): 从剪贴板读取数据（比如图片），返回一个 Promise。在检索到数据后，其将兑现为包含剪贴板数据的 ClipboardItem 对象数组。
readText(): 从操作系统剪切板读取文本，返回一个 Promise，一旦数据可用，其将兑现为包含剪切板文本的字符串。
write(): 写入任意数据至操作系统剪贴板，返回一个在操作完成时被兑现的 Promise。
writeText(): 写入文本至操作系统剪贴板。返回一个在文本已被完全写入剪贴板后兑现的 Promise。

Specification
Clipboard API and events # clipboard-interface

This page was last modified on ⁨2025年6月3日⁩ by MDN contributors.