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 介面。