BarcodeDetector: detect()-Methode
Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.
Hinweis: Dieses Feature ist verfügbar in Web Workers.
Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig, bevor Sie diese produktiv verwenden.
Die detect()
-Methode der BarcodeDetector
-Schnittstelle gibt ein Promise
zurück, das mit einem Array
von erkannten Barcodes in einem Bild erfüllt wird.
Syntax
detect(imageBitmapSource)
Parameter
imageBitmapSource
-
Empfängt eine Bildquelle als Parameter. Dies kann ein
HTMLImageElement
, einSVGImageElement
, einHTMLVideoElement
, einHTMLCanvasElement
, einImageBitmap
, einOffscreenCanvas
, einVideoFrame
, einBlob
vom Typ Bild oder einImageData
-Objekt sein.
Rückgabewert
Gibt ein Promise
zurück, das mit einem Array von DetectedBarcode
-Objekten mit folgenden Eigenschaften erfüllt wird:
boundingBox
-
Ein
DOMRectReadOnly
, das die Abmessungen eines Rechtecks zurückgibt, das den Umfang eines erkannten Barcodes darstellt, ausgerichtet mit dem Bild. cornerPoints
-
Die x- und y-Koordinaten der vier Eckpunkte des erkannten Barcodes relativ zum Bild, beginnend mit der oberen linken Ecke und im Uhrzeigersinn. Aufgrund von perspektivischen Verzerrungen im Bild muss dies möglicherweise nicht quadratisch sein.
format
-
Das erkannte Barcode-Format. (Für eine vollständige Liste der Formate siehe die unterstützten Barcode-Formate).
rawValue
-
Ein Zeichenfolge, die aus den Barcodedaten dekodiert wurde.
Ausnahmen
TypeError
-
Wird ausgelöst, wenn kein Parameter angegeben wird oder der
type
nicht dem einesImageBitmapSource
entspricht. SecurityError
DOMException
-
Wird ausgelöst, wenn die
imageBitmapSource
einen Ursprung hat, der nicht mit dem Ursprung des Dokuments übereinstimmt, oder wenn dieimageBitmapSource
einHTMLCanvasElement
ist und das Origin-Clean-Flag auffalse
gesetzt ist. InvalidStateError
DOMException
-
Wird ausgelöst, wenn die
imageBitmapSource
einHTMLImageElement
ist und nicht vollständig decodiert ist oder das Decodieren fehlgeschlagen ist, oder wenn sie einHTMLVideoElement
ist und derreadyState
HAVE_NOTHING
oderHAVE_METADATA
ist.
Beispiele
Dieses Beispiel verwendet die detect()
-Methode, um die Barcodes im angegebenen Bild zu erkennen. Diese werden iteriert und die Barcodedaten werden in der Konsole protokolliert.
barcodeDetector
.detect(imageEl)
.then((barcodes) => {
barcodes.forEach((barcode) => console.log(barcode.rawValue));
})
.catch((err) => {
console.error(err);
});
Spezifikationen
Specification |
---|
Accelerated Shape Detection in Images # dom-barcodedetector-detect |
Browser-Kompatibilität
BCD tables only load in the browser