Clipboard.readText()

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

構文

var promise = navigator.clipboard.readText()

パラメーター

なし。

戻り値

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

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

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

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

仕様

仕様書 策定状況 コメント
Clipboard API and events
readText() の定義
草案 初回定義

ブラウザー実装状況

BCD tables only load in the browser

関連情報