Clipboard.writeText()
Clipboard
インターフェイスの writeText()
メソッドは、指定されたテキスト文字列をシステムのクリップボードの書き込みます。テキストは read()
または readText()
を使って読み戻すことができます。
権限 API の "clipboard-write"
権限は、ページがアクティブなタブにあるときに自動的に付与されます。
構文
writeText(newClipText)
引数
newClipText
-
クリップボードに書き込む文字列。
返値
クリップボードの内容が更新されると解決されるプロミス (Promise
)。呼び出し元がクリップボードへの書き込み権限を持っていない場合、このプロミスは拒否されます。
例
この例では、クリップボードの内容を "<empty clipboard>" という文字列に設定します。
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