EyeDropper: open() Methode

Limited availability

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

Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.

Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig, bevor Sie diese produktiv verwenden.

Die EyeDropper.open() Methode startet den Pipettenmodus und gibt ein Promise zurück, das erfüllt wird, sobald der Benutzer eine Farbe ausgewählt und den Pipettenmodus verlassen hat.

Syntax

js
open()
open(options)

Parameter

options Optional

Ein Optionsobjekt, um ein AbortSignal Signal zu übergeben:

signal Optional

Ein AbortSignal. Der Pipettenmodus wird abgebrochen, wenn die abort() Methode des AbortSignals aufgerufen wird.

Rückgabewert

Ein Promise, das letztendlich aufgelöst wird, wenn der Benutzer eine Pixelfarbe vom Bildschirm auswählt.

Das Promise wird zu einem Objekt mit der folgenden Eigenschaft aufgelöst:

sRGBHex

Ein String, der die ausgewählte Farbe im hexadezimalen sRGB-Format darstellt (#aabbcc).

Ausnahmen

Ausnahmen werden nicht geworfen, sondern zurückgegeben, wenn das Promise abgelehnt wird.

NotAllowedError DOMException

Wird geworfen, wenn open() nicht über eine vorübergehende Benutzeraktivierung aufgerufen wird.

InvalidStateError DOMException

Wird geworfen, wenn bereits ein anderer Farbwähler geöffnet ist.

AbortError DOMException

Wird geworfen, wenn der Benutzer die Auswahl durch Drücken der Esc-Taste abbricht oder wenn die Auswahl durch einen übergebenen AbortController zu open() abgebrochen wird.

OperationError DOMException

Wird geworfen, wenn die Auswahl aus anderen Gründen fehlschlägt.

Spezifikationen

Specification
EyeDropper API
# dom-eyedropper-open

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch