Navigator: clipboard 属性

Baseline 已广泛支持

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

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

Navigator 接口的只读属性 clipboard 返回一个 Clipboard 对象，用于读取和写入剪贴板的内容。

这是 Clipboard API 的入口点，可用于在 Web 应用程序中实现剪切、复制和粘贴功能。

值

用于访问系统剪贴板的 Clipboard 对象。

以下代码使用 navigator.clipboard 访问系统剪贴板，以读取剪贴板中的文本内容。

navigator.clipboard
  .readText()
  .then(
    (clipText) => (document.querySelector(".clip-text").innerText = clipText),
  );

此代码片段会将类名为 "clip-text" 的元素的内容替换为剪贴板中的文本内容。也许这段代码正在被一个显示当前剪贴板内容的浏览器扩展程序使用，并自动定期更新或在特定事件触发时更新。

如果剪贴板为空或不包含文本，则会清除 "clip-text" 元素的内容。这是因为 readText() 在剪贴板为空或不包含文本时会返回一个空字符串。

规范
Clipboard API 和事件 # navigator-clipboard

此页面最后修改于 2024年10月16日，由 MDN 贡献者修改。