Перейти до вмісту

Barcode Scanner Emulator

Як тестувати сканери штрихкодів у вебзастосунках

Багато сканерів штрихкодів USB і Bluetooth надсилають декодовані дані як введення з клавіатури, тож поле з фокусом у вебзастосунку може прийняти сканування без окремого API браузера для сканера. Послідовні порти та SDK виробника — окремі інтеграції. Клавіатурний шлях можна перевірити фізичним сканером або імітацією натискань.

Вебзастосунок зазвичай бачить сканер штрихкодів як клавіатуру. Перевірка полягає в тому, чи отримує елемент із фокусом те корисне навантаження, якого чекає застосунок, і чи обробляє сторінка завершальну клавішу, яку сканер налаштовано надсилати. Це може бути Enter, Tab або нічого.

Користуйтеся сеансом тестера введення штрихкодів, коли фізичний сканер підключено. Користуйтеся Barcode Scanner Emulator, коли той самий клавіатурний шлях потрібен під час розробки, а пристрою немає на столі. Ширший прохід щодо фокусу, розкладки та сценаріїв POS є в посібнику Як тестувати введення зі сканера штрихкодів. Цей посібник лишається на браузерному застосунку: захоплення, суфікси, перевірка та події, які справді можна спостерігати.

Як сканери штрихкодів спілкуються з вебзастосунками

Режим інтерфейсу вирішує, що сторінка може отримати. Підтвердьте його, перш ніж змінювати код форми. Сканер часто перемикає режими скануванням штрихкоду налаштування з посібника виробника.

Клавіатурний клин USB HID

У режимі клавіатури USB HID сканер визначається як клавіатура. Операційна система завантажує звичайний драйвер клавіатури. Після декодування символу сканер надсилає символи як натискання в той елемент, який має фокус клавіатури. Сторінка слухає ці натискання або читає текст, який вони вставляють. З’єднання з пристроєм вона не відкриває.

Саме тому поле каси, рядок пошуку чи будь-яке інше текстове поле може прийняти сканування звичайним HTML. Посібник Клавіатурний клин HID докладніше описує послідовність натискань, префікси та суфікси.

Bluetooth HID

Сканер Bluetooth, спарований як клавіатура, іде тим самим шляхом у застосунку. Хост вважає його клавіатурою HID, і поле з фокусом отримує натискання. Спарювання, батарея та радіо — справи пристрою. Коли символи доходять до браузера, сторінка обробляє їх так само, як введення клина USB.

Послідовний порт і віртуальний COM

Послідовний сканер, зокрема багато режимів віртуального COM-порту USB, надсилає декодований текст байтами в порт. Фокус не обирає адресата. Його обирає процес, який відкрив порт. Текстове поле, яке лише слухає натискання, цього потоку не побачить.

Браузери на основі Chromium можуть відкрити послідовний порт через Web Serial API після того, як користувач вибере порт і надасть дозвіл. Firefox і Safari цього API не надають. Перевірка клина не перевіряє послідовну інтеграцію, а послідовна перевірка не каже, що надрукує сканер-клин.

Інтерфейси конкретного виробника

Деякі пристрої використовують SDK виробника, OPOS, JPOS або неклавіатурний інтерфейс HID, наприклад USB HID POS. Такі інтерфейси не друкують у поле з фокусом. Звичайна вебсторінка не може завантажити нативний SDK. Chromium може запитати деякі неклавіатурні пристрої HID через WebHID після жесту користувача. Пристрої HID класу клавіатури лишаються заблокованими, тож сканер-клин і далі невідрізненний від клавіатури. Вважайте інтерфейс виробника окремою інтеграцією і перевіряйте його тим програмним забезпеченням, яке цей інтерфейс справді відкриває.

Що бачить браузер

Сканування клином надходить як події keydown і keyup, а друковані символи оновлюють поле з фокусом. Браузер не отримує назву пристрою, серійний номер USB чи ознаку «сканер». Браузери з WebHID усе одно відмовляють клавіатурним інтерфейсам, тож сценарій сторінки не може прочитати і сирі звіти HID сканера-клина.

