Clipboard.readText()
構文
var promise = navigator.clipboard.readText()
パラメーター
なし。
戻り値
クリップボードのテキストの内容を持つ DOMString
に解決される、Promise
オブジェクト。クリップボードが空であったり、テキストがないか、クリップボードの内容を表す DataTransfer
オブジェクトがテキストの表現を持たない場合は、空文字列を返します。
テキストでない内容をクリップボードから読むためには、代わりに read()
メソッドを使ってください。クリップボードへのテキストの書き込みには、writeText()
を使ってください。
例
この使用例は、クリップボードからテキストの内容を取得し、ある要素の内容にその取得されたテキストを設定します。
navigator.clipboard.readText().then(
clipText => document.getElementById("outbox").innerText = clipText);
仕様
仕様書 | 策定状況 | コメント |
---|---|---|
Clipboard API and events readText() の定義 |
草案 | 初回定義 |
ブラウザー実装状況
BCD tables only load in the browser