Clipboard.readText()

Clipboard インターフェイスの readText() メソッドは、システムクリップボードのテキストの内容のコピーに解決されるプロミス (Promise) を返します。

クリップボードからデータを読み込むには、権限 API の "clipboard-read" 権限を得る必要があります。

構文

js

readText();

引数

なし。

返値

クリップボードのテキストの内容を持つ文字列に解決される、プロミス (Promise) オブジェクト。クリップボードが空であったり、テキストがないか、クリップボードの内容を表す DataTransfer オブジェクトがテキストの表現を持たない場合は、空文字列を返します。

テキストでない内容をクリップボードから読むためには、代わりに read() メソッドを使ってください。クリップボードへのテキストの書き込みには、writeText() を使ってください。

例

この使用例は、クリップボードからテキストの内容を取得し、ある要素の内容にその取得されたテキストを設定します。

js

navigator.clipboard
  .readText()
  .then((clipText) => (document.getElementById("outbox").innerText = clipText));

仕様書

Specification
Clipboard API and events
# dom-clipboard-readtext

ブラウザーの互換性

BCD tables only load in the browser

関連情報