在此页

• 方法
• Clipboard availability
• 规范
• 浏览器兼容性
• 另请参阅
• 相关话题

Clipboard interface implements the Clipboard API , providing—if the user grants permission—both read and write access to the contents of the system clipboard. The Clipboard API can be used to implement cut, copy, and paste features within a web application.

The system clipboard is exposed through the global Navigator.clipboard 特性。

Calls to the methods of the Clipboard object will not succeed if the user hasn't granted the needed permissions using the 权限 API 和 "clipboard-read" or "clipboard-write" permission as appropriate.

注意： In reality, at this time browser requirements for access to the clipboard vary significantly. Please see the section Clipboard availability 了解细节。

All of the Clipboard API methods operate asynchronously; they return a Promise which is resolved once the clipboard access has been completed. The promise is rejected if clipboard access is denied.

clipboard is a data buffer that is used for short-term, data storage and/or data transfers, this can be between documents or applications
It is usually implemented as an anonymous, temporary data buffer , sometimes called the paste buffer, that can be accessed from most or all programs within the environment via defined programming interfaces .

A typical application accesses clipboard functionality by mapping user input 譬如 keybindings , menu selections , etc. to these interfaces.

方法

Clipboard is based on the EventTarget interface, and includes its methods.

read()

Requests arbitrary data (such as images) from the clipboard, returning a Promise . When the data has been retrieved, the promise is resolved with a DataTransfer object that provides the data.

readText()

Requests text from the system clipboard; returns a Promise which is resolved with a DOMString containing the clipboard's text once it's available.

write()

Writes arbitrary data to the system clipboard. This asynchronous operation signals that it's finished by resolving the returned Promise .

writeText()

Writes text to the system clipboard, returning a Promise which is resolved once the text is fully copied into the clipboard.

Clipboard availability

The asynchronous clipboard API is a relatively recent addition, and the process of implementing it in browsers is not yet complete. Due to both potential security concerns and technical complexities, the process of integrating this API is happening gradually in most browsers.

For example, Firefox does not yet support the "clipboard-read" and "clipboard-write" permissions, so access to the methods that access and change the contents of the clipboard are restricted in other ways.

For WebExtensions, you can request the clipboardRead and clipboardWrite permissions to be able to use clipboard.readText() and clipboard.writeText(). Content scripts applied on HTTP sites do not have access to the clipboard object. See extensions in Firefox 63 .

此外， read() and write() are disabled by default and require changing a preference to enable them. Check the compatibility tables for each method before using it.

规范

规范	状态	注释
Clipboard API and events The definition of 'Clipboard' in that specification.	工作草案	初始定义。

浏览器兼容性

The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request. 更新 GitHub 上的兼容性数据

	桌面						移动
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	Android webview	Chrome for Android	Firefox for Android	Opera for Android	Safari on iOS	Samsung Internet
Clipboard	Chrome 66	Edge 79	Firefox 63	IE No	Opera 53	Safari 13.1	WebView Android 66	Chrome Android 66	Firefox Android 63	Opera Android 47	Safari iOS 13.4	Samsung Internet Android 9.0
read	Chrome 部分支持 76 部分支持 76 From version 76, the image/png MIME type is supported. 部分支持 66 Images are not supported.	Edge 79	Firefox 63 Disabled 63 Disabled Currently works just like readText() ; non-text content is not currently supported. Disabled ). To change preferences in Firefox, visit about:config.	IE No	Opera 63	Safari 13.1	WebView Android 部分支持 84 部分支持 84 From version 84, the image/png MIME type is supported. 部分支持 66 Images are not supported.	Chrome Android 部分支持 84 部分支持 84 From version 84, the image/png MIME type is supported. 部分支持 66 Images are not supported.	Firefox Android 63 Disabled 63 Disabled Currently works just like readText() ; non-text content is not currently supported. Disabled ). To change preferences in Firefox, visit about:config.	Opera Android 54	Safari iOS 13.4	Samsung Internet Android 12.0
readText	Chrome 66	Edge 79	Firefox 63 63 Firefox only supports reading the clipboard in browser extensions, using the "clipboardRead" extension permission.	IE No	Opera 53	Safari 13.1	WebView Android 66	Chrome Android 66	Firefox Android 63 63 Firefox only supports reading the clipboard in browser extensions, using the "clipboardRead" extension permission.	Opera Android 47	Safari iOS 13.4	Samsung Internet Android 9.0
write	Chrome 66 66 From version 76, the image/png MIME type is supported.	Edge 79	Firefox 63 Disabled 63 Disabled Currently works exactly like writeText() , including the availability limitations currently imposed by Firefox. Disabled ). To change preferences in Firefox, visit about:config.	IE No	Opera 63	Safari 13.1	WebView Android 66 66 From version 84, the image/png MIME type is supported.	Chrome Android 66 66 From version 84, the image/png MIME type is supported.	Firefox Android 63 Disabled 63 Disabled Currently works exactly like writeText() , including the availability limitations currently imposed by Firefox. Disabled ). To change preferences in Firefox, visit about:config.	Opera Android 54	Safari iOS 13.4	Samsung Internet Android 12.0
writeText	Chrome 66	Edge 79	Firefox 63 63 Writing to the clipboard is available without permission in secure contexts and browser extensions, but only from user-initiated event callbacks. Browser extensions with the "clipboardWrite" permission can write to the clipboard at any time.	IE No	Opera 53	Safari 13.1	WebView Android 66	Chrome Android 66	Firefox Android 63 63 Writing to the clipboard is available without permission in secure contexts and browser extensions, but only from user-initiated event callbacks. Browser extensions with the "clipboardWrite" permission can write to the clipboard at any time.	Opera Android 47	Safari iOS 13.4	Samsung Internet Android 9.0

图例

完整支持

完整支持

部分支持

部分支持

不支持

不支持

见实现注意事项。

用户必须明确启用此特征。

用户必须明确启用此特征。

另请参阅

• Document.execCommand()

元数据

• 最后修改： Apr 9, 2020

相关话题

1. Clipboard
2. 方法

   1. read()
   2. readText()
   3. write()
   4. writeText()
3. 继承：

   1. EventTarget
4. Related pages for Clipboard API

   1. ClipboardEvent
   2. ClipboardItem
   3. Navigator.clipboard