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

関連情報