event.key — це символ або назва клавіші після того, як операційна система застосувала активну розкладку. event.code називає фізичну клавішу, наприклад Digit1 або Numpad1, і може лишитися тим самим, коли розбіжність розкладок змінює event.key. Жодна з властивостей не впізнає обладнання.

Як перевірити фізичний сканер штрихкодів у браузері

Зробіть це до налагодження коду застосунку. Так видно точний рядок і завершальну клавішу, які отримав браузер.

  1. Підключіть сканер і зачекайте, доки він покаже, що має живлення. Для Bluetooth завершіть спарювання і переконайтеся, що хост використовує профіль клавіатури.
  2. Підтвердьте режим введення. Клавіатурний клин, клавіатура USB HID або клавіатура Bluetooth HID можуть друкувати в поле. Режими Serial, SPP і SDK виробника не можуть.
  3. Відкрийте сторінку тестера введення штрихкодів.
  4. Клацніть Почати тест або клацніть область сканування. Вона стає синьою, коли готова. Сторінка сама фокус не забирає.
  5. Відскануйте штрихкод, корисне навантаження якого ви вже знаєте. Почніть із короткого числового значення, потім відскануйте значення зі знаками пунктуації, які зберігає застосунок.
  6. Прочитайте захоплене значення і кількість символів. Порівняйте обидва з очікуваним корисним навантаженням, включно з будь-яким префіксом, який сканер вставляє перед даними.
  7. Перевірте суфікс. Тестер повідомляє ENTER, TAB або Немає. Коли Автозахоплення увімкнено, результат з’являється після Enter, Tab або короткої паузи, щойно клавіші припинилися. Вимкніть Автозахоплення, якщо захоплення треба утримувати, доки ви не натиснете Зупинити.
  8. Порівняйте цей результат із рядком, який застосунок має зберегти. Префікс, підмінений символ або відсутню завершальну клавішу слід виправити в налаштуванні сканера або свідомо обробити на сторінці. Не вважайте це помилкою декодування, доки це порівняння не зроблено.

Тестер записує події клавіатури, які бачить браузер. Він не може визначити пристрій USB і не читає послідовний порт. Коли текстовий редактор отримує сканування, а браузер ні, продовжуйте з посібником Сканер працює в Notepad, але не в POS.

Захоплення введення сканера штрихкодів за допомогою JavaScript

Сканер друкує в елемент, який має фокус. Дайте полю видимий підпис, лишіть його звичайним текстовим полем, щоб із клавіатури можна було набрати код, і читайте значення, коли сценарій вважає введення завершеним. Сторінка нижче робить саме це. Enter надсилає форму один раз. Tab завершує непорожнє значення, а потім дозволяє браузеру перенести фокус. Сканування без завершальної клавіші лишається в полі, доки хтось не натисне кнопку Look up.

<!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <meta name="viewport" content="width=device-width, initial-scale=1">
  <title>Barcode input example</title>
