EyeDropper: open() method
The EyeDropper.open()
method starts the eyedropper mode, returning a promise which is fulfilled once the user has selected a color and exited the eyedropper mode.
Syntax
Parameters
options
Optional
-
An options object to pass an AbortSignal
signal:
-
signal
-
An AbortSignal
. The eyedropper mode will be aborted when the AbortSignal
's abort()
method is called.
Return value
A Promise
that eventually resolves when the user selects a pixel color from the screen.
The promise resolves to an object with the following property:
-
sRGBHex
-
A string representing the selected color, in hexadecimal sRGB format (#aabbcc
).
Exceptions
Exceptions are not thrown but returned when the Promise
is rejected. The promise is rejected in two cases:
- When the user dismisses the eyedropper mode by pressing the Escape key.
- When the eyedropper mode is aborted by the
AbortController
passed as an argument to open()
.
Specifications
Browser compatibility
|
Desktop |
Mobile |
|
Chrome |
Edge |
Firefox |
Internet Explorer |
Opera |
Safari |
WebView Android |
Chrome Android |
Firefox for Android |
Opera Android |
Safari on IOS |
Samsung Internet |
open |
95 |
95 |
No |
No |
81 |
No |
No |
No |
No |
No |
No |
No |
See also