Barcode Scanner Emulator
Cum se testează scanerele de coduri de bare în aplicațiile web
Multe scanere de coduri de bare USB și Bluetooth trimit datele decodificate ca introducere de la tastatură, așa că un câmp focalizat dintr-o aplicație web poate primi o scanare fără un API de browser dedicat scanerului. Porturile seriale și SDK-urile producătorului sunt integrări separate. Calea de tastatură se poate verifica cu un scaner fizic sau cu apăsări simulate.
O aplicație web vede de obicei un scaner de coduri de bare ca pe o tastatură. Testul este dacă controlul focalizat primește conținutul pe care îl așteaptă aplicația și dacă pagina tratează tasta de încheiere pe care scanerul este configurat să o trimită. Aceasta poate fi Enter, Tab sau nimic.
Folosiți o sesiune a testerului de introducere a codurilor de bare când este conectat un scaner fizic. Folosiți Barcode Scanner Emulator când aveți nevoie de aceeași cale de tastatură în timpul dezvoltării și dispozitivul nu este pe birou. O trecere mai largă peste focalizare, dispunere și fluxuri POS este în Cum se testează introducerea de la scanerul de coduri de bare. Acest ghid rămâne la aplicația din browser: captură, sufixe, validare și evenimentele pe care le puteți observa cu adevărat.
Cum comunică scanerele de coduri de bare cu aplicațiile web
Modul interfeței decide ce poate primi pagina. Confirmați-l înainte să schimbați codul formularului. Un scaner poate schimba adesea modurile prin scanarea unui cod de bare de configurare din manualul producătorului.
Pană de tastatură USB HID
În modul tastatură USB HID scanerul se enumeră ca tastatură. Sistemul de operare încarcă driverul obișnuit de tastatură. După ce decodează un simbol, scanerul trimite caracterele ca apăsări către controlul care are focalizarea tastaturii. Pagina ascultă acele apăsări sau citește textul pe care îl inserează. Nu deschide o conexiune către dispozitiv.
De aceea un câmp de casă, o casetă de căutare sau orice alt câmp de text poate accepta o scanare cu HTML obișnuit. Ghidul Pană de tastatură HID descrie mai pe larg succesiunea apăsărilor, prefixele și sufixele.
Bluetooth HID
Un scaner Bluetooth împerecheat ca tastatură folosește aceeași cale în aplicație. Gazda îl tratează ca pe o tastatură HID, iar câmpul focalizat primește apăsări. Împerecherea, bateria și radioul sunt grija dispozitivului. Odată ce caracterele ajung în browser, pagina le tratează la fel ca introducerea de la pana USB.
Port serial și COM virtual
Un scaner serial, inclusiv multe moduri de port COM virtual prin USB, trimite textul decodificat ca octeți pe un port. Focalizarea nu alege destinația. O alege procesul care deschide portul. Un câmp de text care ascultă doar apăsări nu va vedea acel flux.
Browserele bazate pe Chromium pot deschide un port serial prin Web Serial API după ce utilizatorul selectează portul și acordă permisiunea. Firefox și Safari nu oferă acel API. Un test de pană nu exersează o integrare serială, iar un test serial nu spune ce va tasta un scaner pană.
Interfețe specifice producătorului
Unele dispozitive folosesc un SDK de producător, OPOS, JPOS sau o interfață HID care nu este tastatură, cum ar fi USB HID POS. Aceste interfețe nu tastează în câmpul focalizat. O pagină web obișnuită nu poate încărca un SDK nativ. Chromium poate cere unele dispozitive HID care nu sunt tastaturi prin WebHID după un gest al utilizatorului. Dispozitivele HID din clasa tastatură rămân blocate, așa că un scaner pană rămâne de nedistins de o tastatură. Tratați o interfață de producător ca pe o integrare proprie și testați-o cu software-ul care deschide de fapt acea interfață.
Ce poate vedea browserul
O scanare pană sosește ca evenimente keydown și keyup, iar caracterele tipăribile actualizează câmpul focalizat. Browserul nu primește un nume de dispozitiv, un număr de serie USB sau un indicator care să spună „scaner”. Browserele care implementează WebHID refuză în continuare interfețele de tastatură, așa că scriptul paginii nu poate citi nici rapoartele HID brute ale unui scaner pană.
event.key este caracterul sau numele tastei după ce sistemul de operare aplică dispunerea activă a tastaturii. event.code numește tasta fizică, cum ar fi Digit1 sau Numpad1, și poate rămâne același când o nepotrivire de dispunere schimbă event.key. Niciuna dintre proprietăți nu identifică hardware-ul.
Cum se testează un scaner fizic de coduri de bare în browser
Faceți asta înainte să depanați codul aplicației. Arată șirul exact și tasta de încheiere pe care le-a primit browserul.
- Conectați scanerul și așteptați până arată că are alimentare. Pentru Bluetooth, terminați împerecherea și confirmați că gazda folosește un profil de tastatură.
- Confirmați modul de introducere. Pana de tastatură, tastatura USB HID sau tastatura Bluetooth HID pot tasta într-un câmp. Modurile Serial, SPP și SDK de producător nu pot.
- Deschideți testerul de introducere a codurilor de bare.
- Faceți clic pe Pornește testul sau faceți clic pe zona de scanare. Devine albastră când este gata. Pagina nu ia focalizarea de una singură.
- Scanați un cod de bare al cărui conținut îl cunoașteți deja. Începeți cu o valoare numerică scurtă, apoi scanați o valoare care include punctuația pe care o stochează aplicația.
- Citiți valoarea capturată și numărul de caractere. Comparați-le pe ambele cu conținutul pe care îl așteptați, inclusiv orice prefix pe care scanerul îl inserează înaintea datelor.
- Verificați sufixul. Testerul raportează ENTER, TAB sau Niciunul. Cu Captură automată pornită, rezultatul apare după Enter, Tab sau o pauză scurtă, odată ce tastele se opresc. Opriți Captură automată când vreți ca captura să fie ținută până apăsați Oprește.
- Comparați acel rezultat cu șirul pe care aplicația ar trebui să îl stocheze. Un prefix, un caracter înlocuit sau o tastă de încheiere lipsă trebuie corectate în configurația scanerului sau tratate în mod deliberat în pagină. Nu tratați asta ca pe un eșec de decodare până când comparația este făcută.
Testerul înregistrează evenimentele de tastatură pe care browserul le poate vedea. Nu poate identifica dispozitivul USB și nu poate citi un port serial. Când un editor de text primește scanarea, iar browserul nu, continuați cu Scanerul funcționează în Notepad, dar nu în POS.
Capturarea introducerii de la scanerul de coduri de bare cu JavaScript
Scanerul tastează în elementul care are focalizarea. Dați câmpului o etichetă vizibilă, lăsați-l ca intrare de text obișnuită ca un utilizator de tastatură să poată tasta un cod și citiți valoarea când fluxul spune că introducerea este completă. Pagina de mai jos face asta. Enter trimite formularul o dată. Tab încheie o valoare care nu este goală și apoi lasă browserul să mute focalizarea. O scanare fără tastă de încheiere rămâne în câmp până când cineva activează butonul 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>
Salvați fișierul și deschideți-l într-un browser de desktop. Faceți clic pe câmp dacă focalizarea s-a mutat. Un scaner pană, sau emulatorul din secțiunea următoare, tastează apoi în #barcode.
Focalizarea este necesară. Dacă document.activeElement este corpul documentului, un buton sau o altă intrare, ascultătorii acestui câmp nu văd scanarea. Caracterele ajung în controlul focalizat sau se pierd. Apelați field.focus() când fluxul este gata pentru o scanare, inclusiv după ce se închide un dialog.
Introducerea goală este ignorată. Formularul rămâne pe loc, iar textul de stare spune că nu s-a primit nimic. Doar spațiile albe sunt goale după trim().
Exemplul nu adaugă Enter sau Tab. Dacă scanerul nu este configurat să le trimită, valoarea rămâne în câmp, iar butonul Look up este calea de încheiere. autocomplete="off" reduce șansa ca o valoare salvată să înlocuiască scanarea. Eticheta, butonul și Shift+Tab rămân disponibile, așa că o persoană poate introduce un cod fără scaner.
Tratați Enter într-un singur loc. Acest exemplu folosește evenimentul submit al formularului, care acoperă și butonul Look up, și Enter de la tastatură. Un al doilea ascultător keydown pentru Enter ar înregistra aceeași scanare de două ori. Dacă intrarea nu este într-un formular, ascultați Enter pe keydown și apelați preventDefault() ca un formular strămoș să nu se trimită și el:
field.addEventListener('keydown', (event) => {
if (event.key !== 'Enter') {
return
}
event.preventDefault()
const value = field.value.trim()
if (!value) {
return
}
console.log(value)
field.value = ''
})
Goliți câmpul după o acceptare reușită, ca scanarea următoare să nu se adauge la conținutul anterior. După Enter, exemplul focalizează din nou același câmp, pentru că acel flux așteaptă încă o scanare în aceeași casetă. După Tab lasă focalizarea în pace, ca browserul să poată trece la controlul următor.
Tratarea sufixelor ENTER și TAB
Un sufix este o tastă pe care scanerul o poate trimite după conținut. Este o setare a dispozitivului. Enter este frecvent și este opțional. Ghidul Sufixe ENTER și TAB la scanerele de coduri de bare descrie cum se deosebesc tastele de încheiere. Confirmați setarea pe scanerul pe care îl testați, apoi faceți pagina să urmeze acel flux.
ENTER
Enter într-un câmp de text pe un rând trimite formularul care îl cuprinde în browserele actuale. Folosiți asta când o scanare trebuie să confirme valoarea, ca într-o casetă de căutare. preventDefault() pe evenimentul submit oprește browserul din a părăsi pagina. Omiteți-l când o navigare de pagină completă este comportamentul dorit.
Dacă codul de bare apare și formularul nu face nimic, scanerul poate să nu trimită niciun sufix. Scanerului de coduri de bare îi lipsește ENTER parcurge acea configurație. Unele dispozitive trimit NumPad Enter. event.key este tot "Enter". Verificați event.key, nu doar event.code === "Enter", altfel acel scaner va părea stricat.
TAB
Tab mută focalizarea la următorul control care o poate primi. Se potrivește unei secvențe cum ar fi cod de produs, apoi cantitate. Surprinde un formular care aștepta ca Enter să îl trimită.
Citiți valoarea în keydown cât timp câmpul încă are focalizarea. Browserul mută focalizarea după acel eveniment. Lăsați acțiunea implicită când controlul următor trebuie să primească focalizarea. preventDefault() ține focalizarea pe loc, ceea ce este util când valoarea este nevalidă și vreți ca operatorul să o vadă. Ignorați Shift+Tab, ca un utilizator de tastatură să poată merge înapoi prin formular. Un sufix Tab al scanerului este Tab fără Shift.
Un sufix Tab poate muta focalizarea și înainte ca codul să citească câmpul, dacă ascultătorul este pe blur sau change și altceva golește controlul. Citiți valoarea din target al evenimentului keydown.
Fără sufix
Fără sufix, conținutul stă în câmp. Aplicația trebuie să decidă când s-a terminat scanarea. Un buton explicit, un Enter ulterior de la operator sau trecerea la un alt pas sunt puncte de încheiere de încredere. Un temporizator de inactivitate poate trata o pauză în tastare ca sfârșitul unei scanări. Acel temporizator este o euristică. Un scaner lent, o întârziere Bluetooth sau o persoană care tastează repede pot cădea de partea greșită a pragului. Preferați un sufix configurat când fluxul are nevoie de un semnal ferm de sfârșit de scanare.
Diferențe de configurație
Scanere de aceeași marcă pot pleca din fabrică cu sufixe diferite, iar un cod de bare de configurare poate schimba sufixul fără nicio schimbare în JavaScript. Unele dispozitive trimit un prefix, un identificator de simbologie cum ar fi ]C1, sau CR și LF. Testați cele trei setări de încheiere pe care utilizatorii le pot alege cu adevărat: Enter, Tab și niciunul. Notați pe care o folosesc scanerele instalate și testați pagina față de acea setare.
Validarea introducerii de la scanerul de coduri de bare
Validați șirul pe care l-a primit câmpul. Nu presupuneți că fiecare cod de bare are aceeași lungime, același set de caractere sau aceeași sumă de control. Conținuturile Code 128 și QR variază. EAN-13 are 13 cifre. O aplicație care le stochează pe ambele are nevoie de reguli pentru ambele.
Introducere goală. Respingeți-o sau ignorați-o. Un sufix fără conținut sau un clic pe Look up într-un câmp gol nu trebuie să creeze o înregistrare.
Caractere neașteptate. Comparați șirul primit cu o etichetă cunoscută. O nepotrivire de dispunere apare adesea ca un simbol schimbat, cum ar fi o cifră deplasată sau punctuație, în timp ce lungimea rămâne aceeași. Caracterele de control pot veni dintr-un prefix sau dintr-un separator de grup GS1. Permiteți caracterele pe care le definește formatul vostru. Exemplul de mai sus respinge caracterele de control ASCII, ca să rămână vizibile în textul de stare. Un parser GS1 care așteaptă un separator de grup trebuie să permită acel caracter și să le respingă pe celelalte.
Lungime. Impuneți lungimile pe care le acceptă aplicația. Un minim și un maxim globale sunt mai sigure decât o singură lungime obligatorie când formularul primește mai mult de o simbologie. maxlength pe intrare trunchiază în tăcere un conținut mai lung, așa că setați-l doar când fiecare cod acceptat încape.
Prefix. Eliminați un prefix doar când ați configurat scanerul să trimită exact acel prefix și aplicația nu îl stochează.
function withoutConfiguredPrefix(value, prefix) {
if (prefix && value.startsWith(prefix)) {
return value.slice(prefix.length)
}
return value
}
Un identificator de simbologie AIM este date dacă scanerul este setat să îl transmită. Lăsați-l pe loc până decideți dacă aplicația îl stochează.
Sufix. Țineți tasta de încheiere în afara valorii stocate. Enter și Tab sunt taste. Nu sunt inserate într-o intrare de text obișnuită. Un conținut serial poate include în continuare octeți CR sau LF. Eliminați-i la granița unde parsați fluxul serial și verificați că nu îi eliminați din mijlocul unui conținut care îi conține în mod legitim.
Trimiteri duplicate. O scanare poate fi tratată de două ori dacă atât keydown, cât și submit rulează pentru același Enter. Folosiți o singură cale de încheiere. O a doua scanare a aceluiași cod este o altă întrebare. Un formular de depozit poate crește cantitatea. Un formular de bilet poate respinge un cod deja folosit. Puneți acea regulă în aplicație și testați-o intenționat. Browserul nu poate deosebi o a doua apăsare a trăgaciului de un al doilea ascultător.
Reguli ale aplicației. Sumele de control aparțin unor simbologii anume. EAN-13 folosește ultima cifră ca cifră de control. Această funcție acceptă doar acel format:
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 și QR nu folosesc acel calcul. Scanerul poate să își fi verificat deja propria simbologie și să fi transmis datele lizibile de om. Validați formatele pe care le stocați și repetați verificarea pe server. Șirul trimis este introducere obișnuită de utilizator. Browserul nu poate dovedi că l-a produs un scaner.
Testarea introducerii de la scanerul de coduri de bare fără hardware fizic
Barcode Scanner Emulator este o aplicație desktop pentru Windows, macOS și Linux. Introduceți textul de trimis, alegeți o întârziere de tastare și un sufix: niciunul, ENTER sau TAB. O scurtătură globală tastează acel text în aplicația focalizată. Reproduce calea de tastatură pe care o folosește un scaner pană. Nu luminează o etichetă, nu citește un simbol și nu decodează o simbologie.
Folosiți pagina exemplu de mai sus sau pagina pe care o construiți:
- Deschideți pagina într-un browser de desktop și faceți clic pe câmpul codului de bare.
- În emulator, introduceți o valoare cunoscută, cum ar fi
123456789012. - Setați sufixul la ENTER. Setați întârzierea de tastare dacă vreți ca rafala să semene cu un scaner pe care l-ați măsurat deja.
- Apăsați scurtătura globală de scanare a emulatorului cât timp câmpul din browser încă are focalizarea.
- Confirmați textul de stare și că valoarea a fost acceptată o dată.
- Repetați cu TAB. Focalizarea trebuie să se mute, iar valoarea trebuie acceptată o dată.
- Repetați fără sufix. Textul trebuie să rămână în câmp până activați Look up.
- Focalizați testerul de introducere a codurilor de bare și trimiteți aceeași valoare din nou. Comparați șirul capturat, prefixul și sufixul cu ceea ce a stocat aplicația.
Instalarea și prima scurtătură sunt acoperite în Primii pași. După o schimbare de setări, trimiteți o scanare în testerul de introducere înainte să vă bazați pe rezultat în aplicație.
Hardware-ul este în continuare necesar pentru partea optică și pentru partea testului care ține de dispozitiv:
- Dacă acel scaner poate decodifica simbolul tipărit sau afișat, inclusiv etichete deteriorate, dimensiune, contrast și distanță.
- Suportul de simbologii. Un scaner laser 1D nu poate citi un cod QR. Vedeți Testarea codurilor QR: cum se testează scanerele de coduri QR.
- Enumerarea USB, împerecherea Bluetooth și configurația proprie a scanerului pentru dispunerea tastaturii și sufix.
- Integrările Serial, HID POS și SDK de producător.
Emulatorul este instrumentul potrivit pentru logica aplicației de-a lungul căii de tastatură. Nu este instrumentul potrivit ca să dovediți că un anumit scaner citește o anumită etichetă.
Depanarea evenimentelor de tastatură ale scanerului de coduri de bare
Urmăriți evenimentele în această ordine când valoarea stocată este greșită.
keydown. Se declanșează pentru fiecare tastă, inclusiv Enter și Tab, înainte ca browserul să insereze un caracter sau să mute focalizarea. Citiți aici tasta de încheiere. event.repeat este adevărat când o tastă este ținută apăsată. Un scaner pană trimite în mod normal o apăsare distinctă pentru fiecare caracter.
input. Se declanșează pe câmp după ce un caracter tipăribil îi schimbă valoarea. Este evenimentul potrivit dacă aveți nevoie de text pe măsură ce crește. Nu se declanșează pentru Enter sau Tab, pentru că acele taste nu inserează un caracter într-o intrare de text.
change. Se declanșează după ce valoarea se confirmă, de obicei când câmpul pierde focalizarea. Un scaner care lasă focalizarea în același câmp nu va produce change la sfârșitul scanării. Nu folosiți change ca unic semnal de încheiere.
event.key și event.code. Înregistrați-le pe ambele când un caracter este greșit. O nepotrivire între dispunerea scanerului și dispunerea sistemului de operare schimbă event.key și lasă event.code să arate ca tasta pe care scanerul a intenționat-o. Cifrele de pe tastatura numerică folosesc Numpad1 și coduri asemănătoare. Unele măști de introducere le tratează altfel decât pe Digit1. Dispunere greșită a tastaturii scanerului de coduri de bare explică nepotrivirea de dispunere.
Focalizare. Înregistrați document.activeElement imediat înainte de o scanare. Dacă nu este câmpul codului de bare, restul urmei explică controlul greșit. Iframe-urile au propria focalizare. O scanare într-un cadru încorporat este vizibilă pentru scriptul din acel cadru.
Timp. Scanerele termină adesea un conținut scurt cu mult sub o secundă. Testerul de introducere compară intervalul mediu dintre caractere cu un prag de 100 ms și etichetează rezultatul ca timp, nu ca identificare de hardware. Un prag de interval poate trata un tastator rapid, completarea automată sau emulatorul ca pe un scaner. Un scaner cu întârziere între caractere, o legătură Bluetooth sau un conținut lung poate arăta ca tastare. Folosiți valoarea capturată și sufixul. Folosiți timpul ca indiciu.
Testerul de evenimente de tastatură listează fiecare keydown și keyup cu key, code, modificatori și marcaje de timp. Folosiți-l când șirul asamblat ascunde o tastă de prefix sau un cod de la tastatura numerică. Jurnalul este evenimente de browser. Nu este trafic USB brut.
Probleme frecvente în aplicațiile web
Scanarea ajunge în câmpul greșit. Introducerea pană urmează focalizarea. Faceți clic pe câmpul țintă după fiecare navigare, dialog sau mesaj de validare care mută focalizarea. Un modal fără câmp de text poate înghiți scanarea ca scurtături de taste.
Scanerul funcționează într-un editor de text și nu în browser. Dispozitivul tastează. Pagina nu acceptă acele taste. Verificați focalizarea, o intrare dezactivată sau doar pentru citire și un ascultător keydown care apelează preventDefault() pe taste tipăribile. Un ascultător care tratează doar paste nu vede niciodată introducerea pană. Începeți cu Scanerul de coduri de bare nu funcționează dacă nicio aplicație nu primește caractere.
Enter trimite formularul de două ori sau părăsește pagina. Browserul trimite formularul, iar ascultătorul vostru tratează și el Enter. Apelați preventDefault() pe una dintre acele căi și procesați valoarea o dată. Un formular cu mai multe câmpuri se poate trimite înainte ca câmpurile ulterioare să fie completate, când scanerul trimite Enter. Folosiți Tab pentru acel flux sau împiedicați trimiterea până când formularul este complet.
Tab schimbă focalizarea. Aceasta este tasta Tab. Fie configurați Enter pe scaner, fie citiți valoarea în keydown și permiteți mutarea focalizării. Vedeți secțiunea despre sufixe de mai sus.
Dispunerea tastaturii este greșită. Cifrele pot supraviețui unei nepotriviri care schimbă punctuația. Scanați o valoare cunoscută care conține simbolurile pe care le stocați, pe dispunerea pe care stația de lucru o folosește de fapt.
Aceeași scanare creează două înregistrări. Căutați doi ascultători pe un singur Enter înainte să căutați două scanări fizice. Apoi testați o a doua scanare intenționată și confirmați regula de cantitate sau de duplicat pe care o documentează aplicația.
Valoarea lipsește sau este trunchiată. Un atribut maxlength, o mască de introducere sau preventDefault() pe tastele de caracter pot scăpa sau tăia conținutul. Comparați numărul de caractere din testerul de introducere cu valoarea din câmpul vostru. Un prefix poate face și un conținut corect să pară prea lung.
Codurile QR nu apar niciodată. Scanerul poate fi doar 1D sau simbologia QR poate fi dezactivată. Aplicația nu poate repara asta. Confirmați hardware-ul cu Testarea codurilor QR: cum se testează scanerele de coduri QR, apoi reveniți la testul câmpului.
Listă de verificare pentru testarea aplicației web
Folosiți-o pe buildul pe care intenționați să îl livrați, în fiecare browser pe care îl susțineți. Verificați și un profil proaspăt, și un profil cu extensii de manager de parole și de completare automată, pentru că acele extensii mută focalizarea.
- Scanerul este conectat sau împerecheat, iar gazda îl arată gata.
- Scanerul este în modul pană de tastatură, nu în mod serial sau în modul SDK de producător.
- Câmpul codului de bare este focalizat imediat înainte de scanare.
document.activeElementeste acel câmp. - Un cod de bare cunoscut sosește caracter cu caracter, inclusiv lungimea.
- Un sufix ENTER trimite sau acceptă valoarea o dată și nu lasă tasta de încheiere în șirul stocat.
- Un sufix TAB mută focalizarea la controlul intenționat, iar valoarea este citită înainte de mutare.
- O configurație fără sufix lasă valoarea disponibilă până când aplicația o încheie.
- O trimitere goală este respinsă sau ignorată.
- O scanare nu creează două înregistrări. O a doua scanare reală urmează regula de duplicat a aplicației.
- Punctuația, simbolurile și orice separator GS1 pe care îl folosesc formatele voastre supraviețuiesc drumului dus-întors.
- Dispunerea tastaturii scanerului și dispunerea sistemului de operare produc caracterele tipărite pe etichetă.
- După deconectare și reconectare, sau după ce legătura Bluetooth cade, scanarea următoare tot ajunge la câmp.
- Mai multe scanări la rând rămân valori separate. Câmpul nu le concatenează.
- Aceleași verificări trec în browserele pe care le susțineți, cu și fără extensii obișnuite de completare automată.
Pentru dialoguri, ordinea de tabulare pe o casă întreagă și fluxurile de cantitate din POS, continuați cu Cum se testează introducerea de la scanerul de coduri de bare.
Matrice de cazuri de test
Coloana scanerului este ceea ce fac dispozitivul și browserul. Coloana de comportament așteptat este ceea ce trebuie să facă aplicația ca răspuns. Regulile de business, cum ar fi dacă un cod de produs repetat crește cantitatea, aparțin aplicației. Enunțați-le în test, în loc să presupuneți o singură regulă pentru fiecare produs.
| Scenariu | Comportament așteptat |
|---|---|
| Cod de bare valid | Aplicația acceptă valoarea și stochează conținutul fără tasta de încheiere. |
| Introducere goală | Aplicația o respinge sau o ignoră și nu creează o înregistrare. |
| Sufix ENTER | Aplicația trimite sau acceptă valoarea o dată. |
| Sufix TAB | Focalizarea se mută la următorul control intenționat, iar valoarea este păstrată. |
| Fără sufix | Introducerea rămâne disponibilă până când aplicația o prelucrează. |
| Scanări rapide consecutive | Fiecare valoare este prelucrată separat și nu este concatenată cu cea anterioară. |
| Dispunere greșită a tastaturii | Caracterele neașteptate sunt vizibile în valoarea capturată și nu trec validarea. |
| Scanare duplicată | Aplicația urmează propria regulă de duplicat, cum ar fi creșterea cantității sau respingerea unei reluări. |
| Format nevalid de cod de bare | Aplicația arată eroarea de validare pentru acel format și nu stochează valoarea. |
| Focalizare de introducere pierdută | Aplicația nu inventează un cod de bare. Scanarea lipsește sau ajunge în controlul focalizat, iar pagina rămâne într-o stare sigură. |
Rulați rândurile pentru valoare validă, introducere goală, ENTER, TAB și fără sufix cu scanerul fizic și din nou cu emulatorul. Rulați rândurile de dispunere a tastaturii, QR și reconectare pe hardware. Acele rânduri depind de dispozitiv, de etichetă sau de dispunerea sistemului de operare, pe care apăsările simulate nu le reproduc.