Clipboard.writeText()
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since March 2020.
Clipboard インターフェイスの writeText()
メソッドは、指定されたテキスト文字列をシステムのクリップボードに書き込みます。テキストは read() または readText() を使って読み戻すことができます。
権限 API の "clipboard-write" 権限は、ページがアクティブなタブにあるときに自動的に付与されます。
構文
js
writeText(newClipText);
引数
newClipText-
クリップボードに書き込む文字列。
返値
クリップボードの内容が更新されると解決されるプロミス (Promise)。呼び出し元がクリップボードへの書き込み権限を持っていない場合、このプロミスは拒否されます。
例
この例では、クリップボードの内容を "<empty clipboard>" という文字列に設定します。
js
navigator.clipboard.writeText("<empty clipboard>").then(
() => {
/* clipboard successfully set */
},
() => {
/* clipboard write failed */
},
);
仕様書
| Specification |
|---|
| Clipboard API and events # dom-clipboard-writetext |