BarcodeDetector
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.
Hinweis: Diese Funktion ist in Web Workers verfügbar.
Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig vor der Verwendung auf produktiven Webseiten.
Das BarcodeDetector
-Interface der Barcode Detection API ermöglicht die Erkennung von linearen und zweidimensionalen Barcodes in Bildern.
Konstruktoren
BarcodeDetector.BarcodeDetector()
Experimentell-
Erstellt und gibt ein
BarcodeDetector
-Objekt zurück, mit optionalenBarcodeDetectorOptions
.
Statische Methoden
getSupportedFormats()
Experimentell-
Gibt ein
Promise
zurück, das mit einemArray
der unterstützten Barcode-Formattypen erfüllt wird.
Instanzmethoden
detect()
Experimentell-
Gibt ein
Promise
zurück, das mit einem Array vonDetectedBarcode
-Objekten mit den folgenden Eigenschaften erfüllt wird:boundingBox
: EinDOMRectReadOnly
, das die Abmessungen eines Rechtecks zurückgibt, das das Ausmaß 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 perspektivischer Verzerrungen im Bild kann es sich hierbei nicht um ein Quadrat handeln.format
: Das erkannte Barcode-Format. (Für eine vollständige Liste der Formate konsultieren Sie die unterstützten Barcode-Formate).rawValue
: Ein aus den Barcode-Daten dekodierter String.
Beispiele
Erstellen eines Detektors
Dieses Beispiel erstellt ein neues Barcode-Detektor-Objekt mit den angegebenen unterstützten Formaten und testet die Browser-Kompatibilität.
// check compatibility
if (!("BarcodeDetector" in globalThis)) {
console.log("Barcode Detector is not supported by this browser.");
} else {
console.log("Barcode Detector supported!");
// create new detector
const barcodeDetector = new BarcodeDetector({
formats: ["code_39", "codabar", "ean_13"],
});
}
Unterstützte Formate abrufen
Das folgende Beispiel ruft die statische Methode getSupportFormat()
auf und gibt die Ergebnisse in der Konsole aus.
// check supported types
BarcodeDetector.getSupportedFormats().then((supportedFormats) => {
supportedFormats.forEach((format) => console.log(format));
});
Barcodes erkennen
Dieses Beispiel verwendet die Methode detect()
, um die Barcodes innerhalb des gegebenen Bildes zu erkennen. Diese werden durchlaufen und die Barcode-Daten in der Konsole ausgegeben.
barcodeDetector
.detect(imageEl)
.then((barcodes) => {
barcodes.forEach((barcode) => console.log(barcode.rawValue));
})
.catch((err) => {
console.log(err);
});
Spezifikationen
Specification |
---|
Accelerated Shape Detection in Images # barcode-detection-api |