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 vor der Verwendung auf produktiven Webseiten.

Die EyeDropper.open() Methode startet den Pipettenmodus und gibt ein Versprechen 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 AbortSignal-Methode abort() aufgerufen wird.

Rückgabewert

Ein Promise, das schließlich aufgelöst wird, wenn der Benutzer eine Pixel-Farbe vom Bildschirm auswählt.

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

sRGBHex

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

Ausnahmen

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

NotAllowedError DOMException

Wird ausgelöst, wenn open() nicht durch eine transiente Benutzeraktivierung aufgerufen wird.

InvalidStateError DOMException

Wird ausgelöst, wenn bereits eine andere Pipette geöffnet wurde.

AbortError DOMException

Wird ausgelöst, wenn der Benutzer die Auswahl durch Drücken der Esc-Taste abbricht oder wenn die Auswahl durch einen AbortController, der als Argument an open() übergeben wird, abgebrochen wird.

OperationError DOMException

Wird ausgelöst, wenn die Auswahl aus anderen Gründen fehlschlägt.

Spezifikationen

Specification
EyeDropper API
# dom-eyedropper-open

Browser-Kompatibilität

Siehe auch

  • Die EyeDropper Schnittstelle, zu der es gehört.