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

関連情報