Clipboard.writeText()
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 |
ブラウザーの互換性
BCD tables only load in the browser