</head>
<body>
  <form id="barcode-form">
    <label for="barcode">Barcode</label>
    <input id="barcode" name="barcode" type="text" autocomplete="off" spellcheck="false">
    <button type="submit">Look up</button>
  </form>
  <p id="message" role="status"></p>
  <ul id="accepted"></ul>
  <script>
    const form = document.querySelector('#barcode-form')
    const field = document.querySelector('#barcode')
    const message = document.querySelector('#message')
    const list = document.querySelector('#accepted')

    if (
      !(form instanceof HTMLFormElement) ||
      !(field instanceof HTMLInputElement) ||
      !(message instanceof HTMLElement) ||
      !(list instanceof HTMLUListElement)
    ) {
      throw new Error('Barcode form markup is missing.')
    }

    function payload(raw) {
      return raw.replace(/[\r\n]/g, '').trim()
    }

    function classify(raw) {
      const value = payload(raw)
      if (!value) {
        return { status: 'empty' }
      }
      if (/[\u0000-\u001F\u007F]/.test(value)) {
        return {
          status: 'invalid',
          message: 'Control character in the barcode. Check the prefix, suffix, and symbology identifier.',
        }
      }
      return { status: 'ok', value }
    }

    function accept(value) {
      const item = document.createElement('li')
      item.textContent = value
      list.append(item)
      message.textContent = 'Accepted ' + value
      field.value = ''
    }

    function reject(text) {
      message.textContent = text
    }

    form.addEventListener('submit', (event) => {
      event.preventDefault()
      const outcome = classify(field.value)
      if (outcome.status === 'empty') {
        reject('No barcode received.')
        field.focus()
        return
      }
      if (outcome.status === 'invalid') {
        reject(outcome.message)
        field.focus()
        return
      }
      accept(outcome.value)
      field.focus()
    })

    field.addEventListener('keydown', (event) => {
      if (event.key !== 'Tab' || event.shiftKey) {
        return
      }
      const outcome = classify(field.value)
      if (outcome.status === 'empty') {
        return
      }
      if (outcome.status === 'invalid') {
        event.preventDefault()
        reject(outcome.message)
        return
      }
      accept(outcome.value)
    })

    field.focus()
  </script>
</body>
</html>

Збережіть цей файл і відкрийте його в настільному браузері. Клацніть поле, якщо фокус змістився. Сканер-клин або емулятор із наступного розділу потім друкує в #barcode.

Фокус обов’язковий. Якщо document.activeElement — це тіло документа, кнопка або інше поле, слухачі цього поля сканування не бачать. Символи потрапляють в елемент із фокусом або губляться. Викликайте field.focus(), коли сценарій готовий до сканування, зокрема після закриття діалогу.

Порожнє введення ігнорується. Форма лишається на місці, а текст стану каже, що нічого не отримано. Самі пробіли порожні після trim().

Приклад не додає Enter або Tab. Якщо сканер не налаштовано їх надсилати, значення лишається в полі, і кнопка Look up — шлях завершення. autocomplete="off" зменшує шанс, що збережене значення замінить сканування. Підпис, кнопка і Shift+Tab лишаються доступними, тож людина може ввести код без сканера.

Обробляйте Enter в одному місці. Цей приклад використовує подію submit форми, яка також покриває кнопку Look up і Enter із клавіатури. Другий слухач keydown для Enter записав би те саме сканування двічі. Якщо поле не всередині форми, слухайте Enter на keydown і викличте preventDefault(), щоб батьківська форма теж не надіслалася:

field.addEventListener('keydown', (event) => {
  if (event.key !== 'Enter') {
    return
  }

  event.preventDefault()
  const value = field.value.trim()
  if (!value) {
    return
  }

  console.log(value)
  field.value = ''
})

Очищайте поле після успішного прийняття, щоб наступне сканування не дописувалося до попереднього корисного навантаження. Після Enter приклад знову фокусує те саме поле, бо цей сценарій чекає ще одне сканування в тому самому полі. Після Tab він не чіпає фокус, щоб браузер міг перейти до наступного елемента.

Обробка суфіксів ENTER і TAB

Суфікс — це клавіша, яку сканер може надіслати після корисного навантаження. Це параметр пристрою. Enter поширений, і він необов’язковий. Посібник Суфікси ENTER і TAB у сканерах штрихкодів описує, як відрізнити завершальні клавіші. Підтвердьте параметр на тому сканері, який перевіряєте, а потім підлаштуйте сторінку під цей сценарій.

ENTER

Enter в однорядковому текстовому полі надсилає навколишню форму в поточних браузерах. Використовуйте це, коли одне сканування має зафіксувати значення, як у полі пошуку. preventDefault() на події submit не дає браузеру піти зі сторінки. Пропустіть його, якщо перехід на іншу сторінку — це бажана поведінка.

