Barcode Scanner Emulator
Jak testovat čtečky čárových kódů ve webových aplikacích
Mnoho čteček čárových kódů USB a Bluetooth posílá dekódovaná data jako vstup z klávesnice, takže pole s fokusem ve webové aplikaci může přijmout sken bez zvláštního API prohlížeče pro čtečku. Sériové porty a SDK výrobce jsou samostatné integrace. Cestu klávesnice lze ověřit fyzickou čtečkou nebo simulovanými stisky.
Webová aplikace obvykle vidí čtečku čárových kódů jako klávesnici. Test spočívá v tom, zda ovládací prvek s fokusem dostane datovou zátěž, kterou aplikace očekává, a zda stránka zpracuje ukončovací klávesu, kterou je čtečka nastavena posílat. Může to být Enter, Tab, nebo nic.
Použijte relaci testeru vstupu čárového kódu, když je fyzická čtečka připojena. Použijte Barcode Scanner Emulator, když je stejná cesta klávesnice potřeba při vývoji a zařízení není na stole. Širší průchod fokusem, rozložením a scénáři POS je v průvodci Jak testovat vstup z čtečky čárových kódů. Tento průvodce zůstává u aplikace v prohlížeči: záznam, přípony, kontrola a události, které opravdu lze pozorovat.
Jak čtečky čárových kódů komunikují s webovými aplikacemi
Režim rozhraní rozhoduje, co stránka může přijmout. Potvrďte ho, než změníte kód formuláře. Čtečka často přepíná režimy naskenováním konfiguračního čárového kódu z příručky výrobce.
Klávesnicový klín USB HID
V režimu klávesnice USB HID se čtečka hlásí jako klávesnice. Operační systém načte běžný ovladač klávesnice. Po dekódování symbolu čtečka pošle znaky jako stisky do ovládacího prvku, který má fokus klávesnice. Stránka tyto stisky poslouchá, nebo čte text, který vkládají. Spojení se zařízením neotevírá.
Proto může pokladní pole, vyhledávací pole nebo jakýkoli jiný textový vstup přijmout sken obyčejným HTML. Průvodce Klávesnicový klín HID podrobněji popisuje posloupnost stisků, předpony a přípony.
Bluetooth HID
Čtečka Bluetooth spárovaná jako klávesnice jde v aplikaci stejnou cestou. Hostitel s ní zachází jako s klávesnicí HID a pole s fokusem dostává stisky. Párování, baterie a rádio jsou záležitosti zařízení. Jakmile znaky dorazí do prohlížeče, stránka je zpracuje stejně jako vstup z klínu USB.
Sériový port a virtuální COM
Sériová čtečka, včetně mnoha režimů virtuálního portu COM přes USB, posílá dekódovaný text jako bajty na port. Fokus adresáta nevybírá. Vybírá ho proces, který port otevřel. Textové pole, které jen poslouchá stisky, tento proud neuvidí.
Prohlížeče založené na Chromium mohou otevřít sériový port přes Web Serial API poté, co uživatel port vybere a udělí oprávnění. Firefox a Safari toto API neposkytují. Test klínu neprověří sériovou integraci a sériový test neřekne, co klínová čtečka napíše.
Rozhraní konkrétního výrobce
Některá zařízení používají SDK výrobce, OPOS, JPOS nebo neklávesnicové rozhraní HID, například USB HID POS. Tato rozhraní nepíšou do pole s fokusem. Běžná webová stránka nenačte nativní SDK. Chromium může po gestu uživatele požádat o některá neklávesnicová zařízení HID přes WebHID. Zařízení HID třídy klávesnice zůstávají blokována, takže klínová čtečka zůstává nerozeznatelná od klávesnice. Berte rozhraní výrobce jako vlastní integraci a testujte ho softwarem, který toto rozhraní skutečně otevírá.
Co prohlížeč vidí
Sken klínem přichází jako události keydown a keyup a tisknutelné znaky aktualizují pole s fokusem. Prohlížeč nedostane název zařízení, sériové číslo USB ani příznak „čtečka“. Prohlížeče s WebHID klávesnicová rozhraní stejně odmítají, takže skript stránky nemůže číst ani surové zprávy HID klínové čtečky.
event.key je znak nebo název klávesy poté, co operační systém použije aktivní rozložení klávesnice. event.code pojmenuje fyzickou klávesu, například Digit1 nebo Numpad1, a může zůstat stejný, když neshoda rozložení změní event.key. Ani jedna vlastnost hardware neidentifikuje.
Jak otestovat fyzickou čtečku čárových kódů v prohlížeči
Udělejte to před laděním kódu aplikace. Ukáže se přesný řetězec a ukončovací klávesa, které prohlížeč přijal.
- Připojte čtečku a počkejte, až ukáže, že má napájení. U Bluetooth dokončete párování a potvrďte, že hostitel používá profil klávesnice.
- Potvrďte režim vstupu. Klávesnicový klín, klávesnice USB HID nebo klávesnice Bluetooth HID mohou psát do pole. Režimy Serial, SPP a SDK výrobce nemohou.
- Otevřete stránku testeru vstupu čárového kódu.
- Klepněte na Spustit test, nebo klepněte na oblast skenování. Zmodrá, když je připravena. Stránka si fokus sama nebere.
- Naskenujte čárový kód, jehož datovou zátěž už znáte. Začněte krátkou číselnou hodnotou a pak naskenujte hodnotu s interpunkcí, kterou aplikace ukládá.
- Přečtěte zachycenou hodnotu a počet znaků. Porovnejte obojí s očekávanou datovou zátěží, včetně jakékoli předpony, kterou čtečka vkládá před data.
- Zkontrolujte příponu. Tester hlásí ENTER, TAB nebo Žádná. Když je Automatický záznam zapnutý, výsledek se objeví po Enter, Tab nebo po krátké pauze, jakmile klávesy ustanou. Vypněte Automatický záznam, když má záznam zůstat, dokud nestisknete Zastavit.
- Porovnejte tento výsledek s řetězcem, který má aplikace uložit. Předponu, nahrazený znak nebo chybějící ukončovací klávesu je třeba opravit v nastavení čtečky, nebo je vědomě zpracovat na stránce. Nepovažujte to za chybu dekódování, dokud toto porovnání není hotové.
Tester zaznamenává události klávesnice, které prohlížeč vidí. Nedokáže rozpoznat zařízení USB ani číst sériový port. Když textový editor sken přijme a prohlížeč ne, pokračujte průvodcem Čtečka funguje v Notepad, ale ne v POS.
Zachycení vstupu čtečky čárových kódů pomocí JavaScript
Čtečka píše do prvku, který má fokus. Dejte poli viditelný popisek, nechte ho jako běžný textový vstup, aby šlo kód napsat z klávesnice, a čtěte hodnotu, až workflow řekne, že zadání je hotové. Stránka níže to dělá. Enter odešle formulář jednou. Tab dokončí neprázdnou hodnotu a pak nechá prohlížeč přesunout fokus. Sken bez ukončovací klávesy zůstane v poli, dokud někdo neaktivuje tlačítko 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>
Uložte soubor a otevřete ho v desktopovém prohlížeči. Klepněte do pole, pokud se fokus posunul. Klínová čtečka, nebo emulátor z další části, pak píše do #barcode.
Fokus je nutný. Pokud je document.activeElement tělo dokumentu, tlačítko nebo jiný vstup, posluchače tohoto pole sken nevidí. Znaky skončí v ovládacím prvku s fokusem, nebo se ztratí. Volejte field.focus(), když je workflow připraveno na sken, včetně chvíle po zavření dialogu.
Prázdný vstup se ignoruje. Formulář zůstane na místě a stavový text řekne, že nic nepřišlo. Samotné bílé znaky jsou po trim() prázdné.
Příklad Enter ani Tab nepřidává. Pokud čtečka není nastavena je posílat, hodnota zůstane v poli a tlačítko Look up je cesta dokončení. autocomplete="off" snižuje šanci, že uložená hodnota nahradí sken. Popisek, tlačítko a Shift+Tab zůstávají k dispozici, takže člověk může kód zadat bez čtečky.
Zpracujte Enter na jednom místě. Tento příklad používá událost submit formuláře, která pokrývá i tlačítko Look up a Enter z klávesnice. Druhý posluchač keydown pro Enter by stejný sken zapsal dvakrát. Pokud vstup není uvnitř formuláře, poslouchejte Enter na keydown a zavolejte preventDefault(), aby nadřazený formulář také neodeslal:
field.addEventListener('keydown', (event) => {
if (event.key !== 'Enter') {
return
}
event.preventDefault()
const value = field.value.trim()
if (!value) {
return
}
console.log(value)
field.value = ''
})
Po úspěšném přijetí pole vymažte, aby se další sken nepřipojil k předchozí datové zátěži. Po Enter příklad znovu zaměří stejné pole, protože toto workflow čeká další sken ve stejném poli. Po Tab fokus nechá být, aby prohlížeč mohl přejít na další ovládací prvek.
Zpracování přípon ENTER a TAB
Přípona je klávesa, kterou čtečka může poslat po datové zátěži. Je to nastavení zařízení. Enter je běžný a je volitelný. Průvodce Přípony ENTER a TAB u čteček čárových kódů popisuje, jak ukončovací klávesy rozlišit. Potvrďte nastavení na čtečce, kterou testujete, a pak stránku tomuto workflow přizpůsobte.
ENTER
Enter v jednořádkovém textovém poli v současných prohlížečích odešle obklopující formulář. Použijte to, když má jeden sken hodnotu potvrdit, jako ve vyhledávacím poli. preventDefault() na události submit zabrání prohlížeči odejít ze stránky. Vynechte ho, když je požadovaným chováním přechod na jinou stránku.
Pokud se čárový kód objeví a formulář nic neudělá, čtečka možná neposílá příponu. Čtečce čárových kódů chybí ENTER tuto konfiguraci projde. Některá zařízení posílají NumPad Enter. event.key je pořád "Enter". Kontrolujte event.key, ne jen event.code === "Enter", jinak taková čtečka bude vypadat jako rozbitá.
TAB
Tab přesune fokus na další prvek, který ho může přijmout. Hodí se to k posloupnosti, jako je kód produktu a pak množství. Překvapí to formulář, který čekal, že ho odešle Enter.
Čtěte hodnotu v keydown, dokud pole ještě má fokus. Prohlížeč fokus přesune až po této události. Výchozí akci nechte, když má další ovládací prvek fokus dostat. preventDefault() fokus podrží na místě, což se hodí, když je hodnota neplatná a operátor ji má vidět. Ignorujte Shift+Tab, aby uživatel klávesnice mohl formulářem couvat. Přípona Tab čtečky je Tab bez Shift.
Přípona Tab může fokus přesunout i dřív, než kód pole přečte, pokud je posluchač na blur nebo change a něco jiného prvek vymaže. Čtěte hodnotu z target události keydown.
Bez přípony
Bez přípony datová zátěž sedí v poli. Aplikace musí rozhodnout, kdy je sken hotový. Výslovné tlačítko, pozdější Enter od operátora nebo přechod k dalšímu kroku jsou spolehlivé body dokončení. Časovač nečinnosti může pauzu v psaní považovat za konec skenu. Tento časovač je heuristika. Pomalá čtečka, zpoždění Bluetooth nebo člověk, který píše rychle, mohou spadnout na špatnou stranu prahu. Dejte přednost nastavené příponě, když workflow potřebuje tvrdý signál konce skenu.
Rozdíly v konfiguraci
Čtečky stejné značky mohou přijít s různými příponami a konfigurační čárový kód může příponu změnit bez jakékoli změny v JavaScript. Některá zařízení posílají předponu, identifikátor symbologie jako ]C1, nebo CR a LF. Otestujte tři ukončovací nastavení, která uživatelé opravdu mohou zvolit: Enter, Tab a žádnou příponu. Zapište, které používají nasazené čtečky, a stránku testujte proti tomuto nastavení.
Kontrola vstupu čtečky čárových kódů
Kontrolujte řetězec, který pole přijalo. Nepředpokládejte, že každý čárový kód má stejnou délku, sadu znaků a kontrolní součet. Datové zátěže Code 128 a QR se liší. EAN-13 má 13 číslic. Aplikace, která ukládá obojí, potřebuje pravidla pro obojí.
Prázdný vstup. Odmítněte ho nebo ignorujte. Přípona bez datové zátěže nebo klepnutí na Look up v prázdném poli nemá vytvořit záznam.
Neočekávané znaky. Porovnejte přijatý řetězec se známým štítkem. Neshoda rozložení se často projeví jako změněný symbol, třeba posunutá číslice nebo interpunkce, zatímco délka zůstane. Řídicí znaky mohou přijít z předpony nebo z oddělovače skupin GS1. Povolte znaky, které váš formát definuje. Příklad výše odmítá řídicí znaky ASCII, aby zůstaly vidět ve stavovém textu. Parser GS1, který čeká oddělovač skupin, má tento znak povolit a ostatní odmítnout.
Délka. Vynucujte délky, které aplikace přijímá. Celkové minimum a maximum je bezpečnější než jedna povinná délka, když formulář dostává víc než jednu symbologii. maxlength na vstupu delší datovou zátěž potichu ořízne, takže ho nastavte jen tehdy, když se každý přijímaný kód vejde.
Předpona. Předponu odstraňte jen tehdy, když jste čtečku nastavili posílat přesně tuto předponu a aplikace ji neukládá.
function withoutConfiguredPrefix(value, prefix) {
if (prefix && value.startsWith(prefix)) {
return value.slice(prefix.length)
}
return value
}
Identifikátor symbologie AIM jsou data, pokud je čtečka nastavena ho vysílat. Nechte ho na místě, dokud nerozhodnete, zda ho aplikace ukládá.
Přípona. Ukončovací klávesu do uložené hodnoty nedávejte. Enter a Tab jsou klávesy. Do běžného textového vstupu se nevkládají. Sériová datová zátěž může pořád obsahovat bajty CR nebo LF. Odstraňte je na hranici, kde parsujete sériový proud, a ověřte, že je neodstraňujete ze středu datové zátěže, která je oprávněně obsahuje.
Duplicitní odeslání. Jeden sken lze zpracovat dvakrát, pokud pro stejný Enter běží keydown i submit. Použijte jednu cestu dokončení. Druhý sken stejného kódu je jiná otázka. Skladový formulář může zvýšit množství. Formulář vstupenky může odmítnout kód, který už byl uplatněn. Dejte toto pravidlo do aplikace a otestujte ho schválně. Prohlížeč nerozezná druhé stisknutí spouště od druhého posluchače.
Pravidla aplikace. Kontrolní součty patří konkrétním symbologiím. EAN-13 používá poslední číslici jako kontrolní číslici. Tato funkce přijímá jen tento formát:
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 a QR tento výpočet nepoužívají. Čtečka už mohla zkontrolovat vlastní symbologii a vyslat člověkem čitelná data. Kontrolujte formáty, které ukládáte, a kontrolu zopakujte na serveru. Odeslaný řetězec je běžný vstup uživatele. Prohlížeč nemůže dokázat, že ho vyrobila čtečka.
Testování vstupu čtečky čárových kódů bez fyzického hardwaru
Barcode Scanner Emulator je desktopová aplikace pro Windows, macOS a Linux. Zadáte text k odeslání, zvolíte prodlevu psaní a příponu: žádná, ENTER nebo TAB. Globální zkratka tento text napíše do aplikace s fokusem. Napodobuje cestu klávesnice, kterou používá klínová čtečka. Neosvítí štítek, nepřečte symbol a nedekóduje symbologii.
Použijte ukázkovou stránku výše, nebo stránku, kterou stavíte:
- Otevřete stránku v desktopovém prohlížeči a klepněte do pole čárového kódu.
- V emulátoru zadejte známou hodnotu, například
123456789012. - Nastavte příponu na ENTER. Nastavte prodlevu psaní, pokud chcete, aby dávka připomínala čtečku, kterou jste už změřili.
- Stiskněte globální zkratku skenu emulátoru, dokud pole v prohlížeči ještě má fokus.
- Potvrďte stavový text a to, že hodnota byla přijata jednou.
- Opakujte s TAB. Fokus se má přesunout a hodnota má být přijata jednou.
- Opakujte bez přípony. Text má zůstat v poli, dokud neaktivujete Look up.
- Dejte fokus stránce testeru vstupu čárového kódu a pošlete stejnou hodnotu znovu. Porovnejte zachycený řetězec, předponu a příponu s tím, co aplikace uložila.
Instalaci a první zkratku popisuje Začínáme. Po změně nastavení pošlete jeden sken do testeru vstupu, než výsledku v aplikaci uvěříte.
Hardware je pořád nutný pro optickou a na zařízení vázanou část testu:
- Zda tato čtečka umí dekódovat vytištěný nebo zobrazený symbol, včetně poškozených štítků, velikosti, kontrastu a vzdálenosti.
- Podpora symbologií. Laserová čtečka 1D neumí přečíst kód QR. Viz Testování kódů QR: jak testovat čtečky kódů QR.
- Výčet USB, párování Bluetooth a vlastní nastavení rozložení klávesnice a přípony čtečky.
- Integrace Serial, HID POS a SDK výrobce.
Emulátor je správný nástroj pro logiku aplikace podél cesty klávesnice. Není to nástroj k důkazu, že konkrétní čtečka čte konkrétní štítek.
Ladění událostí klávesnice čtečky čárových kódů
Sledujte události v tomto pořadí, když je uložená hodnota špatně.
keydown. Spustí se pro každou klávesu, včetně Enter a Tab, dřív než prohlížeč vloží znak nebo přesune fokus. Ukončovací klávesu čtěte tady. event.repeat je pravda, když je klávesa držena. Klínová čtečka obvykle posílá samostatný stisk pro každý znak.
input. Spustí se na poli poté, co tisknutelný znak změní jeho hodnotu. Je to správná událost, pokud potřebujete text, jak roste. Pro Enter ani Tab se nespustí, protože tyto klávesy do textového vstupu znak nevkládají.
change. Spustí se po potvrzení hodnoty, obvykle když pole ztratí fokus. Čtečka, která nechá fokus ve stejném poli, na konci skenu change nevyvolá. Nepoužívejte change jako jediný signál dokončení.
event.key a event.code. Zapisujte obojí, když je znak špatně. Neshoda rozložení čtečky a rozložení operačního systému změní event.key a nechá event.code vypadat jako klávesu, kterou čtečka zamýšlela. Číslice z numerické klávesnice používají Numpad1 a podobné kódy. Některé vstupní masky s nimi zacházejí jinak než s Digit1. Špatné rozložení klávesnice u čtečky čárových kódů neshodu rozložení vysvětluje.
Fokus. Zapište document.activeElement těsně před skenem. Pokud to není pole čárového kódu, zbytek stopy vysvětluje špatný ovládací prvek. Iframe mají vlastní fokus. Sken do vloženého rámu vidí skript uvnitř tohoto rámu.
Časování. Čtečky často dokončí krátkou datovou zátěž výrazně pod sekundu. Tester vstupu porovnává průměrnou mezeru mezi znaky s prahem 100 ms a výsledek označí jako časování, ne jako identifikaci hardwaru. Práh mezery může rychlého písaře, automatické vyplnění nebo emulátor považovat za čtečku. Čtečka s prodlevou mezi znaky, spojením Bluetooth nebo dlouhou datovou zátěží může vypadat jako psaní. Používejte zachycenou hodnotu a příponu. Časování berte jako vodítko.
Tester událostí klávesnice vypisuje každé keydown a keyup s key, code, modifikátory a časovými značkami. Použijte ho, když složený řetězec skrývá klávesu předpony nebo kód numerické klávesnice. Protokol jsou události prohlížeče. Není to surový provoz USB.
Časté problémy ve webových aplikacích
Sken jde do špatného pole. Vstup klínem sleduje fokus. Klepněte na cílové pole po každé navigaci, dialogu nebo validační zprávě, která fokus přesune. Modální okno bez textového pole může sken spolknout jako klávesové zkratky.
Čtečka funguje v textovém editoru a ne v prohlížeči. Zařízení píše. Stránka tyto klávesy nepřijímá. Zkontrolujte fokus, zakázaný nebo jen pro čtení vstup a posluchače keydown, který na tisknutelných klávesách volá preventDefault(). Posluchač, který zpracovává jen paste, vstup klínem nikdy neuvidí. Začněte průvodcem Čtečka čárových kódů nefunguje, pokud žádná aplikace znaky nedostává.
Enter odešle formulář dvakrát nebo opustí stránku. Prohlížeč formulář odešle a váš posluchač Enter také zpracuje. Zavolejte preventDefault() na jedné z těchto cest a hodnotu zpracujte jednou. Vícepolový formulář se může odeslat dřív, než jsou pozdější pole vyplněna, když čtečka posílá Enter. Pro toto workflow použijte Tab, nebo odeslání zabraňte, dokud formulář není kompletní.
Tab mění fokus. To je klávesa Tab. Buď na čtečce nastavte Enter, nebo hodnotu čtěte v keydown a přesun fokusu povolte. Viz část o příponách výše.
Rozložení klávesnice je špatně. Číslice mohou přežít neshodu, která mění interpunkci. Naskenujte známou hodnotu se symboly, které ukládáte, na rozložení, které pracoviště skutečně používá.
Stejný sken vytvoří dva záznamy. Hledejte dva posluchače na jednom Enter, než budete hledat dva fyzické skeny. Pak otestujte záměrný druhý sken a potvrďte pravidlo množství nebo duplicity, které aplikace popisuje.
Hodnota chybí nebo je oříznutá. Atribut maxlength, vstupní maska nebo preventDefault() na znakových klávesách mohou datovou zátěž zahodit nebo uříznout. Porovnejte počet znaků v testeru vstupu s hodnotou ve vašem poli. Předpona také může správnou datovou zátěž nechat vypadat příliš dlouze.
Kódy QR se nikdy neobjeví. Čtečka může být jen 1D, nebo symbologie QR může být vypnutá. Aplikace to neopraví. Hardware potvrďte pomocí Testování kódů QR: jak testovat čtečky kódů QR a pak se vraťte k testu pole.
Kontrolní seznam testování webové aplikace
Použijte ho na buildu, který chcete vydat, v každém prohlížeči, který podporujete. Zkontrolujte čerstvý profil i profil s rozšířeními správce hesel a automatického vyplňování, protože tato rozšíření přesouvají fokus.
- Čtečka je připojena nebo spárována a hostitel ukazuje, že je připravena.
- Čtečka je v režimu klávesnicového klínu, ne v sériovém režimu ani v režimu SDK výrobce.
- Pole čárového kódu má fokus těsně před skenem.
document.activeElementje toto pole. - Známý čárový kód přijde znak po znaku, včetně délky.
- Přípona ENTER hodnotu odešle nebo přijme jednou a nenechá ukončovací klávesu v uloženém řetězci.
- Přípona TAB přesune fokus na zamýšlený ovládací prvek a hodnota je přečtena před přesunem.
- Nastavení bez přípony nechá hodnotu dostupnou, dokud ji aplikace nedokončí.
- Prázdné odeslání je odmítnuto nebo ignorováno.
- Jeden sken nevytvoří dva záznamy. Druhý skutečný sken se řídí pravidlem duplicit aplikace.
- Interpunkce, symboly a jakýkoli oddělovač GS1, který vaše formáty používají, projdou cestou tam a zpět.
- Rozložení klávesnice čtečky a rozložení operačního systému dají znaky vytištěné na štítku.
- Po odpojení a opětovném připojení, nebo po výpadku spojení Bluetooth, další sken pole pořád dosáhne.
- Několik skenů za sebou zůstane samostatnými hodnotami. Pole je nespojuje.
- Stejné kontroly projdou v podporovaných prohlížečích, s běžnými rozšířeními automatického vyplňování i bez nich.
U dialogů, pořadí tabulátoru přes celou pokladnu a toků množství v POS pokračujte průvodcem Jak testovat vstup z čtečky čárových kódů.
Matice testovacích případů
Sloupec čtečky je to, co dělají zařízení a prohlížeč. Sloupec očekávaného chování je to, co má aplikace v odpovědi udělat. Obchodní pravidla, třeba zda opakovaný kód produktu zvýší množství, patří aplikaci. Uveďte je v testu a nepředpokládejte jedno pravidlo pro každý produkt.
| Scénář | Očekávané chování |
|---|---|
| Platný čárový kód | Aplikace hodnotu přijme a uloží datovou zátěž bez ukončovací klávesy. |
| Prázdný vstup | Aplikace ho odmítne nebo ignoruje a záznam nevytvoří. |
| Přípona ENTER | Aplikace hodnotu odešle nebo přijme jednou. |
| Přípona TAB | Fokus přejde na zamýšlený další ovládací prvek a hodnota se zachová. |
| Bez přípony | Vstup zůstane dostupný, dokud ho aplikace nezpracuje. |
| Rychlé skeny za sebou | Každá hodnota se zpracuje samostatně a nespojí se s předchozí. |
| Špatné rozložení klávesnice | Neočekávané znaky jsou v zachycené hodnotě vidět a kontrolou neprojdou. |
| Duplicitní sken | Aplikace se řídí vlastním pravidlem duplicity, třeba zvýší množství nebo odmítne opakování. |
| Neplatný formát čárového kódu | Aplikace ukáže chybu kontroly pro tento formát a hodnotu neuloží. |
| Ztracený fokus vstupu | Aplikace si čárový kód nevymyslí. Sken chybí nebo skončí v ovládacím prvku s fokusem a stránka zůstane v bezpečném stavu. |
Řádky platné hodnoty, prázdného vstupu, ENTER, TAB a žádné přípony projeďte fyzickou čtečkou a znovu emulátorem. Řádky rozložení klávesnice, QR a opětovného připojení jeďte na hardwaru. Tyto řádky závisejí na zařízení, štítku nebo rozložení operačního systému, což simulované stisky nereprodukují.