BarcodeDetector: метод detect()

Метод detect() интерфейса BarcodeDetector возвращает Promise, который выполняется с массивом Array обнаруженных штрихкодов в изображении.

imageBitmapSource

Принимает на вход источник изображения. Это может быть HTMLImageElement, SVGImageElement, HTMLVideoElement, HTMLCanvasElement, ImageBitmap, OffscreenCanvas, VideoFrame, Blob типа изображения или объект ImageData.

Возвращает Promise, который выполняется с массивом объектов DetectedBarcode, содержащих следующие свойства:

boundingBox

Объект DOMRectReadOnly, возвращающий размеры прямоугольника, представляющего собой границы обнаруженного штрихкода, выровненного с изображением.

cornerPoints

Координаты x и y четырёх угловых точек обнаруженного штрихкода относительно изображения, начиная с левого верхнего угла и двигаясь по часовой стрелке. Может не быть квадратным из-за искажений перспективы на изображении.

format

Обнаруженный формат штрихкода. (Полный список форматов см. в поддерживаемых форматах штрихкодов).

rawValue

Строка, декодированная из данных штрихкода.

TypeError

Бросается, если не указан параметр или тип type не соответствует ImageBitmapSource.

SecurityError DOMException

Бросается, если у imageBitmapSource есть origin, который не совпадает с origin документа, или если imageBitmapSource является элементом HTMLCanvasElement и флаг origin-clean установлен в значение false.

InvalidStateError DOMException

Бросается, если imageBitmapSource является элементом HTMLImageElement и не полностью декодирован или декодирование не удалось, или является элементом HTMLVideoElement и его свойство readyState равно HAVE_NOTHING или HAVE_METADATA.

В этом примере используется метод detect() для обнаружения штрихкодов на заданном изображении. Эти штрихкоды перебираются, и данные о штрихкодах регистрируются в консоли.

barcodeDetector
  .detect(imageEl)
  .then((barcodes) => {
    barcodes.forEach((barcode) => console.log(barcode.rawValue));
  })
  .catch((err) => {
    console.error(err);
  });