Якщо штрихкод з’явився, а форма нічого не робить, сканер може не надсилати суфікс. Посібник У сканера штрихкодів немає ENTER розбирає це налаштування. Деякі пристрої надсилають NumPad Enter. event.key усе одно дорівнює "Enter". Перевіряйте event.key, а не лише event.code === "Enter", інакше такий сканер видаватиметься зламаним.

TAB

Tab переносить фокус на наступний елемент, який може його прийняти. Це пасує послідовності на кшталт коду товару, а потім кількості. Це несподівано для форми, яка чекала, що Enter її надішле.

Читайте значення в keydown, доки поле ще має фокус. Браузер переносить фокус після цієї події. Залиште дію за замовчуванням, коли наступний елемент має отримати фокус. preventDefault() утримує фокус на місці: це корисно, коли значення недійсне і оператор має його побачити. Ігноруйте Shift+Tab, щоб із клавіатури можна було йти формою назад. Суфікс Tab сканера — це Tab без Shift.

Суфікс Tab також може перенести фокус раніше, ніж код прочитає поле, якщо слухач висить на blur або change, а щось інше очищає елемент. Читайте значення з target події keydown.

Без суфікса

Без суфікса корисне навантаження лишається в полі. Застосунок сам вирішує, коли сканування закінчене. Явна кнопка, пізніший Enter від оператора або перехід до іншого кроку — надійні точки завершення. Таймер бездіяльності може прийняти паузу в наборі за кінець сканування. Цей таймер — евристика. Повільний сканер, затримка Bluetooth або людина, яка друкує швидко, можуть опинитися по інший бік порога. Надавайте перевагу налаштованому суфіксу, коли сценарію потрібен жорсткий сигнал кінця сканування.

Відмінності налаштування

Сканери однієї марки можуть постачатися з різними суфіксами, а штрихкод налаштування може змінити суфікс без жодних змін у JavaScript. Деякі пристрої надсилають префікс, ідентифікатор символіки на кшталт ]C1 або CR і LF. Перевірте три завершальні параметри, які користувачі реально можуть обрати: Enter, Tab і відсутність суфікса. Запишіть, який із них використовують розгорнуті сканери, і перевіряйте сторінку проти цього параметра.

Перевірка введення сканера штрихкодів

Перевіряйте рядок, який отримало поле. Не вважайте, що кожен штрихкод має одну довжину, один набір символів і одну контрольну суму. Корисні навантаження Code 128 і QR різняться. EAN-13 — це 13 цифр. Застосунку, який зберігає обидва, потрібні правила для обох.

Порожнє введення. Відхиліть або проігноруйте його. Суфікс без корисного навантаження або клацання Look up на порожньому полі не має створювати запис.

Неочікувані символи. Порівняйте отриманий рядок із відомою етикеткою. Розбіжність розкладок часто виглядає як змінений знак, наприклад зсунута цифра або знак пунктуації, за тієї самої довжини. Керувальні символи можуть прийти з префікса або з роздільника груп GS1. Дозволяйте символи, які задає ваш формат. Приклад вище відхиляє керувальні символи ASCII, щоб вони лишалися видимими в тексті стану. Розбір GS1, який чекає роздільник груп, має дозволити цей символ і відхилити решту.

Довжина. Вимагайте довжини, які приймає застосунок. Загальний мінімум і максимум безпечніші за одну обов’язкову довжину, коли форма отримує більше ніж одну символіку. maxlength на полі мовчки обріже довше корисне навантаження, тож задавайте його лише коли кожен прийнятний код вміщується.

Префікс. Зрізайте префікс лише якщо ви налаштували сканер надсилати саме цей префікс, а застосунок його не зберігає.

function withoutConfiguredPrefix(value, prefix) {
  if (prefix && value.startsWith(prefix)) {
    return value.slice(prefix.length)
  }
  return value
}

Ідентифікатор символіки AIM — це дані, якщо сканер налаштовано його передавати. Лишіть його на місці, доки не вирішите, чи зберігає його застосунок.

