Barcode Scanner Emulator
Ako testovať skenery čiarových kódov vo webových aplikáciách
Mnohé skenery čiarových kódov USB a Bluetooth posielajú dekódované údaje ako vstup z klávesnice, takže pole so zameraním vo webovej aplikácii môže prijať sken bez osobitného API prehliadača pre skener. Sériové porty a SDK výrobcu sú samostatné integrácie. Cestu klávesnice overíte fyzickým skenerom alebo simulovanými stlačeniami.
Webová aplikácia zvyčajne vidí skener čiarových kódov ako klávesnicu. Test zisťuje, či prvok so zameraním dostane obsah, ktorý aplikácia očakáva, a či stránka spracuje ukončovaciu klávesu, ktorú je skener nastavený posielať. Môže to byť Enter, Tab alebo nič.
Keď je fyzický skener pripojený, použite reláciu testera vstupu čiarových kódov. Keď potrebujete tú istú cestu klávesnice počas vývoja a zariadenie nie je na stole, použite Barcode Scanner Emulator. Širší prechod cez zameranie, rozloženie a scenáre POS je v sprievodcovi Ako testovať vstup zo skenera čiarových kódov. Tento sprievodca ostáva pri aplikácii v prehliadači: zachytenie, prípony, kontrola a udalosti, ktoré sa dajú naozaj sledovať.
Ako skenery čiarových kódov komunikujú s webovými aplikáciami
Režim rozhrania rozhoduje, čo stránka dokáže prijať. Potvrďte ho skôr, než zmeníte kód formulára. Skener často prepína režimy naskenovaním konfiguračného čiarového kódu z príručky výrobcu.
Klávesnicový klin USB HID
V režime klávesnice USB HID sa skener hlási ako klávesnica. Operačný systém načíta bežný ovládač klávesnice. Po dekódovaní symbolu skener pošle znaky ako stlačenia do ovládacieho prvku, ktorý má zameranie klávesnice. Stránka tieto stlačenia počúva, alebo číta text, ktorý vkladajú. Spojenie so zariadením neotvára.
Preto môže pokladničné pole, vyhľadávacie pole alebo akýkoľvek iný textový vstup prijať sken obyčajným HTML. Sprievodca Klávesnicový klin HID podrobnejšie opisuje postupnosť stlačení, predpony a prípony.
Bluetooth HID
Skener Bluetooth spárovaný ako klávesnica ide v aplikácii tou istou cestou. Hostiteľ s ním zaobchádza ako s klávesnicou HID a pole so zameraním dostáva stlačenia. Párovanie, batéria a rádio sú veci zariadenia. Keď znaky dorazia do prehliadača, stránka ich spracuje rovnako ako vstup z klinu USB.
Sériový port a virtuálny COM
Sériový skener, vrátane mnohých režimov virtuálneho portu COM cez USB, posiela dekódovaný text ako bajty na port. Zameranie adresáta nevyberá. Vyberá ho proces, ktorý port otvoril. Textové pole, ktoré len počúva stlačenia, tento prúd neuvidí.
Prehliadače založené na Chromium vedia otvoriť sériový port cez Web Serial API až potom, čo používateľ port vyberie a udelí povolenie. Firefox a Safari toto API neposkytujú. Test klinu neprecvičí sériovú integráciu a sériový test nepovie, čo klinový skener napíše.
Rozhrania konkrétneho výrobcu
Niektoré zariadenia používajú SDK výrobcu, OPOS, JPOS alebo neklávesnicové rozhranie HID, napríklad USB HID POS. Tieto rozhrania nepíšu do poľa so zameraním. Bežná webová stránka nenačíta natívne SDK. Chromium môže po geste používateľa požiadať o niektoré neklávesnicové zariadenia HID cez WebHID. Zariadenia HID triedy klávesnice ostávajú zablokované, takže klinový skener ostáva na nerozoznanie od klávesnice. Berte rozhranie výrobcu ako vlastnú integráciu a testujte ho softvérom, ktorý toto rozhranie skutočne otvára.
Čo prehliadač vidí
Sken klinom prichádza ako udalosti keydown a keyup a tlačiteľné znaky aktualizujú pole so zameraním. Prehliadač nedostane názov zariadenia, sériové číslo USB ani príznak „skener“. Prehliadače s WebHID klávesnicové rozhrania aj tak odmietajú, takže skript stránky neprečíta ani surové hlásenia HID klinového skenera.
event.key je znak alebo názov klávesu po tom, čo operačný systém použije aktívne rozloženie klávesnice. event.code pomenuje fyzický kláves, napríklad Digit1 alebo Numpad1, a môže ostať rovnaký, keď nesúlad rozložení zmení event.key. Ani jedna vlastnosť hardvér neidentifikuje.
Ako otestovať fyzický skener čiarových kódov v prehliadači
Urobte to pred ladením kódu aplikácie. Ukáže sa presný reťazec a ukončovacia klávesa, ktoré prehliadač prijal.
- Pripojte skener a počkajte, kým ukáže, že má napájanie. Pri Bluetooth dokončite párovanie a potvrďte, že hostiteľ používa profil klávesnice.
- Potvrďte režim vstupu. Klávesnicový klin, klávesnica USB HID alebo klávesnica Bluetooth HID vedia písať do poľa. Režimy Serial, SPP a SDK výrobcu nie.
- Otvorte stránku testera vstupu čiarových kódov.
- Kliknite na Spustiť test, alebo kliknite na oblasť skenovania. Zmodrie, keď je pripravená. Stránka si zameranie sama neberie.
- Naskenujte čiarový kód, ktorého obsah už poznáte. Začnite krátkou číselnou hodnotou a potom naskenujte hodnotu s interpunkciou, ktorú aplikácia ukladá.
- Prečítajte zachytenú hodnotu a počet znakov. Porovnajte oboje s očakávaným obsahom, vrátane akejkoľvek predpony, ktorú skener vkladá pred údaje.
- Skontrolujte príponu. Tester hlási ENTER, TAB alebo Žiadna. Keď je Automatické zachytenie zapnuté, výsledok sa objaví po Enter, Tab alebo po krátkej pauze, keď klávesy ustanú. Vypnite Automatické zachytenie, keď má zachytenie ostať, kým nestlačíte Zastaviť.
- Porovnajte tento výsledok s reťazcom, ktorý má aplikácia uložiť. Predponu, nahradený znak alebo chýbajúcu ukončovaciu klávesu treba opraviť v nastavení skenera, alebo ich vedome spracovať na stránke. Nepokladajte to za chybu dekódovania, kým toto porovnanie nie je hotové.
Tester zaznamenáva udalosti klávesnice, ktoré prehliadač vidí. Nedokáže identifikovať zariadenie USB ani čítať sériový port. Keď textový editor sken prijme a prehliadač nie, pokračujte textom Skener funguje v Notepade, ale nie v POS.
Zachytenie vstupu skenera čiarových kódov pomocou JavaScript
Skener píše do prvku, ktorý má zameranie. Dajte poľu viditeľný popis, nechajte ho ako bežný textový vstup, aby sa kód dal napísať z klávesnice, a čítajte hodnotu, keď postup povie, že zadanie je hotové. Stránka nižšie to robí. Enter odošle formulár raz. Tab dokončí neprázdnu hodnotu a potom nechá prehliadač presunúť zameranie. Sken bez ukončovacej klávesy ostane v poli, kým niekto neaktivuje tlačidlo 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 súbor a otvorte ho v desktopovom prehliadači. Kliknite do poľa, ak sa zameranie posunulo. Klinový skener, alebo emulátor z ďalšej časti, potom píše do #barcode.
Zameranie je nutné. Ak je document.activeElement telo dokumentu, tlačidlo alebo iný vstup, poslucháče tohto poľa sken nevidia. Znaky skončia v ovládacom prvku so zameraním, alebo sa stratia. Volajte field.focus(), keď je postup pripravený na sken, aj po zatvorení dialógu.
Prázdny vstup sa ignoruje. Formulár ostane na mieste a stavový text povie, že nič neprišlo. Samotné biele znaky sú po trim() prázdne.
Príklad Enter ani Tab nepridáva. Ak skener nie je nastavený ich posielať, hodnota ostane v poli a tlačidlo Look up je cesta dokončenia. autocomplete="off" znižuje šancu, že uložená hodnota nahradí sken. Popis, tlačidlo a Shift+Tab ostávajú k dispozícii, takže človek môže kód zadať bez skenera.
Spracujte Enter na jednom mieste. Tento príklad používa udalosť submit formulára, ktorá pokryje aj tlačidlo Look up a Enter z klávesnice. Druhý poslucháč keydown pre Enter by ten istý sken zapísal dvakrát. Ak vstup nie je vo formulári, počúvajte Enter na keydown a zavolajte preventDefault(), aby nadradený formulár tiež neodoslal:
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 úspešnom prijatí pole vymažte, aby sa ďalší sken nepripojil k predchádzajúcemu obsahu. Po Enter príklad znova zameria to isté pole, lebo tento postup čaká ďalší sken v tom istom poli. Po Tab zameranie nechá tak, aby prehliadač mohol prejsť na ďalší ovládací prvok.
Spracovanie prípon ENTER a TAB
Prípona je kláves, ktorý skener môže poslať po obsahu. Je to nastavenie zariadenia. Enter je bežný a je voliteľný. Text Prípony ENTER a TAB v skeneroch čiarových kódov opisuje, ako ukončovacie klávesy rozlíšiť. Potvrďte nastavenie na skeneri, ktorý testujete, a potom stránku tomuto postupu prispôsobte.
ENTER
Enter v jednoriadkovom textovom poli v súčasných prehliadačoch odošle obklopujúci formulár. Použite to, keď má jeden sken hodnotu potvrdiť, ako vo vyhľadávacom poli. preventDefault() na udalosti submit zabráni prehliadaču odísť zo stránky. Vynechajte ho, keď je žiadaným správaním prechod na inú stránku.
Ak sa čiarový kód objaví a formulár nič neurobí, skener možno neposiela príponu. Skeneru čiarových kódov chýba ENTER touto konfiguráciou prejde. Niektoré zariadenia posielajú NumPad Enter. event.key je stále "Enter". Kontrolujte event.key, nie iba event.code === "Enter", inak taký skener bude vyzerať ako pokazený.
TAB
Tab presunie zameranie na ďalší prvok, ktorý ho môže prijať. Hodí sa to k postupnosti, ako je kód produktu a potom množstvo. Prekvapí to formulár, ktorý čakal, že ho odošle Enter.
Čítajte hodnotu v keydown, kým pole ešte má zameranie. Prehliadač zameranie presunie až po tejto udalosti. Predvolenú akciu nechajte, keď má ďalší ovládací prvok zameranie dostať. preventDefault() zameranie podrží na mieste, čo sa hodí, keď je hodnota neplatná a operátor ju má vidieť. Ignorujte Shift+Tab, aby používateľ klávesnice mohol formulárom cúvať. Prípona Tab skenera je Tab bez Shift.
Prípona Tab môže zameranie presunúť aj skôr, než kód pole prečíta, ak je poslucháč na blur alebo change a niečo iné prvok vymaže. Čítajte hodnotu z target udalosti keydown.
Bez prípony
Bez prípony obsah sedí v poli. Aplikácia musí rozhodnúť, kedy je sken hotový. Výslovné tlačidlo, neskorší Enter od operátora alebo prechod na ďalší krok sú spoľahlivé body dokončenia. Časovač nečinnosti môže pauzu v písaní pokladať za koniec skenu. Tento časovač je heuristika. Pomalý skener, oneskorenie Bluetooth alebo človek, ktorý píše rýchlo, môžu spadnúť na nesprávnu stranu prahu. Dajte prednosť nastavenej prípone, keď postup potrebuje tvrdý signál konca skenu.
Rozdiely v konfigurácii
Skenery tej istej značky môžu prísť s rôznymi príponami a konfiguračný čiarový kód môže príponu zmeniť bez akejkoľvek zmeny v JavaScript. Niektoré zariadenia posielajú predponu, identifikátor symbologie ako ]C1, alebo CR a LF. Otestujte tri ukončovacie nastavenia, ktoré používatelia naozaj vedia zvoliť: Enter, Tab a žiadnu príponu. Zapíšte, ktoré používajú nasadené skenery, a stránku testujte proti tomuto nastaveniu.
Kontrola vstupu skenera čiarových kódov
Kontrolujte reťazec, ktorý pole prijalo. Nepredpokladajte, že každý čiarový kód má rovnakú dĺžku, sadu znakov a kontrolný súčet. Obsah Code 128 a QR sa líši. EAN-13 má 13 číslic. Aplikácia, ktorá ukladá oboje, potrebuje pravidlá pre oboje.
Prázdny vstup. Odmietnite ho alebo ho ignorujte. Prípona bez obsahu alebo kliknutie na Look up v prázdnom poli nemá vytvoriť záznam.
Neočakávané znaky. Porovnajte prijatý reťazec so známym štítkom. Nesúlad rozložení sa často ukáže ako zmenený symbol, napríklad posunutá číslica alebo interpunkcia, kým dĺžka ostane. Riadiace znaky môžu prísť z predpony alebo z oddeľovača skupín GS1. Povoľte znaky, ktoré váš formát definuje. Príklad vyššie odmieta riadiace znaky ASCII, aby ostali viditeľné v stavovom texte. Analyzátor GS1, ktorý čaká oddeľovač skupín, má tento znak povoliť a ostatné odmietnuť.
Dĺžka. Vynucujte dĺžky, ktoré aplikácia prijíma. Celkové minimum a maximum je bezpečnejšie než jedna povinná dĺžka, keď formulár dostáva viac než jednu symbologiu. maxlength na vstupe dlhší obsah potichu oreže, takže ho nastavte len vtedy, keď sa každý prijímaný kód zmestí.
Predpona. Predponu odstráňte len vtedy, keď ste skener nastavili posielať presne túto predponu a aplikácia ju neukladá.
function withoutConfiguredPrefix(value, prefix) {
if (prefix && value.startsWith(prefix)) {
return value.slice(prefix.length)
}
return value
}
Identifikátor symbologie AIM sú údaje, ak je skener nastavený ho vysielať. Nechajte ho na mieste, kým nerozhodnete, či ho aplikácia ukladá.
Prípona. Ukončovaciu klávesu do uloženej hodnoty nedávajte. Enter a Tab sú klávesy. Do bežného textového vstupu sa nevkladajú. Sériový obsah môže stále obsahovať bajty CR alebo LF. Odstráňte ich na hranici, kde analyzujete sériový prúd, a overte, že ich neodstraňujete zo stredu obsahu, ktorý ich oprávnene obsahuje.
Duplicitné odoslania. Jeden sken sa dá spracovať dvakrát, ak pre ten istý Enter beží keydown aj submit. Použite jednu cestu dokončenia. Druhý sken toho istého kódu je iná otázka. Skladový formulár môže zvýšiť množstvo. Formulár vstupenky môže odmietnuť kód, ktorý už bol uplatnený. Dajte toto pravidlo do aplikácie a otestujte ho zámerne. Prehliadač nerozozná druhé stlačenie spúšte od druhého poslucháča.
Pravidlá aplikácie. Kontrolné súčty patria konkrétnym symbologiám. EAN-13 používa poslednú číslicu ako kontrolnú číslicu. Táto funkcia prijíma len 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ú. Skener už mohol skontrolovať vlastnú symbologiu a vyslať údaje čitateľné človekom. Kontrolujte formáty, ktoré ukladáte, a kontrolu zopakujte na serveri. Odoslaný reťazec je bežný vstup používateľa. Prehliadač nemôže dokázať, že ho vyrobil skener.
Testovanie vstupu skenera čiarových kódov bez fyzického hardvéru
Barcode Scanner Emulator je desktopová aplikácia pre Windows, macOS a Linux. Zadáte text na odoslanie, zvolíte oneskorenie písania a príponu: žiadna, ENTER alebo TAB. Globálna skratka tento text napíše do aplikácie so zameraním. Napodobňuje cestu klávesnice, ktorú používa klinový skener. Neosvetlí štítok, neprečíta symbol a nedekóduje symbologiu.
Použite ukážkovú stránku vyššie, alebo stránku, ktorú staviate:
- Otvorte stránku v desktopovom prehliadači a kliknite do poľa čiarového kódu.
- V emulátore zadajte známu hodnotu, napríklad
123456789012. - Nastavte príponu na ENTER. Nastavte oneskorenie písania, ak chcete, aby dávka pripomínala skener, ktorý ste už zmerali.
- Stlačte globálnu skratku skenu emulátora, kým pole v prehliadači ešte má zameranie.
- Potvrďte stavový text a to, že hodnota bola prijatá raz.
- Zopakujte s TAB. Zameranie sa má presunúť a hodnota má byť prijatá raz.
- Zopakujte bez prípony. Text má ostať v poli, kým neaktivujete Look up.
- Dajte zameranie stránke testera vstupu čiarových kódov a pošlite tú istú hodnotu znova. Porovnajte zachytený reťazec, predponu a príponu s tým, čo aplikácia uložila.
Inštaláciu a prvú skratku opisuje Začíname. Po zmene nastavení pošlite jeden sken do testera vstupu, kým výsledku v aplikácii uveríte.
Hardvér je stále nutný pre optickú časť testu a pre časť viazanú na zariadenie:
- Či tento skener vie dekódovať vytlačený alebo zobrazený symbol, vrátane poškodených štítkov, veľkosti, kontrastu a vzdialenosti.
- Podpora symbologií. Laserový skener 1D nevie prečítať kód QR. Pozrite Testovanie QR kódov: ako testovať skenery QR.
- Výpočet USB, párovanie Bluetooth a vlastné nastavenie rozloženia klávesnice a prípony skenera.
- Integrácie Serial, HID POS a SDK výrobcu.
Emulátor je správny nástroj pre logiku aplikácie pozdĺž cesty klávesnice. Nie je to nástroj na dôkaz, že konkrétny skener číta konkrétny štítok.
Ladenie udalostí klávesnice skenera čiarových kódov
Sledujte udalosti v tomto poradí, keď je uložená hodnota nesprávna.
keydown. Spustí sa pre každý kláves, vrátane Enter a Tab, skôr než prehliadač vloží znak alebo presunie zameranie. Ukončovaciu klávesu čítajte tu. event.repeat je pravda, keď je kláves podržaný. Klinový skener zvyčajne posiela samostatné stlačenie pre každý znak.
input. Spustí sa na poli potom, čo tlačiteľný znak zmení jeho hodnotu. Je to správna udalosť, ak potrebujete text, ako rastie. Pre Enter ani Tab sa nespustí, lebo tieto klávesy do textového vstupu znak nevkladajú.
change. Spustí sa po potvrdení hodnoty, zvyčajne keď pole stratí zameranie. Skener, ktorý nechá zameranie v tom istom poli, na konci skenu change nevyvolá. Nepoužívajte change ako jediný signál dokončenia.
event.key a event.code. Zapisujte oboje, keď je znak nesprávny. Nesúlad rozloženia skenera a rozloženia operačného systému zmení event.key a nechá event.code vyzerať ako kláves, ktorý skener zamýšľal. Číslice z numerickej klávesnice používajú Numpad1 a podobné kódy. Niektoré vstupné masky s nimi zaobchádzajú inak než s Digit1. Nesprávne rozloženie klávesnice skenera čiarových kódov nesúlad rozložení vysvetľuje.
Zameranie. Zapíšte document.activeElement tesne pred skenom. Ak to nie je pole čiarového kódu, zvyšok stopy vysvetľuje nesprávny ovládací prvok. Iframe majú vlastné zameranie. Sken do vloženého rámu vidí skript vo vnútri tohto rámu.
Časovanie. Skenery často dokončia krátky obsah výrazne pod sekundu. Tester vstupu porovnáva priemernú medzeru medzi znakmi s prahom 100 ms a výsledok označí ako časovanie, nie ako identifikáciu hardvéru. Prah medzery môže rýchleho pisára, automatické dopĺňanie alebo emulátor pokladať za skener. Skener s oneskorením medzi znakmi, spojením Bluetooth alebo dlhým obsahom môže vyzerať ako písanie. Používajte zachytenú hodnotu a príponu. Časovanie berte ako indíciu.
Tester udalostí klávesnice vypisuje každé keydown a keyup s key, code, modifikátormi a časovými značkami. Použite ho, keď zložený reťazec skrýva kláves predpony alebo kód numerickej klávesnice. Záznam sú udalosti prehliadača. Nie je to surová prevádzka USB.
Časté problémy vo webových aplikáciách
Sken ide do nesprávneho poľa. Vstup klinom sleduje zameranie. Kliknite na cieľové pole po každej navigácii, dialógu alebo validačnej správe, ktorá zameranie presunie. Modálne okno bez textového poľa môže sken prehltnúť ako klávesové skratky.
Skener funguje v textovom editore a nie v prehliadači. Zariadenie píše. Stránka tieto klávesy neprijíma. Skontrolujte zameranie, zakázaný vstup alebo vstup len na čítanie a poslucháča keydown, ktorý na tlačiteľných klávesoch volá preventDefault(). Poslucháč, ktorý spracúva len paste, vstup klinom nikdy neuvidí. Začnite textom Skener čiarových kódov nefunguje, ak žiadna aplikácia znaky nedostáva.
Enter odošle formulár dvakrát alebo opustí stránku. Prehliadač formulár odošle a váš poslucháč Enter tiež spracuje. Zavolajte preventDefault() na jednej z týchto ciest a hodnotu spracujte raz. Viacpoľový formulár sa môže odoslať skôr, než sú neskoršie polia vyplnené, keď skener posiela Enter. Pre tento postup použite Tab, alebo odoslaniu zabráňte, kým formulár nie je kompletný.
Tab mení zameranie. To je kláves Tab. Buď na skeneri nastavte Enter, alebo hodnotu čítajte v keydown a presun zamerania povoľte. Pozrite časť o príponách vyššie.
Rozloženie klávesnice je nesprávne. Číslice môžu prežiť nesúlad, ktorý mení interpunkciu. Naskenujte známu hodnotu so symbolmi, ktoré ukladáte, na rozložení, ktoré pracovisko skutočne používa.
Ten istý sken vytvorí dva záznamy. Hľadajte dvoch poslucháčov na jednom Enter, kým budete hľadať dva fyzické skeny. Potom otestujte zámerný druhý sken a potvrďte pravidlo množstva alebo duplicity, ktoré aplikácia opisuje.
Hodnota chýba alebo je orezaná. Atribút maxlength, vstupná maska alebo preventDefault() na znakových klávesoch môžu obsah zahodiť alebo odrezať. Porovnajte počet znakov v testeri vstupu s hodnotou vo vašom poli. Predpona tiež môže správny obsah nechať vyzerať príliš dlho.
Kódy QR sa nikdy neobjavia. Skener môže byť len 1D, alebo symbologia QR môže byť vypnutá. Aplikácia to neopraví. Hardvér potvrďte pomocou Testovanie QR kódov: ako testovať skenery QR a potom sa vráťte k testu poľa.
Kontrolný zoznam testovania webovej aplikácie
Použite ho na builde, ktorý chcete vydať, v každom prehliadači, ktorý podporujete. Skontrolujte čerstvý profil aj profil s rozšíreniami správcu hesiel a automatického dopĺňania, lebo tieto rozšírenia presúvajú zameranie.
- Skener je pripojený alebo spárovaný a hostiteľ ukazuje, že je pripravený.
- Skener je v režime klávesnicového klinu, nie v sériovom režime ani v režime SDK výrobcu.
- Pole čiarového kódu má zameranie tesne pred skenom.
document.activeElementje toto pole. - Známy čiarový kód príde znak po znaku, vrátane dĺžky.
- Prípona ENTER hodnotu odošle alebo prijme raz a nenechá ukončovaciu klávesu v uloženom reťazci.
- Prípona TAB presunie zameranie na zamýšľaný ovládací prvok a hodnota je prečítaná pred presunom.
- Nastavenie bez prípony nechá hodnotu dostupnú, kým ju aplikácia nedokončí.
- Prázdne odoslanie je odmietnuté alebo ignorované.
- Jeden sken nevytvorí dva záznamy. Druhý skutočný sken sa riadi pravidlom duplicít aplikácie.
- Interpunkcia, symboly a akýkoľvek oddeľovač GS1, ktorý vaše formáty používajú, prejdú cestou tam a späť.
- Rozloženie klávesnice skenera a rozloženie operačného systému dajú znaky vytlačené na štítku.
- Po odpojení a opätovnom pripojení, alebo po výpadku spojenia Bluetooth, ďalší sken pole stále dosiahne.
- Niekoľko skenov za sebou ostane samostatnými hodnotami. Pole ich nespája.
- Rovnaké kontroly prejdú v podporovaných prehliadačoch, s bežnými rozšíreniami automatického dopĺňania aj bez nich.
Pri dialógoch, poradí tabulátora cez celú pokladňu a tokoch množstva v POS pokračujte sprievodcom Ako testovať vstup zo skenera čiarových kódov.
Matica testovacích prípadov
Stĺpec skenera je to, čo robia zariadenie a prehliadač. Stĺpec očakávaného správania je to, čo má aplikácia v odpovedi urobiť. Obchodné pravidlá, napríklad či opakovaný kód produktu zvýši množstvo, patria aplikácii. Uveďte ich v teste a nepredpokladajte jedno pravidlo pre každý produkt.
| Scenár | Očakávané správanie |
|---|---|
| Platný čiarový kód | Aplikácia hodnotu prijme a uloží obsah bez ukončovacej klávesy. |
| Prázdny vstup | Aplikácia ho odmietne alebo ignoruje a záznam nevytvorí. |
| Prípona ENTER | Aplikácia hodnotu odošle alebo prijme raz. |
| Prípona TAB | Zameranie prejde na zamýšľaný ďalší ovládací prvok a hodnota sa zachová. |
| Bez prípony | Vstup ostane dostupný, kým ho aplikácia nespracuje. |
| Rýchle skeny za sebou | Každá hodnota sa spracuje samostatne a nespojí sa s predchádzajúcou. |
| Nesprávne rozloženie klávesnice | Neočakávané znaky sú v zachytenej hodnote viditeľné a kontrolou neprejdú. |
| Duplicitný sken | Aplikácia sa riadi vlastným pravidlom duplicity, napríklad zvýši množstvo alebo odmietne opakovanie. |
| Neplatný formát čiarového kódu | Aplikácia ukáže chybu kontroly pre tento formát a hodnotu neuloží. |
| Stratené zameranie vstupu | Aplikácia si čiarový kód nevymyslí. Sken chýba alebo skončí v ovládacom prvku so zameraním a stránka ostane v bezpečnom stave. |
Riadky platnej hodnoty, prázdneho vstupu, ENTER, TAB a žiadnej prípony prejdite fyzickým skenerom a znova emulátorom. Riadky rozloženia klávesnice, QR a opätovného pripojenia prejdite na hardvéri. Tieto riadky závisia od zariadenia, štítku alebo rozloženia operačného systému, čo simulované stlačenia nereprodukujú.