Barcode Scanner Emulator
Barcodescanners testen in webtoepassingen
Veel USB- en Bluetooth-barcodescanners sturen gedecodeerde gegevens als toetsenbordinvoer, zodat een veld met focus in een webtoepassing een scan kan ontvangen zonder een scannerspecifieke browser-API. Seriële poorten en SDK's van de leverancier zijn aparte integraties. Je kunt het toetsenbordpad testen met een fysieke scanner of met gesimuleerde toetsaanslagen.
Een webtoepassing ziet een barcodescanner meestal als een toetsenbord. De test is of het besturingselement met focus de lading ontvangt die je toepassing verwacht, en of de pagina de afsluiter verwerkt die de scanner is ingesteld om te sturen. Die afsluiter kan Enter, Tab of niets zijn.
Gebruik een sessie van de barcode-invoertester wanneer een fysieke scanner is aangesloten. Gebruik de Barcode Scanner Emulator wanneer je hetzelfde toetsenbordpad nodig hebt tijdens de ontwikkeling en de hardware niet op het bureau ligt. Een bredere ronde over focus, indeling en POS-workflows staat in Scannerinvoer van barcodes testen. Deze gids blijft bij de browsertoepassing: vastleggen, achtervoegsels, validatie en de gebeurtenissen die je echt kunt zien.
Hoe barcodescanners met webtoepassingen communiceren
De interfacemodus bepaalt wat de pagina kan ontvangen. Bevestig die voordat je formuliercode wijzigt. Een scanner kan vaak van modus wisselen door een configuratiebarcode uit de handleiding van de fabrikant te scannen.
USB-HID-toetsenbordwig
In de USB-HID-toetsenbordmodus meldt de scanner zich als een toetsenbord. Het besturingssysteem laadt het gewone toetsenbordstuurprogramma. Nadat de scanner een symbool heeft gedecodeerd, stuurt hij de tekens als toetsaanslagen naar het besturingselement dat de toetsenbordfocus heeft. De pagina luistert naar die toetsaanslagen of leest de tekst die ze invoegen. Ze opent geen verbinding met het apparaat.
Daardoor kan een kassaveld, een zoekvak of een andere tekstinvoer een scan aannemen met gewone HTML. De gids HID-toetsenbordwig beschrijft de toetsvolgorde, voorvoegsels en achtervoegsels uitgebreider.
Bluetooth-HID
Een Bluetooth-scanner die als toetsenbord is gekoppeld, gebruikt hetzelfde toepassingspad. De host behandelt hem als een HID-toetsenbord en het veld met focus ontvangt toetsaanslagen. Koppelen, accu en radio zijn apparaatkwesties. Zodra de tekens de browser bereiken, behandelt de pagina ze op dezelfde manier als USB-wiginvoer.
Seriële poort en virtuele COM-poort
Een seriële scanner, inclusief veel USB-modi met een virtuele COM-poort, stuurt de gedecodeerde tekst als bytes op een poort. De focus kiest de bestemming niet. Het proces dat de poort opent, doet dat. Een tekstveld dat alleen naar toetsaanslagen luistert, ziet die stroom niet.
Browsers op basis van Chromium kunnen een seriële poort openen via de Web Serial API nadat de gebruiker de poort kiest en toestemming geeft. Firefox en Safari bieden die API niet. Een wigtest oefent geen seriële integratie, en een seriële test zegt niet wat een wigscanner typt.
Interfaces van de leverancier
Sommige apparaten gebruiken een SDK van de leverancier, OPOS, JPOS of een HID-interface die geen toetsenbord is, zoals USB HID POS. Die interfaces typen niet in het veld met focus. Een gewone webpagina kan geen native SDK laden. Chromium kan na een gebruikersgebaar sommige HID-apparaten die geen toetsenbord zijn opvragen via WebHID. HID-apparaten van de toetsenbordklasse blijven geblokkeerd, zodat een wigscanner niet van een toetsenbord te onderscheiden blijft. Behandel een leveranciersinterface als een eigen integratie en test die met de software die die interface echt opent.
Wat de browser kan zien
Een wigscan komt binnen als gebeurtenissen keydown en keyup, en afdrukbare tekens werken het veld met focus bij. De browser ontvangt geen apparaatnaam, geen USB-serienummer en geen vlag die een scanner meldt. Browsers die WebHID implementeren, weigeren toetsenbordinterfaces nog steeds, dus paginascript kan ook de ruwe HID-rapporten van een wigscanner niet lezen.
event.key is het teken of de toetsnaam nadat het besturingssysteem de actieve toetsenbordindeling heeft toegepast. event.code noemt de fysieke toets, zoals Digit1 of Numpad1, en kan hetzelfde blijven wanneer een verschil in indeling event.key verandert. Geen van beide eigenschappen identificeert de hardware.
Een fysieke barcodescanner in een browser testen
Doe dit voordat je toepassingscode onderzoekt. Het toont de exacte tekenreeks en de afsluiter die de browser heeft ontvangen.
- Sluit de scanner aan en wacht tot hij aangeeft dat hij stroom heeft. Rond bij Bluetooth het koppelen af en bevestig dat de host een toetsenbordprofiel gebruikt.
- Bevestig de invoermodus. Toetsenbordwig, USB-HID-toetsenbord of Bluetooth-HID-toetsenbord kunnen in een veld typen. Serieel, SPP en SDK-modi van de leverancier doen dat niet.
- Open de barcode-invoertester.
- Klik op Test starten of op het scangebied. Het wordt blauw wanneer het klaar is. De pagina neemt de focus niet vanzelf.
- Scan een barcode waarvan je de lading al kent. Begin met een korte numerieke waarde en scan daarna een waarde die de leestekens bevat die je toepassing opslaat.
- Lees de vastgelegde waarde en het aantal tekens. Vergelijk beide met de verwachte lading, inclusief een voorvoegsel dat de scanner vóór de gegevens invoegt.
- Controleer het achtervoegsel. De tester meldt ENTER, TAB of Geen. Met Automatisch vastleggen aan verschijnt het resultaat na Enter, Tab of een korte pauze zodra de toetsen stoppen. Zet Automatisch vastleggen uit wanneer je wilt dat de vastlegging blijft staan tot je op Stoppen drukt.
- Vergelijk dat resultaat met de tekenreeks die je toepassing moet opslaan. Een voorvoegsel, een vervangen teken of een ontbrekende afsluiter moet in de scannerconfiguratie worden rechtgezet of bewust in de pagina worden afgehandeld. Behandel het pas als een decodeerfout wanneer deze vergelijking klaar is.
De tester legt toetsenbordgebeurtenissen vast die de browser kan zien. Hij kan het USB-apparaat niet identificeren en geen seriële poort lezen. Wanneer een teksteditor de scan ontvangt en de browser niet, ga dan verder met Scanner werkt in Kladblok maar niet in de POS.
Invoer van een barcodescanner vastleggen met JavaScript
Een scanner typt in het element dat de focus heeft. Geef het veld een zichtbaar label, laat het een gewone tekstinvoer zodat toetsenbordgebruikers een code kunnen typen, en lees de waarde wanneer de workflow zegt dat de invoer compleet is. De pagina hieronder doet dat. Enter verstuurt het formulier één keer. Tab rondt een niet-lege waarde af en laat de browser daarna de focus verplaatsen. Een scan zonder afsluiter blijft in het veld tot iemand Look up activeert.
<!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>
Sla dat bestand op en open het in een desktopbrowser. Klik op het veld als de focus is verschoven. Een wigscanner, of de emulator in de volgende sectie, typt dan in #barcode.
Focus is vereist. Als document.activeElement de documentbody, een knop of een andere invoer is, zien de listeners van dit veld de scan niet. De tekens komen in het besturingselement met focus terecht, of ze gaan verloren. Roep field.focus() aan wanneer de workflow klaar is voor een scan, ook nadat een dialoogvenster sluit.
Lege invoer wordt genegeerd. Het formulier blijft op zijn plaats en de statustekst zegt dat er niets is ontvangen. Alleen witruimte is leeg na trim().
Het voorbeeld voegt Enter of Tab niet toe. Als de scanner niet is ingesteld om ze te sturen, blijft de waarde in het veld en is Look up het afrondingspad. autocomplete="off" verkleint de kans dat een opgeslagen waarde de scan vervangt. Het label, de knop en Shift+Tab blijven beschikbaar, zodat iemand een code kan invoeren zonder scanner.
Handel Enter op één plek af. Dit voorbeeld gebruikt de formuliergebeurtenis submit, die ook de knop Look up en een Enter van het toetsenbord dekt. Een tweede keydown-listener voor Enter zou dezelfde scan twee keer vastleggen. Als de invoer niet in een formulier staat, luister dan naar Enter op keydown en roep preventDefault() aan zodat een bovenliggend formulier niet ook wordt verstuurd:
field.addEventListener('keydown', (event) => {
if (event.key !== 'Enter') {
return
}
event.preventDefault()
const value = field.value.trim()
if (!value) {
return
}
console.log(value)
field.value = ''
})
Maak het veld leeg na een geslaagde acceptatie, zodat de volgende scan niet aan de vorige lading wordt geplakt. Na Enter zet het voorbeeld de focus weer op hetzelfde veld, omdat die workflow nog een scan in hetzelfde vak verwacht. Na Tab laat het de focus met rust zodat de browser naar het volgende besturingselement kan gaan.
Achtervoegsels ENTER en TAB afhandelen
Een achtervoegsel is een toets die de scanner na de lading kan sturen. Het is een apparaatinstelling. Enter is gebruikelijk en optioneel. De gids ENTER- en TAB-achtervoegsels bij barcodescanners beschrijft hoe je de afsluiters uit elkaar houdt. Bevestig de instelling op de scanner die je test en laat de pagina bij die workflow passen.
ENTER
Enter in een tekstveld van één regel verstuurt in huidige browsers het omvattende formulier. Gebruik dat wanneer één scan de waarde moet vastleggen, zoals in een opzoekvak. preventDefault() op de gebeurtenis submit houdt de browser tegen om de pagina te verlaten. Laat het weg wanneer een volledige paginanavigatie het gewenste gedrag is.
Als de barcode verschijnt en het formulier niets doet, stuurt de scanner mogelijk geen achtervoegsel. Barcodescanner mist ENTER loopt die configuratie door. Sommige apparaten sturen NumPad Enter. event.key is nog steeds "Enter". Controleer event.key, niet alleen event.code === "Enter", anders lijkt die scanner defect.
TAB
Tab verplaatst de focus naar het volgende besturingselement dat focus kan krijgen. Dat past bij een reeks zoals productcode en daarna aantal. Het verrast een formulier dat verwachtte dat Enter zou versturen.
Lees de waarde in keydown terwijl het veld nog de focus heeft. De browser verplaatst de focus na die gebeurtenis. Laat de standaardactie staan wanneer het volgende besturingselement de focus moet krijgen. preventDefault() houdt de focus waar die is, wat nuttig is wanneer de waarde ongeldig is en je wilt dat de operator die ziet. Negeer Shift+Tab zodat een toetsenbordgebruiker achteruit door het formulier kan. Een Tab-achtervoegsel van de scanner is Tab zonder Shift.
Een Tab-achtervoegsel kan de focus ook verplaatsen voordat je code het veld leest, als de listener op blur of change staat en iets anders het besturingselement leegmaakt. Lees de waarde van de target van de gebeurtenis keydown.
Geen achtervoegsel
Zonder achtervoegsel blijft de lading in het veld staan. De toepassing moet beslissen wanneer de scan klaar is. Een expliciete knop, een latere Enter van de operator of het gaan naar een andere stap zijn betrouwbare afrondingspunten. Een inactiviteitstimer kan een pauze in het typen als het einde van een scan zien. Die timer is een heuristiek. Een trage scanner, een Bluetooth-vertraging of iemand die snel typt, kan aan de verkeerde kant van de drempel belanden. Geef de voorkeur aan een geconfigureerd achtervoegsel wanneer de workflow een hard einde-van-scan-signaal nodig heeft.
Configuratieverschillen
Scanners van hetzelfde merk kunnen met verschillende achtervoegsels worden geleverd, en een configuratiebarcode kan het achtervoegsel wijzigen zonder enige wijziging in je JavaScript. Sommige apparaten sturen een voorvoegsel, een symbologie-id zoals ]C1, of CR en LF. Test de drie afsluiterinstellingen die je gebruikers echt kunnen kiezen: Enter, Tab en geen. Noteer welke de uitgerolde scanners gebruiken en test de pagina tegen die instelling.
Validatie van barcodescannerinvoer
Valideer de tekenreeks die het veld heeft ontvangen. Ga er niet van uit dat elke barcode dezelfde lengte, dezelfde tekenset of dezelfde controlesom heeft. Ladingen van Code 128 en QR variëren. EAN-13 heeft 13 cijfers. Een toepassing die beide opslaat, heeft regels voor beide nodig.
Lege invoer. Wijs die af of negeer die. Een achtervoegsel zonder lading, of een klik op Look up in een leeg veld, mag geen record maken.
Onverwachte tekens. Vergelijk de ontvangen tekenreeks met een bekend etiket. Een verschil in indeling laat zich vaak zien als een gewijzigd symbool, zoals een verschoven cijfer of leesteken, terwijl de lengte gelijk blijft. Stuurtekens kunnen van een voorvoegsel of van een GS1-groepscheidingsteken komen. Sta de tekens toe die je formaat definieert. Het voorbeeld hierboven wijst ASCII-stuurtekens af zodat ze zichtbaar blijven in de statustekst. Een GS1-parser die een groepscheidingsteken verwacht, moet dat teken toestaan en de rest afwijzen.
Lengte. Dwing de lengtes af die je toepassing accepteert. Een globaal minimum en maximum is veiliger dan één verplichte lengte wanneer het formulier meer dan één symbologie ontvangt. maxlength op de invoer kapt een langere lading stilzwijgend af, dus stel die alleen in wanneer elke geaccepteerde code past.
Voorvoegsel. Haal een voorvoegsel alleen weg wanneer je de scanner hebt ingesteld om precies dat voorvoegsel te sturen en de toepassing het niet opslaat.
function withoutConfiguredPrefix(value, prefix) {
if (prefix && value.startsWith(prefix)) {
return value.slice(prefix.length)
}
return value
}
Een AIM-symbologie-id is gegevens als de scanner is ingesteld om die te verzenden. Laat die staan tot je hebt besloten of de toepassing die opslaat.
Achtervoegsel. Houd de afsluiter buiten de opgeslagen waarde. Enter en Tab zijn toetsen. Ze worden niet in een gewone tekstinvoer gezet. Een seriële lading kan nog steeds de bytes CR of LF bevatten. Haal die weg op de grens waar je de seriële stroom ontleedt, en test dat je ze niet uit het midden van een lading haalt die ze terecht bevat.
Dubbele inzendingen. Eén scan kan twee keer worden afgehandeld als zowel keydown als submit voor dezelfde Enter lopen. Gebruik één afrondingspad. Een tweede scan van dezelfde code is een andere vraag. Een magazijnformulier kan het aantal verhogen. Een ticketformulier kan een code afwijzen die al is ingewisseld. Zet die regel in de toepassing en test die met opzet. De browser kan een tweede trekkerdruk niet van een tweede listener onderscheiden.
Toepassingsregels. Controlesommen horen bij specifieke symbologieën. EAN-13 gebruikt het laatste cijfer als controlecijfer. Deze functie accepteert alleen dat formaat:
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 en QR gebruiken die berekening niet. De scanner kan de eigen symbologie al hebben gecontroleerd en de leesbare gegevens hebben verzonden. Valideer de formaten die je opslaat en herhaal de controle op de server. De verstuurde tekenreeks is gewone gebruikersinvoer. De browser kan niet bewijzen dat een scanner die heeft gemaakt.
Barcodescannerinvoer testen zonder fysieke hardware
De Barcode Scanner Emulator is een desktopapp voor Windows, macOS en Linux. Je voert de tekst in die je wilt sturen, kiest een typvertraging en kiest een achtervoegsel van geen, ENTER of TAB. Een globale sneltoets typt die tekst in de toepassing met focus. Hij bootst het toetsenbordpad na dat een wigscanner gebruikt. Hij verlicht geen etiket, leest geen symbool en decodeert geen symbologie.
Gebruik de voorbeeldpagina hierboven, of de pagina die je bouwt:
- Open de pagina in een desktopbrowser en klik op het barcodeveld.
- Voer in de emulator een bekende waarde in, zoals
123456789012. - Zet het achtervoegsel op ENTER. Stel de typvertraging in als je wilt dat de burst lijkt op een scanner die je al hebt gemeten.
- Druk op de globale scansneltoets van de emulator terwijl het browserveld nog de focus heeft.
- Bevestig de statustekst en dat de waarde één keer is geaccepteerd.
- Herhaal met TAB. De focus moet verschuiven en de waarde moet één keer worden geaccepteerd.
- Herhaal zonder achtervoegsel. De tekst moet in het veld blijven tot je Look up activeert.
- Geef de barcode-invoertester de focus en stuur dezelfde waarde opnieuw. Vergelijk de vastgelegde tekenreeks, het voorvoegsel en het achtervoegsel met wat de toepassing heeft opgeslagen.
Installatie en de eerste sneltoets staan in Aan de slag. Stuur na een instellingswijziging één scan naar de invoertester voordat je het resultaat in de toepassing vertrouwt.
Hardware is nog nodig voor de optische en apparaatspecifieke delen van de test:
- Of die scanner het afgedrukte of weergegeven symbool kan decoderen, inclusief beschadigde etiketten, grootte, contrast en afstand.
- Ondersteuning van symbologieën. Een 1D-laserscanner kan een QR-code niet lezen. Zie QR-codes testen: QR-codescanners testen.
- USB-enumeratie, Bluetooth-koppeling en de eigen toetsenbordindeling en achtervoegselconfiguratie van de scanner.
- Integraties via serieel, HID POS en de SDK van de leverancier.
De emulator is het juiste hulpmiddel voor toepassingslogica langs het toetsenbordpad. Het is het verkeerde hulpmiddel om te bewijzen dat een bepaalde scanner een bepaald etiket leest.
Toetsenbordevenementen van een barcodescanner debuggen
Bekijk de gebeurtenissen in deze volgorde wanneer de opgeslagen waarde fout is.
keydown. Vuurt voor elke toets, inclusief Enter en Tab, voordat de browser een teken invoegt of de focus verplaatst. Lees de afsluiter hier. event.repeat is waar wanneer een toets wordt vastgehouden. Een wigscanner stuurt normaal een aparte druk voor elk teken.
input. Vuurt op het veld nadat een afdrukbaar teken de waarde heeft gewijzigd. Het is de juiste gebeurtenis om te volgen als je de tekst nodig hebt terwijl die groeit. Het vuurt niet voor Enter of Tab, omdat die toetsen geen teken in een tekstinvoer zetten.
change. Vuurt nadat de waarde wordt vastgelegd, doorgaans wanneer het veld de focus verliest. Een scanner die de focus in hetzelfde veld laat, produceert aan het eind van de scan geen change. Gebruik change niet als het enige afrondingssignaal.
event.key en event.code. Log beide wanneer een teken fout is. Een verschil tussen de indeling van de scanner en die van het besturingssysteem verandert event.key en laat event.code lijken op de toets die de scanner bedoelde. Cijfers van het numerieke toetsenbord gebruiken Numpad1 en vergelijkbare codes. Sommige invoermaskers behandelen die anders dan Digit1. Verkeerde toetsenbordindeling van de barcodescanner legt het indelingsverschil uit.
Focus. Log document.activeElement direct vóór een scan. Als dat niet het barcodeveld is, verklaart de rest van het spoor het verkeerde besturingselement. Iframes hebben een eigen focus. Een scan in een ingesloten frame is zichtbaar voor script in dat frame.
Timing. Scanners maken een korte lading vaak ruim binnen een seconde af. De invoertester vergelijkt de gemiddelde tussenruimte tussen tekens met een drempel van 100 ms en labelt het resultaat als timing, niet als hardwareherkenning. Een tussenruimtedrempel kan een snelle typist, automatisch aanvullen of de emulator als scanner behandelen. Een scanner met vertraging tussen tekens, een Bluetooth-koppeling of een lange lading kan op typen lijken. Gebruik de vastgelegde waarde en het achtervoegsel. Gebruik timing als aanwijzing.
De toetsenbordevenemententester somt elke keydown en keyup op met key, code, modifiers en tijdstempels. Gebruik die wanneer de samengestelde tekenreeks een voorvoegseltoets of een numpadcode verbergt. Het logboek zijn browsergebeurtenissen. Het is geen ruw USB-verkeer.
Veelvoorkomende problemen in webtoepassingen
De scan gaat naar het verkeerde veld. Wiginvoer volgt de focus. Klik op het doelveld na elke navigatie, elk dialoogvenster of elk validatiebericht dat de focus verplaatst. Een modal zonder tekstveld kan de scan als sneltoetsen opslokken.
De scanner werkt in een teksteditor en niet in de browser. Het apparaat typt. De pagina neemt die toetsen niet aan. Controleer de focus, een uitgeschakelde of alleen-lezen invoer en een keydown-listener die preventDefault() aanroept op afdrukbare toetsen. Een listener die alleen paste afhandelt, ziet wiginvoer nooit. Begin met Barcodescanner werkt niet als geen enkele toepassing tekens ontvangt.
Enter verstuurt het formulier twee keer of navigeert weg. De browser verstuurt het formulier en je listener handelt Enter ook af. Roep preventDefault() aan op één van die paden en verwerk de waarde één keer. Een formulier met meerdere velden kan worden verstuurd voordat latere velden zijn gevuld wanneer de scanner Enter stuurt. Gebruik Tab voor die workflow, of voorkom het versturen tot het formulier compleet is.
Tab wijzigt de focus. Dat is de toets Tab. Stel Enter in op de scanner, of lees de waarde in keydown en sta de focusverplaatsing toe. Zie de sectie over achtervoegsels hierboven.
De toetsenbordindeling is verkeerd. Cijfers kunnen een verschil overleven dat leestekens verandert. Scan een bekende waarde die de symbolen bevat die je opslaat, op de indeling die het werkstation echt gebruikt.
Dezelfde scan maakt twee records. Zoek twee listeners op één Enter voordat je naar twee fysieke scans zoekt. Test daarna een bewuste tweede scan en bevestig de aantal- of duplicaatregel die je toepassing documenteert.
De waarde ontbreekt of is afgekapt. Een kenmerk maxlength, een invoermasker of preventDefault() op tekentoetsen kan de lading laten vallen of afsnijden. Vergelijk het aantal tekens in de invoertester met de waarde in je veld. Een voorvoegsel kan een correcte lading ook te lang laten lijken.
QR-codes verschijnen nooit. De scanner is misschien alleen 1D, of de QR-symbologie is uitgeschakeld. De toepassing kan dat niet herstellen. Bevestig de hardware met QR-codes testen: QR-codescanners testen en keer daarna terug naar de veldtest.
Checklist voor het testen van de webtoepassing
Gebruik deze op de build die je wilt uitbrengen, in elke browser die je ondersteunt. Controleer een nieuw profiel en ook een profiel met wachtwoordbeheer- en automatisch-aanvullen-extensies, omdat die extensies de focus verplaatsen.
- De scanner is aangesloten of gekoppeld, en de host toont hem als gereed.
- De scanner staat in toetsenbordwigmodus, niet serieel en niet in een SDK-modus van de leverancier.
- Het barcodeveld heeft direct vóór de scan de focus.
document.activeElementis dat veld. - Een bekende barcode komt teken voor teken aan, lengte inbegrepen.
- Een achtervoegsel ENTER verstuurt of accepteert de waarde één keer en laat de afsluiter niet in de opgeslagen tekenreeks.
- Een achtervoegsel TAB verplaatst de focus naar het bedoelde besturingselement, en de waarde wordt vóór de verplaatsing gelezen.
- Een configuratie zonder achtervoegsel laat de waarde beschikbaar tot de toepassing die afrondt.
- Een lege inzending wordt afgewezen of genegeerd.
- Eén scan maakt geen twee records. Een tweede echte scan volgt de duplicaatregel van de toepassing.
- Leestekens, symbolen en elk GS1-scheidingsteken dat je formaten gebruiken, overleven de heen- en terugweg.
- De toetsenbordindeling van de scanner en die van het besturingssysteem leveren de tekens die op het etiket zijn afgedrukt.
- Na loskoppelen en opnieuw aansluiten, of nadat de Bluetooth-koppeling wegvalt, bereikt de volgende scan nog steeds het veld.
- Meerdere scans achter elkaar blijven aparte waarden. Het veld plakt ze niet aan elkaar.
- Dezelfde controles slagen in de browsers die je ondersteunt, met en zonder gangbare extensies voor automatisch aanvullen.
Voor dialoogvensters, de tabvolgorde over een hele kassa en POS-aantalstromen ga je verder met Scannerinvoer van barcodes testen.
Matrix van testgevallen
De kolom scanner is wat het apparaat en de browser doen. De kolom verwacht gedrag is wat de toepassing daarop moet doen. Bedrijfsregels, zoals of een herhaalde productcode het aantal verhoogt, horen bij de toepassing. Noem ze in de test in plaats van één regel voor elk product aan te nemen.
| Scenario | Verwacht gedrag |
|---|---|
| Geldige barcode | De toepassing accepteert de waarde en slaat de lading op zonder de afsluiter. |
| Lege invoer | De toepassing wijst die af of negeert die en maakt geen record. |
| Achtervoegsel ENTER | De toepassing verstuurt of accepteert de waarde één keer. |
| Achtervoegsel TAB | De focus gaat naar het bedoelde volgende besturingselement en de waarde blijft behouden. |
| Geen achtervoegsel | De invoer blijft beschikbaar tot de toepassing die verwerkt. |
| Snelle opeenvolgende scans | Elke waarde wordt apart verwerkt en niet aan de vorige geplakt. |
| Verkeerde toetsenbordindeling | Onverwachte tekens zijn zichtbaar in de vastgelegde waarde en falen bij de validatie. |
| Dubbele scan | De toepassing volgt de eigen duplicaatregel, zoals het aantal verhogen of een herhaling afwijzen. |
| Ongeldig barcodeformaat | De toepassing toont de validatiefout voor dat formaat en slaat de waarde niet op. |
| Verloren invoerfocus | De toepassing verzint geen barcode. De scan ontbreekt of belandt in het besturingselement met focus, en de pagina blijft in een veilige toestand. |
Voer de rijen geldig, leeg, ENTER, TAB en geen achtervoegsel uit met de fysieke scanner en nog eens met de emulator. Voer de rijen toetsenbordindeling, QR en opnieuw verbinden uit op de hardware. Die rijen hangen af van het apparaat, het etiket of de indeling van het besturingssysteem, wat gesimuleerde toetsaanslagen niet nabootsen.