Суфікс. Не включайте завершальну клавішу в збережене значення. Enter і Tab — клавіші. У звичайне текстове поле вони не вставляються. Послідовне корисне навантаження все ще може містити байти CR або LF. Зрізайте їх на межі, де розбираєте послідовний потік, і перевірте, що не зрізаєте їх із середини корисного навантаження, яке їх законно містить.

Повторні надсилання. Одне сканування можна обробити двічі, якщо і keydown, і submit спрацьовують на той самий Enter. Використовуйте один шлях завершення. Друге сканування того самого коду — інше питання. Складська форма може збільшити кількість. Форма квитка може відхилити код, який уже погашено. Помістіть це правило в застосунок і перевірте його навмисно. Браузер не відрізнить друге натискання курка від другого слухача.

Правила застосунку. Контрольні суми належать конкретним символікам. EAN-13 використовує останню цифру як контрольну. Ця функція приймає лише такий формат:

function isEan13(value) {
  if (!/^\d{13}$/.test(value)) {
    return false
  }

  let sum = 0
  for (let index = 0; index < 12; index += 1) {
    const digit = Number(value[index])
    sum += index % 2 === 0 ? digit : digit * 3
  }

  const check = (10 - (sum % 10)) % 10
  return check === Number(value[12])
}

Code 128, Code 39 і QR цього розрахунку не використовують. Сканер, можливо, вже перевірив власну символіку і передав людиночитні дані. Перевіряйте формати, які зберігаєте, і повторіть перевірку на сервері. Надісланий рядок — звичайне введення користувача. Браузер не може довести, що його виробив сканер.

Тестування введення сканера штрихкодів без фізичного обладнання

Barcode Scanner Emulator — настільний застосунок для Windows, macOS і Linux. Ви вводите текст для надсилання, обираєте затримку набору і суфікс: немає, ENTER або TAB. Глобальне сполучення набирає цей текст у застосунок із фокусом. Воно відтворює клавіатурний шлях сканера-клина. Воно не підсвічує етикетку, не читає символ і не декодує символіку.

Використовуйте приклад сторінки вище або сторінку, яку збираєте:

  1. Відкрийте сторінку в настільному браузері і клацніть поле штрихкоду.
  2. В емуляторі введіть відоме значення, наприклад 123456789012.
  3. Поставте суфікс ENTER. Задайте затримку набору, якщо хочете, щоб пачка була схожа на вже виміряний сканер.
  4. Натисніть глобальне сполучення сканування емулятора, доки поле в браузері ще має фокус.
  5. Підтвердьте текст стану і те, що значення прийнято один раз.
  6. Повторіть із TAB. Фокус має перейти, а значення має бути прийняте один раз.
  7. Повторіть без суфікса. Текст має лишитися в полі, доки ви не натиснете Look up.
  8. Сфокусуйте сторінку тестера введення штрихкодів і надішліть те саме значення ще раз. Порівняйте захоплений рядок, префікс і суфікс із тим, що зберіг застосунок.

Встановлення і перше сполучення описано в посібнику Початок роботи. Після зміни налаштувань надішліть одне сканування в тестер введення, перш ніж довіряти результату в застосунку.

Обладнання все ще потрібне для оптичної та залежної від пристрою частини перевірки:

  • Чи може цей сканер декодувати надрукований або показаний символ, включно з пошкодженими етикетками, розміром, контрастом і відстанню.
  • Підтримка символік. Лазерний сканер 1D не може прочитати код QR. Див. Тестування QR-кодів: як тестувати сканери QR.
  • Перелічення USB, спарювання Bluetooth і власне налаштування розкладки клавіатури та суфікса сканера.
  • Інтеграції Serial, HID POS і SDK виробника.

Емулятор — правильний інструмент для логіки застосунку вздовж клавіатурного шляху. Це не інструмент, щоб довести, що конкретний сканер читає конкретну етикетку.

Налагодження подій клавіатури сканера штрихкодів

Дивіться події в цьому порядку, коли збережене значення хибне.

