Barcode Scanner Emulator
Com provar escàners de codis de barres en aplicacions web
Molts escàners de codis de barres USB i Bluetooth envien les dades descodificades com a entrada de teclat, de manera que un camp amb el focus en una aplicació web pot rebre una lectura sense una API de navegador específica de l'escàner. Els ports sèrie i els SDK del fabricant són integracions a part. Podeu provar el camí del teclat amb un escàner físic o amb pulsacions simulades.
Una aplicació web sol veure un escàner de codis de barres com un teclat. La prova és si el control amb el focus rep la càrrega que espera l'aplicació i si la pàgina gestiona el terminador que l'escàner està configurat per enviar. Aquest terminador pot ser Enter, Tab o cap terminador.
Feu servir una sessió del Provador d'entrada de codis de barres quan hi ha un escàner físic connectat. Feu servir el Barcode Scanner Emulator quan necessiteu el mateix camí de teclat durant el desenvolupament i el maquinari no és a la taula. Una passada més àmplia pel focus, la disposició i els fluxos de POS és a Com provar l'entrada d'un escàner de codis de barres. Aquesta guia es queda a l'aplicació del navegador: captura, sufixos, validació i els esdeveniments que realment es poden observar.
Com es comuniquen els escàners de codis de barres amb les aplicacions web
El mode d'interfície decideix què pot rebre la pàgina. Confirmeu-lo abans de canviar el codi del formulari. Un escàner sovint pot canviar de mode llegint un codi de barres de configuració del manual del fabricant.
Falca de teclat USB HID
En el mode de teclat USB HID, l'escàner s'enumera com un teclat. El sistema operatiu carrega el controlador de teclat habitual. Després que l'escàner descodifica un símbol, envia els caràcters com a pulsacions al control que té el focus del teclat. La pàgina escolta aquestes pulsacions o llegeix el text que insereixen. No obre una connexió amb el dispositiu.
Aquest camí és el motiu pel qual un camp de caixa, un quadre de cerca o qualsevol altra entrada de text pot acceptar una lectura amb HTML ordinari. La guia Falca de teclat HID cobreix la seqüència de pulsacions, els prefixos i els sufixos amb més detall.
Bluetooth HID
Un escàner Bluetooth aparellat com a teclat fa servir el mateix camí d'aplicació. L'amfitrió el tracta com un teclat HID i el camp amb el focus rep pulsacions. L'aparellament, la bateria i la ràdio són qüestions del dispositiu. Un cop els caràcters arriben al navegador, la pàgina els gestiona de la mateixa manera que l'entrada de falca USB.
Port sèrie i port COM virtual
Un escàner sèrie, incloent-hi molts modes de port COM virtual per USB, envia el text descodificat com a bytes en un port. El focus no tria la destinació. Ho fa el procés que obre el port. Un camp de text que només escolta pulsacions no veu aquest flux.
Els navegadors basats en Chromium poden obrir un port sèrie mitjançant la Web Serial API després que l'usuari seleccioni el port i concedeixi permís. Firefox i Safari no ofereixen aquesta API. Una prova de falca no exercita una integració sèrie, i una prova sèrie no diu què escriurà un escàner de falca.
Interfícies específiques del fabricant
Alguns dispositius fan servir un SDK del fabricant, OPOS, JPOS o una interfície HID que no és un teclat, com ara USB HID POS. Aquestes interfícies no escriuen al camp amb el focus. Una pàgina web normal no pot carregar un SDK natiu. Chromium pot demanar alguns dispositius HID que no són teclats mitjançant WebHID després d'un gest de l'usuari. Els dispositius HID de la classe teclat continuen bloquejats, de manera que un escàner de falca continua sent indistingible d'un teclat. Tracteu una interfície de fabricant com una integració pròpia i proveu-la amb el programari que obre realment aquesta interfície.
Què pot veure el navegador
Una lectura de falca arriba com a esdeveniments keydown i keyup, i els caràcters imprimibles actualitzen el camp amb el focus. El navegador no rep un nom de dispositiu, un número de sèrie USB ni una marca que digui que l'origen és un escàner. Els navegadors que implementen WebHID continuen refusant les interfícies de teclat, de manera que l'script de la pàgina tampoc no pot llegir els informes HID en brut d'un escàner de falca.
event.key és el caràcter o el nom de la tecla després que el sistema operatiu aplica la disposició de teclat activa. event.code anomena la tecla física, com ara Digit1 o Numpad1, i pot mantenir-se igual quan un desajust de disposició canvia event.key. Cap de les dues propietats identifica el maquinari.
Com provar un escàner de codis de barres físic en un navegador
Executeu això abans de depurar el codi de l'aplicació. Mostra la cadena i el terminador exactes que ha rebut el navegador.
- Connecteu l'escàner i espereu fins que mostri que té alimentació. Per a Bluetooth, acabeu l'aparellament i confirmeu que l'amfitrió fa servir un perfil de teclat.
- Confirmeu el mode d'entrada. La falca de teclat, el teclat USB HID o el teclat Bluetooth HID poden escriure en un camp. Els modes sèrie, SPP i SDK del fabricant no ho fan.
- Obriu el Provador d'entrada de codis de barres.
- Feu clic a Inicieu la prova o feu clic a la zona de lectura. Es torna blava quan està a punt. La pàgina no agafa el focus per si sola.
- Llegiu un codi de barres la càrrega del qual ja coneixeu. Comenceu amb un valor numèric curt i després llegiu un valor que inclogui la puntuació que emmagatzema l'aplicació.
- Llegiu el valor capturat i el nombre de caràcters. Compareu-los tots dos amb la càrrega que espereu, incloent-hi qualsevol prefix que l'escàner insereixi abans de les dades.
- Comproveu el sufix. El provador informa ENTER, TAB o Cap. Amb la Captura automàtica activada, el resultat apareix després d'Enter, Tab o una pausa curta quan les tecles s'aturen. Desactiveu la Captura automàtica quan vulgueu que la captura es mantingui fins que premeu Atureu.
- Compareu aquest resultat amb la cadena que l'aplicació hauria d'emmagatzemar. Un prefix, un caràcter substituït o un terminador absent s'ha de corregir a la configuració de l'escàner o tractar deliberadament a la pàgina. No ho tracteu com una fallada de descodificació fins que aquesta comparació estigui feta.
El provador registra els esdeveniments de teclat que el navegador pot veure. No pot identificar el dispositiu USB ni llegir un port sèrie. Quan un editor de text rep la lectura i el navegador no, continueu amb L'escàner funciona al Notepad però no al POS.
Captura de l'entrada de l'escàner de codis de barres amb JavaScript
L'escàner escriu a l'element que té el focus. Doneu al camp una etiqueta visible, deixeu-lo com una entrada de text normal perquè els usuaris de teclat puguin escriure un codi, i llegiu el valor quan el flux diu que l'entrada és completa. La pàgina de sota ho fa. Enter envia el formulari una vegada. Tab completa un valor no buit i després deixa que el navegador mogui el focus. Una lectura sense terminador es queda al camp fins que algú activa 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>
Deseu el fitxer i obriu-lo en un navegador d'escriptori. Feu clic al camp si el focus s'ha mogut. Un escàner de falca, o l'emulador de la secció següent, escriu llavors a #barcode.
El focus és necessari. Si document.activeElement és el cos del document, un botó o una altra entrada, els escoltadors d'aquest camp no veuen la lectura. Els caràcters cauen al control amb el focus o es perden. Crideu field.focus() quan el flux estigui a punt per a una lectura, també després de tancar un diàleg.
L'entrada buida s'ignora. El formulari es queda al lloc i el text d'estat diu que no s'ha rebut res. L'espai en blanc sol és buit després de trim().
L'exemple no afegeix Enter ni Tab. Si l'escàner no està configurat per enviar-los, el valor es queda al camp i Look up és el camí de finalització. autocomplete="off" redueix la possibilitat que un valor desat substitueixi la lectura. L'etiqueta, el botó i Shift+Tab continuen disponibles, de manera que una persona pot introduir un codi sense escàner.
Gestioneu Enter en un sol lloc. Aquest exemple fa servir l'esdeveniment submit del formulari, que també cobreix el botó Look up i un Enter del teclat. Un segon escoltador keydown per a Enter registraria la mateixa lectura dues vegades. Si l'entrada no és dins d'un formulari, escolteu Enter a keydown i crideu preventDefault() perquè un formulari antecessor no s'enviï també:
field.addEventListener('keydown', (event) => {
if (event.key !== 'Enter') {
return
}
event.preventDefault()
const value = field.value.trim()
if (!value) {
return
}
console.log(value)
field.value = ''
})
Buideu el camp després d'una acceptació correcta perquè la lectura següent no s'afegeixi a la càrrega anterior. Després d'Enter, l'exemple torna a posar el focus al mateix camp perquè aquest flux espera una altra lectura a la mateixa caixa. Després de Tab deixa el focus tranquil perquè el navegador pugui passar al control següent.
Gestió dels sufixos ENTER i TAB
Un sufix és una tecla que l'escàner pot enviar després de la càrrega. És un paràmetre del dispositiu. Enter és habitual i és opcional. La guia Sufixos ENTER i TAB als escàners de codis de barres descriu com distingir els terminadors. Confirmeu el paràmetre a l'escàner que proveu i feu que la pàgina encaixi amb aquest flux.
ENTER
Enter dins d'un camp de text d'una línia envia el formulari que l'envolta als navegadors actuals. Feu-lo servir quan una lectura ha de confirmar el valor, com en un quadre de cerca. preventDefault() a l'esdeveniment submit atura el navegador perquè no navegui fora. Ometeu-lo quan una navegació de pàgina completa és el comportament que voleu.
Si el codi de barres apareix i el formulari no fa res, és possible que l'escàner no enviï cap sufix. A l'escàner de codis de barres li falta ENTER recorre aquesta configuració. Alguns dispositius envien NumPad Enter. event.key continua sent "Enter". Comproveu event.key, no només event.code === "Enter", o aquest escàner semblarà espatllat.
TAB
Tab mou el focus al control següent que es pot enfocar. Això encaixa amb una seqüència com el codi de producte i després la quantitat. Sorprèn un formulari que esperava que Enter l'enviés.
Llegiu el valor a keydown mentre el camp encara té el focus. El navegador mou el focus després d'aquest esdeveniment. Deixeu l'acció per defecte quan el control següent ha de rebre el focus. preventDefault() manté el focus on és, cosa útil quan el valor no és vàlid i voleu que l'operador el vegi. Ignoreu Shift+Tab perquè un usuari de teclat pugui recular pel formulari. Un sufix Tab de l'escàner és Tab sense Shift.
Un sufix Tab també pot moure el focus abans que el codi llegeixi el camp, si l'escoltador és a blur o change i una altra cosa buida el control. Llegiu el valor des de l'objectiu de l'esdeveniment keydown.
Sense sufix
Sense sufix, la càrrega es queda al camp. L'aplicació ha de decidir quan s'ha acabat la lectura. Un botó explícit, un Enter posterior de l'operador o el pas a una altra etapa són punts de finalització fiables. Un temporitzador d'inactivitat pot tractar una pausa en l'escriptura com el final d'una lectura. Aquest temporitzador és una heurística. Un escàner lent, un retard de Bluetooth o una persona que escriu de pressa poden caure al costat equivocat del llindar. Preferiu un sufix configurat quan el flux necessita un senyal clar de final de lectura.
Diferències de configuració
Els escàners de la mateixa marca poden arribar amb sufixos diferents, i un codi de barres de configuració pot canviar el sufix sense cap canvi al JavaScript. Alguns dispositius envien un prefix, un identificador de simbologia com ]C1, o CR i LF. Proveu els tres paràmetres de terminador que els usuaris poden seleccionar de debò: Enter, Tab i cap. Anoteu quin fan servir els escàners desplegats i proveu la pàgina contra aquest paràmetre.
Validació de l'entrada de l'escàner de codis de barres
Valideu la cadena que ha rebut el camp. No suposeu que cada codi de barres té la mateixa llargada, el mateix joc de caràcters o el mateix dígit de control. Les càrregues de Code 128 i QR varien. EAN-13 té 13 dígits. Una aplicació que emmagatzema tots dos necessita regles per a tots dos.
Entrada buida. Rebutgeu-la o ignoreu-la. Un sufix sense càrrega, o un clic a Look up en un camp en blanc, no ha de crear un registre.
Caràcters inesperats. Compareu la cadena rebuda amb una etiqueta coneguda. Un desajust de disposició sovint es veu com un símbol canviat, com un dígit desplaçat o puntuació, mentre la llargada es manté. Els caràcters de control poden venir d'un prefix o d'un separador de grup GS1. Permeteu els caràcters que defineix el vostre format. L'exemple de dalt rebutja els caràcters de control ASCII perquè es vegin al text d'estat. Un analitzador GS1 que espera un separador de grup ha de permetre aquest caràcter i rebutjar la resta.
Llargada. Feu complir les llargades que accepta l'aplicació. Un mínim i un màxim globals són més segurs que una sola llargada obligatòria quan el formulari rep més d'una simbologia. maxlength a l'entrada retalla en silenci una càrrega més llarga, així que poseu-lo només quan cada codi acceptat hi cap.
Prefix. Traieu un prefix només quan heu configurat l'escàner perquè enviï exactament aquest prefix i l'aplicació no l'emmagatzema.
function withoutConfiguredPrefix(value, prefix) {
if (prefix && value.startsWith(prefix)) {
return value.slice(prefix.length)
}
return value
}
Un identificador de simbologia AIM és dada si l'escàner està configurat per transmetre'l. Deixeu-lo al lloc fins que hàgiu decidit si l'aplicació l'emmagatzema.
Sufix. Mantingueu el terminador fora del valor emmagatzemat. Enter i Tab són tecles. No s'insereixen en una entrada de text normal. Una càrrega sèrie encara pot incloure bytes CR o LF. Traieu-los al límit on analitzeu el flux sèrie i proveu que no els traieu del mig d'una càrrega que els conté de manera legítima.
Enviaments duplicats. Una lectura es pot gestionar dues vegades si tant keydown com submit s'executen per al mateix Enter. Feu servir un sol camí de finalització. Una segona lectura del mateix codi és una qüestió diferent. Un formulari de magatzem pot incrementar la quantitat. Un formulari de tiquet pot rebutjar un codi que ja s'ha bescanviat. Poseu aquesta regla a l'aplicació i proveu-la expressament. El navegador no pot distingir una segona estirada del gallet d'un segon escoltador.
Regles de l'aplicació. Els dígits de control pertanyen a simbologies concretes. EAN-13 fa servir l'últim dígit com a dígit de control. Aquesta funció accepta només aquest 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 no fan servir aquest càlcul. L'escàner pot haver comprovat ja la seva simbologia i haver transmès les dades llegibles. Valideu els formats que emmagatzemeu i repetiu la comprovació al servidor. La cadena enviada és entrada d'usuari ordinària. El navegador no pot demostrar que un escàner l'ha produïda.
Prova de l'entrada de l'escàner de codis de barres sense maquinari físic
El Barcode Scanner Emulator és una aplicació d'escriptori per a Windows, macOS i Linux. Introduïu el text a enviar, trieu un retard d'escriptura i trieu un sufix de cap, ENTER o TAB. Una drecera global escriu aquest text a l'aplicació amb el focus. Reprodueix el camí de teclat que fa servir un escàner de falca. No il·lumina una etiqueta, no llegeix un símbol i no descodifica una simbologia.
Feu servir la pàgina d'exemple de dalt, o la pàgina que esteu construint:
- Obriu la pàgina en un navegador d'escriptori i feu clic al camp del codi de barres.
- A l'emulador, introduïu un valor conegut com
123456789012. - Poseu el sufix a ENTER. Poseu el retard d'escriptura si voleu que la ràfega s'assembli a un escàner que ja heu mesurat.
- Premeu la drecera global de lectura de l'emulador mentre el camp del navegador encara té el focus.
- Confirmeu el text d'estat i que el valor s'ha acceptat una vegada.
- Repetiu amb TAB. El focus s'ha de moure i el valor s'ha d'acceptar una vegada.
- Repetiu sense sufix. El text s'ha de quedar al camp fins que activeu Look up.
- Doneu el focus al Provador d'entrada de codis de barres i envieu el mateix valor una altra vegada. Compareu la cadena capturada, el prefix i el sufix amb el que ha emmagatzemat l'aplicació.
La instal·lació i la primera drecera es tracten a Primers passos. Després d'un canvi de paràmetres, envieu una lectura al provador d'entrada abans de confiar en el resultat de l'aplicació.
El maquinari encara cal per a les parts òptiques i específiques del dispositiu de la prova:
- Si aquell escàner pot descodificar el símbol imprès o mostrat, incloent-hi etiquetes malmeses, mida, contrast i distància.
- Suport de simbologia. Un escàner làser 1D no pot llegir un codi QR. Vegeu Proves de codis QR: com provar escàners de codis QR.
- Enumeració USB, aparellament Bluetooth i la configuració pròpia de disposició de teclat i de sufix de l'escàner.
- Integracions sèrie, HID POS i SDK del fabricant.
L'emulador és l'eina adequada per a la lògica de l'aplicació al llarg del camí del teclat. És l'eina inadequada per demostrar que un escàner concret llegeix una etiqueta concreta.
Depuració dels esdeveniments de teclat de l'escàner de codis de barres
Mireu els esdeveniments en aquest ordre quan el valor emmagatzemat és incorrecte.
keydown. Es dispara per a cada tecla, incloent-hi Enter i Tab, abans que el navegador insereixi un caràcter o mogui el focus. Llegiu el terminador aquí. event.repeat és true quan es manté premuda una tecla. Un escàner de falca envia normalment una pulsació distinta per a cada caràcter.
input. Es dispara al camp després que un caràcter imprimible en canvia el valor. És l'esdeveniment adequat si necessiteu el text a mesura que creix. No es dispara per a Enter ni Tab, perquè aquestes tecles no insereixen un caràcter en una entrada de text.
change. Es dispara després que el valor es confirma, normalment quan el camp perd el focus. Un escàner que deixa el focus al mateix camp no produeix change al final de la lectura. No feu servir change com a únic senyal de finalització.
event.key i event.code. Registreu tots dos quan un caràcter és incorrecte. Un desajust entre la disposició de l'escàner i la del sistema operatiu canvia event.key i deixa event.code semblant a la tecla que l'escàner pretenia. Els dígits del teclat numèric fan servir Numpad1 i codis semblants. Algunes màscares d'entrada els tracten de manera diferent de Digit1. Distribució de teclat incorrecta a l'escàner de codis de barres explica el desajust de disposició.
Focus. Registreu document.activeElement just abans d'una lectura. Si no és el camp del codi de barres, la resta del rastre explica el control equivocat. Els iframe tenen el seu propi focus. Una lectura dins d'un marc incrustat és visible per a l'script de dins d'aquest marc.
Temps. Els escàners sovint acaben una càrrega curta en molt menys d'un segon. El provador d'entrada compara el buit mitjà entre caràcters amb un llindar de 100 ms i etiqueta el resultat com a temps, no com una identificació del maquinari. Un llindar de buit pot tractar un mecanògraf ràpid, l'emplenament automàtic o l'emulador com un escàner. Un escàner amb retard entre caràcters, un enllaç Bluetooth o una càrrega llarga pot semblar escriptura. Feu servir el valor capturat i el sufix. Feu servir el temps com a indici.
El Provador d'esdeveniments de teclat llista cada keydown i keyup amb key, code, modificadors i marques de temps. Feu-lo servir quan la cadena muntada amaga una tecla de prefix o un codi de teclat numèric. El registre són esdeveniments del navegador. No és trànsit USB en brut.
Problemes habituals a les aplicacions web
La lectura va al camp equivocat. L'entrada de falca segueix el focus. Feu clic al camp de destinació després de cada navegació, diàleg o missatge de validació que mou el focus. Un modal sense camp de text pot empassar-se la lectura com a tecles de drecera.
L'escàner funciona en un editor de text i no al navegador. El dispositiu escriu. La pàgina no accepta aquestes tecles. Comproveu el focus, una entrada desactivada o de només lectura i un escoltador keydown que crida preventDefault() en tecles imprimibles. Un escoltador que només gestiona paste no veu mai l'entrada de falca. Comenceu per L'escàner de codis de barres no funciona si cap aplicació rep caràcters.
Enter envia el formulari dues vegades o navega fora. El navegador envia el formulari i el vostre escoltador també gestiona Enter. Crideu preventDefault() en un d'aquests camins i processeu el valor una vegada. Un formulari de diversos camps es pot enviar abans que els camps posteriors estiguin plens quan l'escàner envia Enter. Feu servir Tab per a aquest flux o impediu l'enviament fins que el formulari sigui complet.
Tab canvia el focus. Això és la tecla Tab. O bé configureu Enter a l'escàner, o bé llegiu el valor a keydown i permeteu el moviment del focus. Vegeu la secció de sufix de dalt.
La disposició del teclat és incorrecta. Els dígits poden sobreviure a un desajust que canvia la puntuació. Llegiu un valor conegut que contingui els símbols que emmagatzemeu, a la disposició que fa servir realment l'estació de treball.
La mateixa lectura crea dos registres. Busqueu dos escoltadors en un Enter abans de buscar dues lectures físiques. Després proveu una segona lectura deliberada i confirmeu la regla de quantitat o de duplicat que documenta l'aplicació.
El valor falta o està truncat. Un atribut maxlength, una màscara d'entrada o preventDefault() en tecles de caràcter poden deixar caure o tallar la càrrega. Compareu el nombre de caràcters del provador d'entrada amb el valor del vostre camp. Un prefix també pot fer que una càrrega correcta sembli massa llarga.
Els codis QR no apareixen mai. L'escàner pot ser només 1D, o la simbologia QR pot estar desactivada. L'aplicació no ho pot arreglar. Confirmeu el maquinari amb Proves de codis QR: com provar escàners de codis QR i torneu després a la prova del camp.
Llista de comprovació de la prova de l'aplicació web
Feu servir això a la compilació que voleu publicar, a cada navegador que suporteu. Comproveu un perfil nou i també un perfil amb extensions de gestor de contrasenyes i d'emplenament automàtic, perquè aquestes extensions mouen el focus.
- L'escàner està connectat o aparellat, i l'amfitrió el mostra a punt.
- L'escàner és en mode de falca de teclat, no en mode sèrie ni en un mode d'SDK del fabricant.
- El camp del codi de barres té el focus just abans de la lectura.
document.activeElementés aquest camp. - Un codi de barres conegut arriba caràcter per caràcter, incloent-hi la llargada.
- Un sufix ENTER envia o accepta el valor una vegada i no deixa el terminador a la cadena emmagatzemada.
- Un sufix TAB mou el focus al control previst i el valor es llegeix abans del moviment.
- Una configuració sense sufix deixa el valor disponible fins que l'aplicació el completa.
- Un enviament buit es rebutja o s'ignora.
- Una lectura no crea dos registres. Una segona lectura real segueix la regla de duplicat de l'aplicació.
- La puntuació, els símbols i qualsevol separador GS1 que facin servir els vostres formats sobreviuen el viatge d'anada i tornada.
- La disposició de teclat de l'escàner i la del sistema operatiu produeixen els caràcters impresos a l'etiqueta.
- Després de desconnectar i tornar a connectar, o després que caigui l'enllaç Bluetooth, la lectura següent encara arriba al camp.
- Diverses lectures seguides continuen sent valors separats. El camp no les concatena.
- Les mateixes comprovacions passen als navegadors que suporteu, amb extensions habituals d'emplenament automàtic i sense.
Per als diàlegs, l'ordre de tabulació en una caixa sencera i els fluxos de quantitat del POS, continueu amb Com provar l'entrada d'un escàner de codis de barres.
Matriu de casos de prova
La columna de l'escàner és el que fan el dispositiu i el navegador. La columna de comportament esperat és el que ha de fer l'aplicació com a resposta. Les regles de negoci, com ara si un codi de producte repetit incrementa la quantitat, pertanyen a l'aplicació. Indiqueu-les a la prova en comptes de suposar una sola regla per a cada producte.
| Escenari | Comportament esperat |
|---|---|
| Codi de barres vàlid | L'aplicació accepta el valor i emmagatzema la càrrega sense el terminador. |
| Entrada buida | L'aplicació la rebutja o la ignora i no crea cap registre. |
| Sufix ENTER | L'aplicació envia o accepta el valor una vegada. |
| Sufix TAB | El focus es mou al control següent previst i el valor es conserva. |
| Sense sufix | L'entrada continua disponible fins que l'aplicació la processa. |
| Lectures consecutives ràpides | Cada valor es processa per separat i no es concatena amb l'anterior. |
| Disposició de teclat incorrecta | Els caràcters inesperats són visibles al valor capturat i la validació falla. |
| Lectura duplicada | L'aplicació segueix la seva pròpia regla de duplicat, com incrementar la quantitat o rebutjar una repetició. |
| Format de codi de barres no vàlid | L'aplicació mostra l'error de validació d'aquest format i no emmagatzema el valor. |
| Focus d'entrada perdut | L'aplicació no inventa un codi de barres. La lectura és absent o cau al control amb el focus, i la pàgina es queda en un estat segur. |
Executeu les files de vàlid, buit, ENTER, TAB i sense sufix amb l'escàner físic i una altra vegada amb l'emulador. Executeu les files de disposició de teclat, QR i reconnexió al maquinari. Aquestes files depenen del dispositiu, de l'etiqueta o de la disposició del sistema operatiu, que les pulsacions simulades no reprodueixen.