此页面由社区从英文翻译而来。了解更多并加入 MDN Web Docs 社区。

Clipboard.writeText()

Clipboard 接口的 writeText() 方法可以写入特定字符串到操作系统的剪切板。

Note: 规范要求在写入剪贴板之前使用 Permissions API 获取“剪贴板写入”权限。但是，不同浏览器的具体要求不同，因为这是一个新的API。有关详细信息，请查看浏览器兼容性 and Clipboard availability in Clipboard。

语法

var promise = navigator.clipboard.writeText(newClipText)

参数

newClipText: The DOMString to be written to the clipboard.
返回值

一个Promise ，一旦剪贴板的内容被更新，它就会被解析。如果调用者没有写入剪贴板的权限，则拒绝写入剪切板（reject）

例子

此示例将剪贴板的内容设置为字符串“<empty clipboard>”。

navigator.clipboard.writeText("<empty clipboard>").then(function() {
  /* clipboard successfully set */
}, function() {
  /* clipboard write failed */
});

规范

Specification
Clipboard API and events # dom-clipboard-writetext

浏览器兼容性

BCD tables only load in the browser