keydown. Спрацьовує для кожної клавіші, включно з Enter і Tab, до того як браузер вставить символ або перенесе фокус. Завершальну клавішу читайте тут. event.repeat істинний, коли клавішу утримують. Сканер-клин зазвичай надсилає окреме натискання на кожен символ.

input. Спрацьовує на полі після того, як друкований символ змінив його значення. Це правильна подія, якщо потрібен текст у міру зростання. Для Enter або Tab вона не спрацьовує, бо ці клавіші не вставляють символ у текстове поле.

change. Спрацьовує після фіксації значення, зазвичай коли поле втрачає фокус. Сканер, який лишає фокус у тому самому полі, не дасть change наприкінці сканування. Не використовуйте change як єдиний сигнал завершення.

event.key і event.code. Записуйте обидва, коли символ хибний. Розбіжність розкладки сканера і розкладки операційної системи змінює event.key і лишає event.code схожим на клавішу, яку сканер мав на увазі. Цифри з цифрової клавіатури використовують Numpad1 і подібні коди. Деякі маски введення трактують їх інакше, ніж Digit1. Посібник Хибна розкладка клавіатури сканера штрихкодів пояснює розбіжність розкладок.

Фокус. Запишіть document.activeElement безпосередньо перед скануванням. Якщо це не поле штрихкоду, решта трасування пояснює не той елемент. В iframe власний фокус. Сканування у вбудований фрейм видиме сценарію всередині цього фрейму.

Час. Сканери часто закінчують коротке корисне навантаження помітно швидше за секунду. Тестер введення порівнює середній проміжок між символами з порогом 100 ms і позначає результат як час, а не як розпізнавання обладнання. Поріг проміжку може прийняти швидкого набирача, автозаповнення або емулятор за сканер. Сканер із затримкою між символами, з’єднанням Bluetooth або довгим корисним навантаженням може виглядати як набір. Використовуйте захоплене значення і суфікс. Час використовуйте як підказку.

Тестер подій клавіатури перелічує кожен keydown і keyup з key, code, модифікаторами і мітками часу. Використовуйте його, коли зібраний рядок ховає клавішу префікса або код цифрової клавіатури. Журнал — це події браузера. Це не сирий трафік USB.

Часті проблеми у вебзастосунках

Сканування потрапляє не в те поле. Введення клина йде за фокусом. Клацайте цільове поле після кожної навігації, діалогу або повідомлення перевірки, які переносять фокус. Модальне вікно без текстового поля може проковтнути сканування як сполучення клавіш.

Сканер працює в текстовому редакторі і не працює в браузері. Пристрій друкує. Сторінка ці клавіші не приймає. Перевірте фокус, вимкнене поле або поле лише для читання і слухач keydown, який викликає preventDefault() на друкованих клавішах. Слухач, який обробляє лише paste, введення клина не бачить. Почніть із посібника Сканер штрихкодів не працює, якщо жоден застосунок не отримує символи.

Enter надсилає форму двічі або веде зі сторінки. Браузер надсилає форму, і ваш слухач теж обробляє Enter. Викличте preventDefault() на одному з цих шляхів і обробіть значення один раз. Форма з кількох полів може надіслатися до заповнення наступних полів, якщо сканер шле Enter. Для такого сценарію використовуйте Tab або забороніть надсилання, доки форму не заповнено.

Tab змінює фокус. Це клавіша Tab. Або налаштуйте Enter на сканері, або читайте значення в keydown і дозвольте перенесення фокусу. Див. розділ про суфікси вище.

Розкладка клавіатури хибна. Цифри можуть пережити розбіжність, яка змінює знаки пунктуації. Скануйте відоме значення з тими символами, які ви зберігаєте, на розкладці, яку робоче місце справді використовує.

Те саме сканування створює два записи. Шукайте два слухачі на одному Enter, перш ніж шукати два фізичні сканування. Потім перевірте навмисне друге сканування і підтвердьте правило кількості або дубліката, яке описує застосунок.

