The Clipboard interface's writeText() property writes the specified text string to the system clipboard.
Note: The specification requires the Permissions API be used to obtain the "clipboardWrite" permission before writing to the clipboard. However, exact requirements vary from browser to browser, since this is a new API. Check the compatibility table and Clipboard availability in Clipboard for details.
Syntax
var promise = navigator.clipboard.writeText(newClipText)
Parameters
newClipText- The
DOMStringto be written to the clipboard. -
Return value
A Promise which is resolved once the clipboard's contents have been updated. The promise is rejected if the caller does not have permission to write to the clipboard.
Example
This example sets the clipboard's contents to the string "<empty clipboard>".
navigator.clipboard.writeText("<empty clipboard>").then(function() {
/* clipboard successfully set */
}, function() {
/* clipboard write failed */
});
Specifications
| Specification | Status | Comment |
|---|---|---|
| Clipboard API and events The definition of 'writeText()' in that specification. |
Working Draft | Initial definition. |
Browser compatibility
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.
Update compatibility data on GitHub
| Desktop | Mobile | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
writeText | Chrome Full support 66 | Edge No support No | Firefox
Full support
63
| IE No support No | Opera Full support 53 | Safari ? | WebView Android No support No | Chrome Android Full support 66 | Firefox Android
Full support
63
| Opera Android Full support 47 | Safari iOS ? | Samsung Internet Android Full support Yes |
Legend
- Full support
- Full support
- No support
- No support
- Compatibility unknown
- Compatibility unknown
- See implementation notes.
- See implementation notes.