EyeDropper: open() 方法

语法

open()
open(options)

参数

options 可选

一个用于传递 AbortSignal 信号的 options 对象

signal 可选

一个 AbortSignal。当调用 AbortSignal 的 abort() 方法时，取色器模式将被中止。

返回值

一个 Promise，当用户从屏幕上选择一个像素颜色后，该 Promise 最终会 resolve。

该 Promise resolve 为一个具有以下属性的对象

sRGBHex

一个字符串，表示所选颜色的十六进制 sRGB 格式（#aabbcc）。

异常

异常不会被抛出，而是当 Promise 被 reject 时返回。

NotAllowedError DOMException

如果 open() 不是通过 用户瞬时激活 调用，则会抛出此异常。

InvalidStateError DOMException

如果另一个取色器已经打开，则会抛出此异常。

AbortError DOMException

如果用户通过按 Esc 键中止选择，或者作为参数传递给 open() 的 AbortController 中止了选择，则会抛出此异常。

OperationError DOMException

如果由于其他原因导致选择失败，则会抛出此异常。

规范

浏览器兼容性

另见

• 它所属的 EyeDropper 接口。