Значення відсутнє або обрізане. Атрибут maxlength, маска введення або preventDefault() на символьних клавішах можуть відкинути або обрізати корисне навантаження. Порівняйте кількість символів у тестері введення зі значенням у вашому полі. Префікс теж може зробити правильне корисне навантаження занадто довгим на вигляд.

Коди QR так і не з’являються. Сканер може бути лише 1D, або символіка QR може бути вимкнена. Застосунок цього не виправить. Підтвердьте обладнання за допомогою посібника Тестування QR-кодів: як тестувати сканери QR, а потім поверніться до перевірки поля.

Контрольний список перевірки вебзастосунку

Використовуйте його на збірці, яку збираєтеся випускати, у кожному підтримуваному браузері. Перевірте і свіжий профіль, і профіль із розширеннями менеджера паролів та автозаповнення: ці розширення переносять фокус.

  • Сканер підключено або спаровано, і хост показує, що він готовий.
  • Сканер у режимі клавіатурного клина, а не в режимі послідовного порту або SDK виробника.
  • Поле штрихкоду у фокусі безпосередньо перед скануванням. document.activeElement — це поле.
  • Відомий штрихкод приходить символ у символ, включно з довжиною.
  • Суфікс ENTER надсилає або приймає значення один раз і не лишає завершальну клавішу в збереженому рядку.
  • Суфікс TAB переносить фокус на задуманий елемент, а значення прочитано до перенесення.
  • Налаштування без суфікса лишає значення доступним, доки застосунок його не завершить.
  • Порожнє надсилання відхиляється або ігнорується.
  • Одне сканування не створює два записи. Друге справжнє сканування дотримується правила дублікатів застосунку.
  • Знаки пунктуації, символи і будь-який роздільник GS1, який використовують ваші формати, проходять шлях туди й назад.
  • Розкладка клавіатури сканера і розкладка операційної системи дають символи, надруковані на етикетці.
  • Після від’єднання і повторного підключення або після обриву з’єднання Bluetooth наступне сканування все ще доходить до поля.
  • Кілька сканувань поспіль лишаються окремими значеннями. Поле їх не склеює.
  • Ті самі перевірки проходять у підтримуваних браузерах, зі звичайними розширеннями автозаповнення і без них.

Для діалогів, порядку табуляції на всій касі та сценаріїв кількості в POS продовжуйте з посібником Як тестувати введення зі сканера штрихкодів.

Матриця тестів

Стовпець сканера — це те, що роблять пристрій і браузер. Стовпець очікуваної поведінки — це те, що застосунок має зробити у відповідь. Бізнес-правила, наприклад чи збільшує повторний код товару кількість, належать застосунку. Запишіть їх у тесті, а не припускайте одне правило для кожного продукту.

Сценарій Очікувана поведінка
Правильний штрихкод Застосунок приймає значення і зберігає корисне навантаження без завершальної клавіші.
Порожнє введення Застосунок відхиляє або ігнорує його і не створює запис.
Суфікс ENTER Застосунок надсилає або приймає значення один раз.
Суфікс TAB Фокус переходить на задуманий наступний елемент, і значення зберігається.
Без суфікса Введення лишається доступним, доки застосунок його не обробить.
Швидкі сканування поспіль Кожне значення обробляється окремо і не склеюється з попереднім.
Хибна розкладка клавіатури Неочікувані символи видно в захопленому значенні, і вони не проходять перевірку.
Повторне сканування Застосунок дотримується власного правила дублікатів, наприклад збільшує кількість або відхиляє повтор.
Хибний формат штрихкоду Застосунок показує помилку перевірки для цього формату і не зберігає значення.
Втрачено фокус введення Застосунок не вигадує штрихкод. Сканування відсутнє або потрапляє в елемент із фокусом, і сторінка лишається в безпечному стані.

Проженіть рядки правильного значення, порожнього введення, ENTER, TAB і відсутності суфікса фізичним сканером і ще раз емулятором. Рядки розкладки клавіатури, QR і повторного підключення женіть на обладнанні. Ці рядки залежать від пристрою, етикетки або розкладки операційної системи, чого імітація натискань не відтворює.