Barcode Scanner Emulator
Sådan tester du stregkodescannere i webapplikationer
Mange USB- og Bluetooth-stregkodescannere sender afkodede data som tastaturinput, så et fokuseret felt i en webapplikation kan modtage en scanning uden et scanner-specifikt browser-API. Serielle porte og leverandør-SDK'er er separate integrationer. Du kan teste tastaturvejen med en fysisk scanner eller med simulerede tastetryk.
En webapplikation opfatter som regel en stregkodescanner som et tastatur. Testen går ud på, om det fokuserede kontrolelement modtager den nyttelast, din applikation forventer, og om siden håndterer den afslutter, scanneren er sat op til at sende. Afslutteren kan være Enter, Tab eller slet ingen.
Brug en session i Stregkodeinput-testeren, når en fysisk scanner er tilsluttet. Brug Barcode Scanner Emulator, når du skal bruge den samme tastaturvej under udvikling, og hardwaren ikke står på bordet. Et bredere gennemløb af fokus, layout og POS-arbejdsgange ligger i Sådan tester du input fra en stregkodescanner. Denne vejledning bliver ved browserapplikationen: indfangning, suffikser, validering og de hændelser, du reelt kan iagttage.
Sådan kommunikerer stregkodescannere med webapplikationer
Grænsefladetilstanden afgør, hvad siden kan modtage. Bekræft den, før du ændrer formularkode. En scanner kan ofte skifte tilstand ved at scanne en konfigurationsstregkode fra producentens manual.
USB HID-tastaturkile
I USB HID-tastaturtilstand opregnes scanneren som et tastatur. Operativsystemet indlæser sin almindelige tastaturdriver. Når scanneren har afkodet et symbol, sender den tegnene som tastetryk til det kontrolelement, der har tastaturfokus. Siden lytter efter de tryk, eller læser den tekst, de indsætter. Den åbner ikke en forbindelse til enheden.
Den vej er grunden til, at et kassefelt, et søgefelt eller et hvilket som helst andet tekstinput kan tage imod en scanning med almindelig HTML. Vejledningen HID-tastaturkile gennemgår tastetrykfølgen, præfikser og suffikser mere udførligt.
Bluetooth HID
En Bluetooth-scanner, der er parret som tastatur, bruger den samme applikationsvej. Værten behandler den som et HID-tastatur, og det fokuserede felt modtager tastetryk. Parring, batteri og radio er enhedens anliggender. Når tegnene først er nået frem til browseren, håndterer siden dem på samme måde som USB-kileinput.
Seriel port og virtuel COM-port
En seriel scanner, herunder mange virtuelle COM-porttilstande over USB, sender den afkodede tekst som byte på en port. Fokus vælger ikke destinationen. Det gør den proces, der åbner porten. Et tekstfelt, der kun lytter efter tastetryk, ser ikke den strøm.
Chromium-baserede browsere kan åbne en seriel port gennem Web Serial API, efter at brugeren har valgt porten og givet tilladelse. Firefox og Safari stiller ikke det API til rådighed. En kiletest øver ikke en seriel integration, og en seriel test fortæller dig ikke, hvad en kile-scanner vil skrive.
Leverandørspecifikke grænseflader
Nogle enheder bruger et leverandør-SDK, OPOS, JPOS eller en HID-grænseflade, der ikke er et tastatur, for eksempel USB HID POS. De grænseflader skriver ikke i det fokuserede felt. En almindelig webside kan ikke indlæse et indbygget SDK. Chromium kan anmode om visse HID-enheder, der ikke er tastaturer, gennem WebHID efter en brugergestus. HID-enheder i tastaturklassen forbliver blokeret, så en kile-scanner kan ikke skelnes fra et tastatur. Behandl en leverandørgrænseflade som sin egen integration, og test den med det program, der faktisk åbner grænsefladen.
Hvad browseren kan se
En kilescanning ankommer som hændelserne keydown og keyup, og tegn, der kan udskrives, opdaterer det fokuserede felt. Browseren modtager ikke et enhedsnavn, et USB-serienummer eller et flag, der siger, at kilden er en scanner. Browsere, der implementerer WebHID, afviser stadig tastaturgrænseflader, så sidescript kan heller ikke læse de rå HID-rapporter fra en kile-scanner.
event.key er tegnet eller tastnavnet, efter at operativsystemet har anvendt det aktive tastaturlayout. event.code navngiver den fysiske tast, for eksempel Digit1 eller Numpad1, og kan blive stående, når et layoutskifte ændrer event.key. Ingen af egenskaberne identificerer hardwaren.
Sådan tester du en fysisk stregkodescanner i en browser
Kør dette, før du fejlsøger applikationskode. Det viser den præcise streng og den afslutter, browseren modtog.
- Tilslut scanneren, og vent, til den viser, at den har strøm. Ved Bluetooth skal du afslutte parringen og bekræfte, at værten bruger en tastaturprofil.
- Bekræft inputtilstanden. Tastaturkile, USB HID-tastatur eller Bluetooth HID-tastatur kan skrive i et felt. Seriel tilstand, SPP og leverandør-SDK kan ikke.
- Åbn Stregkodeinput-testeren.
- Klik på Start test, eller klik i scanningsområdet. Det bliver blåt, når det er klar. Siden tager ikke selv fokus.
- Scan en stregkode, hvis nyttelast du allerede kender. Begynd med en kort numerisk værdi, og scan derefter en værdi, der indeholder den tegnsætning, din applikation gemmer.
- Læs den indfangede værdi og tegnantallet. Sammenlign begge med den nyttelast, du forventer, inklusive et præfiks, som scanneren indsætter før data.
- Kontrollér suffikset. Testeren rapporterer ENTER, TAB eller Ingen. Med Automatisk optagelse slået til vises resultatet efter Enter, Tab eller en kort pause, når tasterne stopper. Slå Automatisk optagelse fra, når du vil holde indfangningen, indtil du trykker på Stop.
- Sammenlign resultatet med den streng, din applikation skal gemme. Et præfiks, et udskiftet tegn eller en manglende afslutter skal rettes i scannerens konfiguration eller håndteres bevidst på siden. Behandl det ikke som en afkodningsfejl, før sammenligningen er gjort.
Testeren registrerer de tastaturhændelser, browseren kan se. Den kan ikke identificere USB-enheden eller læse en seriel port. Når en teksteditor modtager scanningen, og browseren ikke gør, så fortsæt med Scanneren virker i Notepad men ikke i POS.
Indfang scannerinput med JavaScript
En scanner skriver i det element, der har fokus. Giv feltet en synlig etiket, lad det være et almindeligt tekstinput, så tastaturbrugere kan skrive en kode, og læs værdien, når arbejdsgangen siger, at indtastningen er færdig. Siden herunder gør netop det. Enter sender formularen én gang. Tab afslutter en ikke-tom værdi og lader derefter browseren flytte fokus. En scanning uden afslutter bliver i feltet, indtil nogen aktiverer 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>
Gem filen, og åbn den i en skrivebordsbrowser. Klik i feltet, hvis fokus er flyttet. En kile-scanner, eller emulatoren i næste afsnit, skriver derefter i #barcode.
Fokus er nødvendigt. Hvis document.activeElement er dokumentets brødtekst, en knap eller et andet input, ser feltets lyttere ikke scanningen. Tegnene lander i det fokuserede kontrolelement, eller de går tabt. Kald field.focus(), når arbejdsgangen er klar til en scanning, også efter at en dialog er lukket.
Tomt input ignoreres. Formularen bliver stående, og statusteksten siger, at intet blev modtaget. Mellemrum alene er tomt efter trim().
Eksemplet tilføjer ikke Enter eller Tab. Hvis scanneren ikke er sat op til at sende dem, bliver værdien i feltet, og Look up er vejen til afslutning. autocomplete="off" mindsker risikoen for, at en gemt værdi erstatter scanningen. Etiketten, knappen og Shift+Tab er stadig tilgængelige, så en person kan indtaste en kode uden scanner.
Håndtér Enter ét sted. Eksemplet bruger formularens submit-hændelse, som også dækker knappen Look up og Enter fra tastaturet. En anden keydown-lytter for Enter ville registrere den samme scanning to gange. Hvis inputtet ikke ligger i en formular, så lyt efter Enter på keydown, og kald preventDefault(), så en overordnet formular ikke også bliver sendt:
field.addEventListener('keydown', (event) => {
if (event.key !== 'Enter') {
return
}
event.preventDefault()
const value = field.value.trim()
if (!value) {
return
}
console.log(value)
field.value = ''
})
Ryd feltet efter en vellykket accept, så den næste scanning ikke hænges på den forrige nyttelast. Efter Enter fokuserer eksemplet det samme felt igen, fordi den arbejdsgang forventer endnu en scanning i den samme boks. Efter Tab lader det fokus være, så browseren kan gå videre til det næste kontrolelement.
Håndtering af suffikserne ENTER og TAB
Et suffiks er en tast, scanneren kan sende efter nyttelasten. Det er en enhedsindstilling. Enter er almindeligt, og det er valgfrit. Vejledningen ENTER- og TAB-suffikser i stregkodescannere beskriver, hvordan du skelner afslutterne fra hinanden. Bekræft indstillingen på den scanner, du tester, og lad derefter siden følge den arbejdsgang.
ENTER
Enter i et enlinjes tekstfelt sender den omgivende formular i aktuelle browsere. Brug det, når én scanning skal bekræfte værdien, som i et opslagsfelt. preventDefault() på submit-hændelsen standser browseren i at navigere væk. Udelad det, når en fuld sidenavigation er den adfærd, du ønsker.
Hvis stregkoden vises, og formularen ikke gør noget, sender scanneren måske intet suffiks. Stregkodescanneren mangler ENTER gennemgår den konfiguration. Nogle enheder sender NumPad Enter. event.key er stadig "Enter". Kontrollér event.key, ikke kun event.code === "Enter", ellers ser den scanner i stykker ud.
TAB
Tab flytter fokus til det næste kontrolelement, der kan fokuseres. Det passer til en rækkefølge som produktkode og derefter antal. Det overrasker en formular, der forventede, at Enter skulle sende den.
Læs værdien i keydown, mens feltet stadig har fokus. Browseren flytter fokus efter den hændelse. Lad standardhandlingen blive, når det næste kontrolelement skal have fokus. preventDefault() holder fokus, hvor det er, hvilket er nyttigt, når værdien er ugyldig, og operatøren skal se den. Ignorér Shift+Tab, så en tastaturbruger kan bevæge sig baglæns gennem formularen. Et Tab-suffiks fra scanneren er Tab uden Shift.
Et Tab-suffiks kan også flytte fokus, før din kode læser feltet, hvis lytteren sidder på blur eller change, og noget andet rydder kontrolelementet. Læs værdien fra målet for keydown-hændelsen.
Intet suffiks
Uden suffiks ligger nyttelasten i feltet. Applikationen skal afgøre, hvornår scanningen er færdig. En udtrykkelig knap, et senere Enter fra operatøren eller et skridt videre er pålidelige afslutningspunkter. En inaktivitetstimer kan behandle en pause i skrivningen som afslutningen på en scanning. Timeren er en heuristik. En langsom scanner, en Bluetooth-forsinkelse eller en person, der skriver hurtigt, kan lande på den forkerte side af tærsklen. Foretræk et konfigureret suffiks, når arbejdsgangen har brug for et klart signal om scanningens afslutning.
Forskelle i konfiguration
Scannere af samme mærke kan leveres med forskellige suffikser, og en konfigurationsstregkode kan ændre suffikset uden nogen ændring i din JavaScript. Nogle enheder sender et præfiks, en symbologiidentifikator som ]C1 eller CR og LF. Test de tre afslutterindstillinger, dine brugere reelt kan vælge: Enter, Tab og ingen. Notér, hvilken de udrullede scannere bruger, og test siden mod den indstilling.
Validering af input fra stregkodescanner
Validér den streng, feltet modtog. Gå ikke ud fra, at hver stregkode har samme længde, tegnsæt eller kontrolciffer. Nyttelaster i Code 128 og QR varierer. EAN-13 er 13 cifre. En applikation, der gemmer begge, har brug for regler for begge.
Tomt input. Afvis eller ignorér det. Et suffiks uden nyttelast, eller et klik på Look up i et tomt felt, må ikke oprette en post.
Uventede tegn. Sammenlign den modtagne streng med en kendt etiket. Et layoutskifte viser sig ofte som et ændret symbol, for eksempel et forskudt ciffer eller tegnsætning, mens længden er den samme. Styrtegn kan komme fra et præfiks eller fra en GS1-gruppeskilletegn. Tillad de tegn, dit format definerer. Eksemplet ovenfor afviser ASCII-styrtegn, så de bliver synlige i statusteksten. En GS1-fortolker, der forventer et gruppeskilletegn, skal tillade det tegn og afvise resten.
Længde. Håndhæv de længder, din applikation accepterer. Et globalt minimum og maksimum er sikrere end én påkrævet længde, når formularen modtager mere end én symbologi. maxlength på inputtet afkorter lydløst en længere nyttelast, så sæt det kun, når hver accepteret kode passer.
Præfiks. Fjern kun et præfiks, når du har sat scanneren op til at sende netop det præfiks, og applikationen ikke gemmer det.
function withoutConfiguredPrefix(value, prefix) {
if (prefix && value.startsWith(prefix)) {
return value.slice(prefix.length)
}
return value
}
En AIM-symbologiidentifikator er data, hvis scanneren er sat til at sende den. Lad den blive, indtil du har besluttet, om applikationen gemmer den.
Suffiks. Hold afslutteren ude af den gemte værdi. Enter og Tab er taster. De indsættes ikke i et almindeligt tekstinput. En seriel nyttelast kan stadig indeholde CR- eller LF-byte. Fjern dem ved den grænse, hvor du fortolker den serielle strøm, og test, at du ikke fjerner dem fra midten af en nyttelast, der legitimt indeholder dem.
Dobbeltindsendelser. Én scanning kan blive håndteret to gange, hvis både keydown og submit kører for det samme Enter. Brug én afslutningsvej. En anden scanning af den samme kode er et andet spørgsmål. En lagerformular kan forøge antallet. En billetformular kan afvise en kode, der allerede er indløst. Læg den regel i applikationen, og test den med vilje. Browseren kan ikke skelne et andet aftræk fra en anden lytter.
Applikationsregler. Kontrolcifre hører til bestemte symbologier. EAN-13 bruger det sidste ciffer som kontrolciffer. Denne funktion accepterer kun det 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 og QR bruger ikke den beregning. Scanneren kan allerede have kontrolleret sin egen symbologi og sendt den læsbare tekst. Validér de formater, du gemmer, og gentag kontrollen på serveren. Den indsendte streng er almindeligt brugerinput. Browseren kan ikke bevise, at en scanner frembragte den.
Test af scannerinput uden fysisk hardware
Barcode Scanner Emulator er et skrivebordsprogram til Windows, macOS og Linux. Du indtaster den tekst, der skal sendes, vælger en skriveforsinkelse og vælger et suffiks på ingen, ENTER eller TAB. En global genvej skriver den tekst ind i den applikation, der har fokus. Den genskaber den tastaturvej, en kile-scanner bruger. Den oplyser ikke en etiket, læser ikke et symbol og afkoder ikke en symbologi.
Brug eksempelsiden ovenfor, eller den side, du er ved at bygge:
- Åbn siden i en skrivebordsbrowser, og klik i stregkodefeltet.
- Indtast en kendt værdi i emulatoren, for eksempel
123456789012. - Sæt suffikset til ENTER. Sæt skriveforsinkelsen, hvis du vil have, at bygen ligner en scanner, du allerede har målt.
- Tryk på emulatorens globale scanningsgenvej, mens browserfeltet stadig har fokus.
- Bekræft statusteksten, og at værdien blev accepteret én gang.
- Gentag med TAB. Fokus skal flyttes, og værdien skal accepteres én gang.
- Gentag uden suffiks. Teksten skal blive i feltet, indtil du aktiverer Look up.
- Sæt fokus i Stregkodeinput-testeren, og send den samme værdi igen. Sammenlign den indfangede streng, præfikset og suffikset med det, applikationen gemte.
Installation og den første genvej er dækket i Kom godt i gang. Efter en ændring af indstillinger skal du sende én scanning ind i input-testeren, før du stoler på resultatet i applikationen.
Hardware er stadig nødvendig til de optiske og enhedsspecifikke dele af testen:
- Om netop den scanner kan afkode det trykte eller viste symbol, herunder beskadigede etiketter, størrelse, kontrast og afstand.
- Understøttelse af symbologi. En 1D-laserscanner kan ikke læse en QR-kode. Se QR-kodetest: Sådan tester du QR-kodescannere.
- USB-opregning, Bluetooth-parring og scannerens egen tastaturlayout- og suffikskonfiguration.
- Integrationer til seriel, HID POS og leverandør-SDK.
Emulatoren er det rigtige værktøj til applikationslogik langs tastaturvejen. Den er det forkerte værktøj til at bevise, at en bestemt scanner læser en bestemt etiket.
Fejlsøgning af tastaturhændelser fra stregkodescanner
Se på hændelserne i denne rækkefølge, når den gemte værdi er forkert.
keydown. Udløses for hver tast, inklusive Enter og Tab, før browseren indsætter et tegn eller flytter fokus. Læs afslutteren her. event.repeat er true, når en tast holdes nede. En kile-scanner sender normalt et særskilt tryk for hvert tegn.
input. Udløses på feltet, efter at et tegn, der kan udskrives, har ændret dets værdi. Det er den rigtige hændelse at følge, hvis du har brug for teksten, mens den vokser. Den udløses ikke for Enter eller Tab, fordi de taster ikke indsætter et tegn i et tekstinput.
change. Udløses, efter at værdien er bekræftet, typisk når feltet mister fokus. En scanner, der lader fokus blive i det samme felt, frembringer ikke change ved scanningens afslutning. Brug ikke change som det eneste signal om afslutning.
event.key og event.code. Log begge, når et tegn er forkert. Et misforhold mellem scannerens layout og operativsystemets layout ændrer event.key og lader event.code ligne den tast, scanneren mente. Cifre fra det numeriske tastatur bruger Numpad1 og lignende koder. Nogle inputmasker behandler dem anderledes end Digit1. Forkert tastaturlayout på stregkodescanneren forklarer layoutskiftet.
Fokus. Log document.activeElement umiddelbart før en scanning. Hvis det ikke er stregkodefeltet, forklarer resten af sporet det forkerte kontrolelement. Iframes har deres eget fokus. En scanning ind i en indlejret ramme er synlig for script inde i den ramme.
Timing. Scannere afslutter ofte en kort nyttelast på et godt stykke under et sekund. Input-testeren sammenligner det gennemsnitlige mellemrum mellem tegn med en tærskel på 100 ms og mærker resultatet som timing, ikke som en hardwareidentifikation. En mellemrumstærskel kan behandle en hurtig skriver, autofyld eller emulatoren som en scanner. En scanner med forsinkelse mellem tegn, et Bluetooth-link eller en lang nyttelast kan ligne skrivning. Brug den indfangede værdi og suffikset. Brug timingen som et spor.
Tastaturhændelsestesteren oplister hvert keydown og keyup med key, code, modifikatorer og tidsstempler. Brug den, når den sammensatte streng skjuler en præfikstast eller en numerisk kode. Loggen er browserhændelser. Den er ikke rå USB-trafik.
Almindelige problemer i webapplikationer
Scanningen havner i det forkerte felt. Kileinput følger fokus. Klik i målfeltet efter hver navigation, dialog eller valideringsmeddelelse, der flytter fokus. En modal uden tekstfelt kan sluge scanningen som genvejstaster.
Scanneren virker i en teksteditor og ikke i browseren. Enheden skriver. Siden tager ikke imod de taster. Kontrollér fokus, et deaktiveret eller skrivebeskyttet input og en keydown-lytter, der kalder preventDefault() på tegn, der kan udskrives. En lytter, der kun håndterer paste, ser aldrig kileinput. Begynd med Stregkodescanneren virker ikke, hvis ingen applikation modtager tegn.
Enter sender formularen to gange eller navigerer væk. Browseren sender formularen, og din lytter håndterer også Enter. Kald preventDefault() på én af vejene, og behandl værdien én gang. En formular med flere felter kan blive sendt, før senere felter er udfyldt, når scanneren sender Enter. Brug Tab til den arbejdsgang, eller forhindr indsendelsen, indtil formularen er komplet.
Tab skifter fokus. Det er tasten Tab. Enten sæt Enter op på scanneren, eller læs værdien i keydown og tillad fokusflytningen. Se suffiksafsnittet ovenfor.
Tastaturlayoutet er forkert. Cifre kan overleve et skifte, der ændrer tegnsætning. Scan en kendt værdi, der indeholder de symboler, du gemmer, på det layout, arbejdsstationen faktisk bruger.
Den samme scanning opretter to poster. Led efter to lyttere på ét Enter, før du leder efter to fysiske scanninger. Test derefter en bevidst anden scanning, og bekræft den antal- eller dubletregel, din applikation dokumenterer.
Værdien mangler eller er afkortet. En maxlength-attribut, en inputmaske eller preventDefault() på tegntaster kan tabe eller klippe nyttelasten. Sammenlign tegnantallet i input-testeren med værdien i dit felt. Et præfiks kan også få en korrekt nyttelast til at se for lang ud.
QR-koder dukker aldrig op. Scanneren kan være kun 1D, eller QR-symbologien kan være slået fra. Applikationen kan ikke rette det. Bekræft hardwaren med QR-kodetest: Sådan tester du QR-kodescannere, og vend derefter tilbage til felttesten.
Tjekliste til test af webapplikationen
Brug den på det build, du har tænkt dig at udgive, i hver browser, du understøtter. Kontrollér både en frisk profil og en profil med udvidelser til adgangskodehåndtering og autofyld, fordi de udvidelser flytter fokus.
- Scanneren er tilsluttet eller parret, og værten viser, at den er klar.
- Scanneren er i tastaturkile-tilstand, ikke i seriel tilstand eller en leverandør-SDK-tilstand.
- Stregkodefeltet er fokuseret umiddelbart før scanningen.
document.activeElementer det felt. - En kendt stregkode ankommer tegn for tegn, inklusive længde.
- Et ENTER-suffiks sender eller accepterer værdien én gang og efterlader ikke afslutteren i den gemte streng.
- Et TAB-suffiks flytter fokus til det kontrolelement, du har tænkt dig, og værdien læses før flytningen.
- En konfiguration uden suffiks lader værdien være tilgængelig, indtil applikationen afslutter den.
- En tom indsendelse afvises eller ignoreres.
- Én scanning opretter ikke to poster. En anden rigtig scanning følger applikationens dubletregel.
- Tegnsætning, symboler og et eventuelt GS1-skilletegn, dine formater bruger, overlever turen frem og tilbage.
- Scannerens tastaturlayout og operativsystemets layout frembringer de tegn, der er trykt på etiketten.
- Efter frakobling og gentilslutning, eller efter at Bluetooth-forbindelsen falder, når den næste scanning stadig feltet.
- Flere scanninger i træk forbliver særskilte værdier. Feltet kæder dem ikke sammen.
- De samme kontroller består i de browsere, du understøtter, med og uden almindelige autofyld-udvidelser.
For dialoger, tabulatorrækkefølge på tværs af en hel kasse og POS-flows for antal, fortsæt med Sådan tester du input fra en stregkodescanner.
Matrix over testtilfælde
Scannerkolonnen er det, enheden og browseren gør. Kolonnen med forventet adfærd er det, applikationen skal gøre som svar. Forretningsregler, for eksempel om en gentagen produktkode forøger antallet, hører til applikationen. Angiv dem i testen i stedet for at antage én regel for hvert produkt.
| Scenarie | Forventet adfærd |
|---|---|
| Gyldig stregkode | Applikationen accepterer værdien og gemmer nyttelasten uden afslutteren. |
| Tomt input | Applikationen afviser eller ignorerer det og opretter ingen post. |
| ENTER-suffiks | Applikationen sender eller accepterer værdien én gang. |
| TAB-suffiks | Fokus flyttes til det tilsigtede næste kontrolelement, og værdien beholdes. |
| Intet suffiks | Inputtet forbliver tilgængeligt, indtil applikationen behandler det. |
| Hurtige scanninger i træk | Hver værdi behandles for sig og kædes ikke sammen med den foregående. |
| Forkert tastaturlayout | Uventede tegn er synlige i den indfangede værdi, og valideringen fejler. |
| Dobbelt scanning | Applikationen følger sin egen dubletregel, for eksempel at forøge antallet eller afvise en gentagelse. |
| Ugyldigt stregkodeformat | Applikationen viser valideringsfejlen for det format og gemmer ikke værdien. |
| Mistet inputfokus | Applikationen opfinder ikke en stregkode. Scanningen mangler eller lander i det fokuserede kontrolelement, og siden bliver i en sikker tilstand. |
Kør rækkerne for gyldig, tom, ENTER, TAB og intet suffiks med den fysiske scanner og igen med emulatoren. Kør rækkerne for tastaturlayout, QR og gentilslutning på hardwaren. De rækker afhænger af enheden, etiketten eller operativsystemets layout, som simulerede tastetryk ikke genskaber.