EyeDropper: open() メソッド

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Experimental: これは実験的な機能です。
本番で使用する前にブラウザー互換性一覧表をチェックしてください。

EyeDropper.open() メソッドは、スポイトモードを開始し、ユーザーが色を選択してスポイトモードを終了したときに履行されるプロミスを返します。

構文

js
open()
open(options)

引数

options 省略可

AbortSignal シグナルを渡す用のオプションオブジェクトです。

signal

AbortSignal です。AbortSignalabort() メソッドを呼ぶと、スポイトモードが終了します。

返値

ユーザーが画面から色を選択すると解決する Promise です。

この Promise は、以下のプロパティを持つオブジェクトで解決します。

sRGBHex

選択された色を 16 進 sRGB 形式 (#aabbcc) で表す文字列です。

例外

例外は投げられるのではなく、Promise が拒否されたとき返されます。この Promise は以下の 2 通りの場合に拒否されます。

  • ユーザーが Escape キーを押してスポイトモードをキャンセルしたとき。
  • スポイトモードが open() の引数として渡した AbortController によって終了させられたとき。

仕様書

Specification
EyeDropper API
# dom-eyedropper-open

ブラウザーの互換性

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
open
Experimental

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support
Experimental. Expect behavior to change in the future.

関連情報

  • 属している EyeDropper インターフェイス