Barcode Scanner Emulator
Kuidas testida vöötkoodiskannereid veebirakendustes
Paljud USB- ja Bluetooth-vöötkoodiskannerid saadavad dekodeeritud andmed klaviatuurisisendina, nii et fookuses olev väli veebirakenduses saab skanni vastu võtta ilma skanneripõhise brauseri API-ta. Jadapordid ja tootja SDK-d on eraldi integratsioonid. Klaviatuuriteed saab testida füüsilise skanneriga või simuleeritud klahvivajutustega.
Veebirakendus näeb vöötkoodiskannerit tavaliselt klaviatuurina. Test on see, kas fookuses olev juhtelement saab andmesisu, mida rakendus ootab, ja kas leht käsitleb lõpetajat, mille skanner on seadistatud saatma. See lõpetaja võib olla Enter, Tab või mitte midagi.
Kasutage vöötkoodisisendi testerit, kui füüsiline skanner on ühendatud. Kasutage rakendust Barcode Scanner Emulator, kui vajate sama klaviatuuriteed arenduse ajal ja riistvara ei ole laual. Laiem ülevaade fookusest, paigutusest ja POS-i töövoogudest on juhendis Kuidas testida vöötkoodiskanneri sisendit. See juhend jääb brauserirakenduse juurde: hõive, järelliited, kontroll ja sündmused, mida tegelikult näete.
Kuidas vöötkoodiskannerid veebirakendustega suhtlevad
Liidese režiim otsustab, mida leht saab vastu võtta. Kinnitage see enne vormi koodi muutmist. Skanner saab sageli režiimi vahetada, kui skannite seadistuse vöötkoodi tootja juhendist.
USB HID-klaviatuurikiil
USB HID-klaviatuuri režiimis esitleb skanner end klaviatuurina. Operatsioonisüsteem laadib tavalise klaviatuuridraiveri. Pärast sümboli dekodeerimist saadab skanner märgid klahvivajutustena juhtelemendile, millel on klaviatuurifookus. Leht kuulab neid klahvivajutusi või loeb teksti, mille need sisestavad. See ei ava ühendust seadmega.
See tee on põhjus, miks kassaväli, otsingukast või mis tahes muu tekstisisend saab skanni vastu võtta tavalise HTML-iga. Juhend HID-klaviatuurikiil käsitleb klahvivajutuste järjekorda, eesliiteid ja järelliiteid üksikasjalikumalt.
Bluetooth HID
Klaviatuurina seotud Bluetooth-skanner kasutab sama rakenduse teed. Arvuti käsitleb seda HID-klaviatuurina ja fookuses olev väli saab klahvivajutused. Sidumine, aku ja raadio on seadme küsimused. Kui märgid brauserini jõuavad, käsitleb leht neid samamoodi nagu USB-kiilu sisendit.
Jada ja virtuaalne COM-port
Jadaskanner, sealhulgas paljud USB virtuaalse COM-pordi režiimid, saadab dekodeeritud teksti baitidena pordis. Fookus ei vali sihtkohta. Seda teeb protsess, mis pordi avab. Tekstiväli, mis kuulab ainult klahvivajutusi, seda voogu ei näe.
Chromiumil põhinevad brauserid saavad jadapordi avada Web Serial API kaudu pärast seda, kui kasutaja pordi valib ja loa annab. Firefox ja Safari seda API-t ei paku. Kiilu test ei läbi jadaintegratsiooni, ja jadatest ei ütle, mida kiiluskanner trükib.
Tootjapõhised liidesed
Mõni seade kasutab tootja SDK-d, OPOS-i, JPOS-i või muud kui klaviatuuri HID-liidest, näiteks USB HID POS. Need liidesed ei trüki fookuses olevasse välja. Tavaline veebileht ei saa laadida kohalikku SDK-d. Chromium saab pärast kasutaja žesti küsida WebHID kaudu mõnda muud kui klaviatuuri HID-seadet. Klaviatuuriklassi HID-seadmed jäävad blokeerituks, nii et kiiluskanner jääb klaviatuurist eristamatuks. Käsitlege tootja liidest eraldi integratsioonina ja testige seda tarkvaraga, mis selle liidese tegelikult avab.
Mida brauser näeb
Kiilu skann jõuab keydown- ja keyup-sündmustena ning trükitavad märgid uuendavad fookuses olevat välja. Brauser ei saa seadme nime, USB seerianumbrit ega lippu, mis ütleks, et tegu on skanneriga. Brauserid, mis WebHID-i rakendavad, keelduvad ikka klaviatuuriliidestest, nii et lehe skript ei saa lugeda ka kiiluskanneri tooreid HID-aruandeid.
event.key on märk või klahvi nimi pärast seda, kui operatsioonisüsteem on rakendanud aktiivse klaviatuuripaigutuse. event.code nimetab füüsilist klahvi, näiteks Digit1 või Numpad1, ja võib jääda samaks, kui paigutuse mittevastavus muudab event.key. Kumbki omadus ei tuvasta riistvara.
Kuidas testida füüsilist vöötkoodiskannerit brauseris
Tehke seda enne rakenduse koodi silumist. See näitab täpset stringi ja lõpetajat, mille brauser sai.
- Ühendage skanner ja oodake, kuni see näitab, et tal on toide. Bluetoothi korral lõpetage sidumine ja kinnitage, et arvuti kasutab klaviatuuriprofiili.
- Kinnitage sisendrežiim. Klaviatuurikiil, USB HID-klaviatuur või Bluetooth HID-klaviatuur saab välja trükkida. Jada, SPP ja tootja SDK režiimid ei saa.
- Avage vöötkoodisisendi testerit.
- Klõpsake Alusta testi või klõpsake skannimisala. See muutub valmisolekul siniseks. Leht ei võta fookust ise.
- Skannige vöötkood, mille andmesisu te juba teate. Alustage lühikesest numbrilisest väärtusest, seejärel skannige väärtus, mis sisaldab kirjavahemärke, mida rakendus salvestab.
- Lugege hõivatud väärtus ja märkide arv. Võrrelge mõlemat oodatava andmesisuga, sealhulgas eesliitega, mille skanner andmete ette lisab.
- Kontrollige järelliidet. Tester teatab ENTER, TAB või Puudub. Kui Automaatne jäädvustus on sees, ilmub tulemus pärast Enterit, Tabi või lühikest pausi, kui klahvid peatuvad. Lülitage Automaatne jäädvustus välja, kui soovite hõivet hoida, kuni vajutate Peata.
- Võrrelge seda tulemust stringiga, mille rakendus peaks salvestama. Eesliide, asendatud märk või puuduv lõpetaja tuleks parandada skanneri seadistuses või käsitleda lehel teadlikult. Ärge käsitlege seda dekodeerimise veana, enne kui see võrdlus on tehtud.
Tester salvestab klaviatuurisündmused, mida brauser näeb. See ei suuda USB-seadet tuvastada ega jadaporti lugeda. Kui tekstiredaktor saab skanni, aga brauser mitte, jätkake juhendiga Skanner töötab Notepadis, kuid mitte POS-is.
Vöötkoodiskanneri sisendi hõive JavaScriptiga
Skanner trükib elementi, millel on fookus. Andke väljale nähtav silt, jätke see tavaliseks tekstisisendiks, et klaviatuurikasutaja saaks koodi tippida, ja lugege väärtus siis, kui töövoog ütleb, et sisestus on valmis. Allolev leht teeb seda. Enter saadab vormi üks kord. Tab lõpetab mittetühja väärtuse ja laseb siis brauseril fookust liigutada. Skann ilma lõpetajata jääb väljale, kuni keegi aktiveerib 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>
Salvestage see fail ja avage see töölauabrauseris. Klõpsake välja, kui fookus on liikunud. Kiiluskanner või järgmise jaotise emulaator trükib siis väljale #barcode.
Fookus on vajalik. Kui document.activeElement on dokumendi keha, nupp või muu sisend, ei näe selle välja kuulajad skanni. Märgid maanduvad fookuses olevale juhtelemendile või lähevad kaotsi. Kutsuge field.focus(), kui töövoog on skanniks valmis, sealhulgas pärast dialoogi sulgumist.
Tühi sisend jäetakse tähelepanuta. Vorm jääb paigale ja olekutekst ütleb, et midagi ei saadud. Ainult tühimärk on pärast trim() tühi.
Näide ei lisa Enterit ega Tabi. Kui skanner ei ole seadistatud neid saatma, jääb väärtus väljale ja Look up on lõpetamise tee. autocomplete="off" vähendab võimalust, et salvestatud väärtus asendab skanni. Silt, nupp ja Shift+Tab jäävad kättesaadavaks, nii et inimene saab koodi sisestada ilma skannerita.
Käsitlege Enterit ühes kohas. See näide kasutab vormi submit-sündmust, mis katab ka nupu Look up ja klaviatuuri Enteri. Teine keydown-kuulaja Enterile salvestaks sama skanni kaks korda. Kui sisend ei ole vormi sees, kuulake Enterit sündmusel keydown ja kutsuge preventDefault(), et ülemvorm ei saadetaks samuti:
field.addEventListener('keydown', (event) => {
if (event.key !== 'Enter') {
return
}
event.preventDefault()
const value = field.value.trim()
if (!value) {
return
}
console.log(value)
field.value = ''
})
Tühjendage väli pärast edukat vastuvõttu, et järgmine skann ei liituks eelmise andmesisuga. Pärast Enterit fokuseerib näide sama välja uuesti, sest see töövoog ootab järgmist skanni samas kastis. Pärast Tabi jätab see fookuse rahule, et brauser saaks liikuda järgmisele juhtelemendile.
ENTER- ja TAB-järelliidete käsitlemine
Järelliide on klahv, mille skanner võib pärast andmesisu saata. See on seadme säte. Enter on tavaline ja see on valikuline. Juhend ENTER ja TAB järelliited vöötkoodiskannerites kirjeldab, kuidas lõpetajaid eristada. Kinnitage säte skanneril, mida testite, ja seadke siis leht selle töövooga vastavusse.
ENTER
Enter üherealises tekstiväljas saadab ümbritseva vormi praegustes brauserites. Kasutage seda, kui üks skann peab väärtuse kinnitama, näiteks otsingukastis. preventDefault() sündmusel submit peatab brauseri eemale navigeerimise. Jätke see ära, kui soovite täislehe navigeerimist.
Kui vöötkood ilmub ja vorm ei tee midagi, võib skanner järelliidet mitte saata. Vöötkoodiskanneril puudub ENTER juhatab selle seadistuse läbi. Mõni seade saadab NumPad Enter. event.key on ikka "Enter". Kontrollige event.key, mitte ainult event.code === "Enter", muidu paistab see skanner katki olevat.
TAB
Tab viib fookuse järgmisele fokuseeritavale juhtelemendile. See sobib jadale, näiteks tootekood ja seejärel kogus. See üllatab vormi, mis ootas, et Enter saadab.
Lugege väärtus sündmusel keydown, kui väljal on veel fookus. Brauser liigutab fookust pärast seda sündmust. Jätke vaiketegevus alles, kui järgmine juhtelement peab fookuse saama. preventDefault() hoiab fookuse paigal, mis on kasulik, kui väärtus on vigane ja soovite, et operaator seda näeks. Ignoreerige Shift+Tab, et klaviatuurikasutaja saaks vormis tagasi liikuda. Skanneri Tab-järelliide on Tab ilma Shiftita.
Tab-järelliide võib fookust liigutada ka enne, kui teie kood välja loeb, kui kuulaja on blur või change ja miski muu tühjendab juhtelemendi. Lugege väärtus keydown-sündmuse sihtmärgist.
Järelliide puudub
Ilma järelliiteta jääb andmesisu väljale. Rakendus peab otsustama, millal skann on lõppenud. Selge nupp, hilisem Enter operaatorilt või liikumine teise sammu juurde on usaldusväärsed lõpetamiskohad. Tegevusetuse taimer võib käsitada tippimise pausi skanni lõpuna. See taimer on heuristika. Aeglane skanner, Bluetoothi viivitus või kiiresti tippiv inimene võib jääda läve valele poolele. Eelistage seadistatud järelliidet, kui töövoog vajab kindlat skanni-lõpu signaali.
Seadistuse erinevused
Sama kaubamärgi skannerid võivad tulla eri järelliidetega ja seadistuse vöötkood võib järelliidet muuta ilma JavaScripti muutmata. Mõni seade saadab eesliite, sümboloogia identifikaatori, näiteks ]C1, või CR ja LF. Testige kolme lõpetaja sätet, mida kasutajad tegelikult valida saavad: Enter, Tab ja puudub. Kirjutage üles, millist kasutavad kasutusele võetud skannerid, ja testige lehte selle sätte vastu.
Vöötkoodiskanneri sisendi kontroll
Kontrollige stringi, mille väli sai. Ärge eeldage, et igal vöötkoodil on sama pikkus, märgistik või kontrollsumma. Code 128 ja QR andmesisu varieerub. EAN-13 on 13 numbrit. Rakendus, mis salvestab mõlemat, vajab reegleid mõlema jaoks.
Tühi sisend. Lükake see tagasi või ignoreerige. Järelliide ilma andmesisuta või Look up klõps tühjal väljal ei tohi kirjet luua.
Ootamatud märgid. Võrrelge saadud stringi teadaoleva sildiga. Paigutuse mittevastavus ilmneb sageli muudetud sümbolina, näiteks nihutatud numbri või kirjavahemärgina, samal ajal kui pikkus jääb samaks. Juhtmärgid võivad tulla eesliitest või GS1 rühmaeraldajast. Lubage märgid, mille teie vorming määrab. Ülaltoodud näide lükkab ASCII juhtmärgid tagasi, et need jääksid olekutekstis nähtavaks. GS1 parser, mis ootab rühmaeraldajat, peaks selle märgi lubama ja ülejäänu tagasi lükkama.
Pikkus. Jõustage pikkused, mida rakendus aktsepteerib. Üldine miinimum ja maksimum on ohutum kui üks nõutud pikkus, kui vorm saab rohkem kui ühe sümboloogia. maxlength sisendil kärbib pikema andmesisu vaikselt, seega seadke see ainult siis, kui iga aktsepteeritud kood mahub.
Eesliide. Eemaldage eesliide ainult siis, kui seadistasite skanneri saatma täpselt seda eesliidet ja rakendus seda ei salvesta.
function withoutConfiguredPrefix(value, prefix) {
if (prefix && value.startsWith(prefix)) {
return value.slice(prefix.length)
}
return value
}
AIM-i sümboloogia identifikaator on andmed, kui skanner on seatud seda edastama. Jätke see paigale, kuni olete otsustanud, kas rakendus seda salvestab.
Järelliide. Hoidke lõpetaja salvestatud väärtusest eemal. Enter ja Tab on klahvid. Neid ei lisata tavalisse tekstisisendisse. Jada andmesisu võib ikka sisaldada CR- või LF-baite. Eemaldage need piiril, kus jada voogu sõelute, ja testige, et te ei eemalda neid andmesisu keskelt, mis neid õigustatult sisaldab.
Topeltesitused. Üht skanni saab käsitleda kaks korda, kui nii keydown kui ka submit käivituvad sama Enteri peale. Kasutage üht lõpetamisteed. Sama koodi teine skann on eraldi küsimus. Laovorm võib kogust suurendada. Pileti vorm võib tagasi lükata koodi, mis on juba lunastatud. Pange see reegel rakendusse ja testige seda meelega. Brauser ei suuda eristada teist päästiku vajutust teisest kuulajast.
Rakenduse reeglid. Kontrollsummad kuuluvad kindlatele sümboloogiatele. EAN-13 kasutab viimast numbrit kontrollnumbrina. See funktsioon aktsepteerib ainult seda vormingut:
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 ja QR seda arvutust ei kasuta. Skanner võib olla oma sümboloogiat juba kontrollinud ja inimesele loetavad andmed edastanud. Kontrollige vorminguid, mida salvestate, ja korrake kontrolli serveris. Saadetud string on tavaline kasutaja sisend. Brauser ei saa tõendada, et skanner selle tekitas.
Vöötkoodiskanneri sisendi testimine ilma füüsilise riistvarata
Barcode Scanner Emulator on töölauarakendus Windowsile, macOS-ile ja Linuxile. Sisestate saadetava teksti, valite tippimise viivituse ja valite järelliite Puudub, ENTER või TAB. Globaalne otsetee trükib selle teksti fookuses olevasse rakendusse. See kordab klaviatuuriteed, mida kiiluskanner kasutab. See ei valgusta silti, ei loe sümbolit ega dekodeeri sümboloogiat.
Kasutage ülaltoodud näidislehte või lehte, mida ehitate:
- Avage leht töölauabrauseris ja klõpsake vöötkoodivälja.
- Sisestage emulaatoris teadaolev väärtus, näiteks
123456789012. - Seadke järelliide ENTER peale. Seadke tippimise viivitus, kui soovite, et purse sarnaneks skanneriga, mida olete juba mõõtnud.
- Vajutage emulaatori globaalset skannimise otseteed, kuni brauseri väljal on veel fookus.
- Kinnitage olekutekst ja see, et väärtus võeti vastu üks kord.
- Korrake TAB-iga. Fookus peaks liikuma ja väärtus tuleks vastu võtta üks kord.
- Korrake ilma järelliiteta. Tekst peaks väljale jääma, kuni aktiveerite Look up.
- Fokuseerige vöötkoodisisendi testerit ja saatke sama väärtus uuesti. Võrrelge hõivatud stringi, eesliidet ja järelliidet sellega, mille rakendus salvestas.
Paigaldust ja esimest otseteed käsitleb Alustamine. Pärast sätte muutmist saatke üks skann sisendi testerisse, enne kui usaldate tulemust rakenduses.
Riistvara on ikka vajalik testi optiliste ja seadmepõhiste osade jaoks:
- Kas see skanner suudab dekodeerida trükitud või kuvatud sümboli, sealhulgas kahjustatud silte, suurust, kontrasti ja kaugust.
- Sümboloogia tugi. 1D-laserskanner ei saa lugeda QR-koodi. Vt QR-koodi testimine: kuidas testida QR-koodi skannereid.
- USB loendamine, Bluetoothi sidumine ning skanneri enda klaviatuuripaigutus ja järelliite seadistus.
- Jada, HID POS ja tootja SDK integratsioonid.
Emulaator on õige vahend rakenduse loogika jaoks klaviatuuriteel. See on vale vahend tõestamaks, et konkreetne skanner loeb konkreetset silti.
Vöötkoodiskanneri klaviatuurisündmuste silumine
Jälgige sündmusi selles järjekorras, kui salvestatud väärtus on vale.
keydown. Käivitub iga klahvi puhul, sealhulgas Enter ja Tab, enne kui brauser märgi lisab või fookust liigutab. Lugege lõpetaja siin. event.repeat on tõene, kui klahvi hoitakse all. Kiiluskanner saadab tavaliselt iga märgi jaoks eraldi vajutuse.
input. Käivitub väljal pärast seda, kui trükitav märk muudab selle väärtust. See on õige sündmus, kui vajate teksti selle kasvades. See ei käivitu Enteri ega Tabi puhul, sest need klahvid ei lisa tekstisisendisse märki.
change. Käivitub pärast väärtuse kinnitamist, tavaliselt kui väli kaotab fookuse. Skanner, mis jätab fookuse samale väljale, ei tekita skanni lõpus change. Ärge kasutage change ainsa lõpetamise signaalina.
event.key ja event.code. Logige mõlemad, kui märk on vale. Mittevastavus skanneri paigutuse ja operatsioonisüsteemi paigutuse vahel muudab event.key ja jätab event.code näima klahvina, mida skanner mõtles. Numbrisõrmistiku numbrid kasutavad Numpad1 ja sarnaseid koode. Mõni sisendimask käsitleb neid teisiti kui Digit1. Vöötkoodiskanneri vale klaviatuuripaigutus selgitab paigutuse mittevastavust.
Fookus. Logige document.activeElement vahetult enne skanni. Kui see ei ole vöötkoodiväli, selgitab ülejäänud jälg vale juhtelementi. Iframe'idel on oma fookus. Skann manustatud raami on nähtav selle raami sees olevale skriptile.
Ajastus. Skannerid lõpetavad lühikese andmesisu sageli tublisti alla sekundi. Sisendi tester võrdleb keskmist vahet märkide vahel 100 ms lävega ja sildistab tulemuse ajastusena, mitte riistvara tuvastusena. Vahe lävi võib käsitada kiiret tippijat, automaattäitmist või emulaatorit skannerina. Skanner märkidevahelise viivitusega, Bluetoothi lingiga või pika andmesisuga võib paista tippimisena. Kasutage hõivatud väärtust ja järelliidet. Kasutage ajastust vihjena.
Kasutage klaviatuurisündmuste testerit. See loetleb iga keydown ja keyup koos key, code, muuteklahvide ja ajatemplitega. Kasutage seda, kui kokku pandud string peidab eesliite klahvi või numbrilisõrmistiku koodi. Logi on brauseri sündmused. See ei ole toores USB-liiklus.
Levinud probleemid veebirakendustes
Skann läheb valele väljale. Kiilu sisend järgib fookust. Klõpsake sihtvälja pärast iga navigeerimist, dialoogi või kontrolliteadet, mis fookust liigutab. Modaalaken ilma tekstiväljata võib neelata skanni otseteeklahvidena.
Skanner töötab tekstiredaktoris, aga mitte brauseris. Seade trükib. Leht ei võta neid klahve vastu. Kontrollige fookust, keelatud või kirjutuskaitstud sisendit ja keydown-kuulajat, mis kutsub preventDefault() trükitavatel klahvidel. Kuulaja, mis käsitleb ainult paste, ei näe kunagi kiilu sisendit. Alustage juhendist Vöötkoodiskanner ei tööta, kui ükski rakendus ei saa märke.
Enter saadab vormi kaks korda või navigeerib eemale. Brauser saadab vormi ja teie kuulaja käsitleb samuti Enterit. Kutsuge preventDefault() ühel neist teedest ja töödelge väärtust üks kord. Mitme väljaga vorm võib saata enne, kui hilisemad väljad on täidetud, kui skanner saadab Enteri. Kasutage selle töövoo jaoks Tabi või takistage saatmist, kuni vorm on täielik.
Tab muudab fookust. See on Tab-klahv. Seadistage skanneril Enter või lugege väärtus sündmusel keydown ja lubage fookuse liikumine. Vt järelliidete jaotist ülal.
Klaviatuuripaigutus on vale. Numbrid võivad üle elada mittevastavuse, mis muudab kirjavahemärke. Skannige teadaolev väärtus, mis sisaldab sümboleid, mida salvestate, paigutusel, mida töökoht tegelikult kasutab.
Sama skann loob kaks kirjet. Otsige kahte kuulajat ühel Enteril, enne kui otsite kahte füüsilist skanni. Seejärel testige tahtlikku teist skanni ja kinnitage koguse või duplikaadi reegel, mille rakendus dokumenteerib.
Väärtus puudub või on kärbitud. Atribuut maxlength, sisendimask või preventDefault() märgiklahvidel võib andmesisu kaotada või lõigata. Võrrelge märkide arvu sisendi testeris väärtusega teie väljal. Eesliide võib panna ka õige andmesisu liiga pikana paistma.
QR-koodid ei ilmu kunagi. Skanner võib olla ainult 1D või QR-sümboloogia võib olla keelatud. Rakendus ei saa seda parandada. Kinnitage riistvara juhendiga QR-koodi testimine: kuidas testida QR-koodi skannereid ja pöörduge siis väljatesti juurde.
Veebirakenduse testimise kontrollnimekiri
Kasutage seda järgul, mida kavatsete välja anda, igas brauseris, mida toetate. Kontrollige nii värsket profiili kui ka profiili paroolihalduri ja automaattäite laiendustega, sest need laiendused liigutavad fookust.
- Skanner on ühendatud või seotud ja arvuti näitab, et see on valmis.
- Skanner on klaviatuurikiilu režiimis, mitte jada ega tootja SDK režiimis.
- Vöötkoodiväli on fookuses vahetult enne skanni.
document.activeElementon see väli. - Teadaolev vöötkood jõuab kohale märk märgi haaval, sealhulgas pikkus.
- ENTER-järelliide saadab või võtab väärtuse vastu üks kord ega jäta lõpetajat salvestatud stringi.
- TAB-järelliide viib fookuse juhtelemendile, mida kavatsete, ja väärtus loetakse enne liikumist.
- Seadistus ilma järelliiteta jätab väärtuse kättesaadavaks, kuni rakendus selle lõpetab.
- Tühi saatmine lükatakse tagasi või ignoreeritakse.
- Üks skann ei loo kahte kirjet. Teine tegelik skann järgib rakenduse duplikaadireeglit.
- Kirjavahemärgid, sümbolid ja mis tahes GS1 eraldaja, mida teie vormingud kasutavad, elavad ringi üle.
- Skanneri klaviatuuripaigutus ja operatsioonisüsteemi paigutus annavad märgid, mis on sildile trükitud.
- Pärast lahtiühendamist ja uuesti ühendamist või pärast Bluetoothi lingi katkemist jõuab järgmine skann ikka väljale.
- Mitu skanni järjest jäävad eraldi väärtusteks. Väli ei liida neid kokku.
- Samad kontrollid õnnestuvad toetatud brauserites, tavaliste automaattäite laiendustega ja ilma nendeta.
Dialoogide, tabulatsiooni järjekorra üle terve kassa ja POS-i kogusevoogude jaoks jätkake juhendiga Kuidas testida vöötkoodiskanneri sisendit.
Testjuhtude maatriks
Skanneri veerg on see, mida seade ja brauser teevad. Oodatava käitumise veerg on see, mida rakendus peaks vastuseks tegema. Ärireeglid, näiteks kas korduv tootekood suurendab kogust, kuuluvad rakendusele. Sõnastage need testis, selle asemel et eeldada üht reeglit iga toote jaoks.
| Stsenaarium | Oodatav käitumine |
|---|---|
| Kehtiv vöötkood | Rakendus võtab väärtuse vastu ja salvestab andmesisu ilma lõpetajata. |
| Tühi sisend | Rakendus lükkab selle tagasi või ignoreerib ega loo kirjet. |
| ENTER-järelliide | Rakendus saadab või võtab väärtuse vastu üks kord. |
| TAB-järelliide | Fookus liigub kavandatud järgmisele juhtelemendile ja väärtus säilib. |
| Järelliide puudub | Sisend jääb kättesaadavaks, kuni rakendus seda töötleb. |
| Kiired järjestikused skannid | Iga väärtust töödeldakse eraldi ega liideta eelmise külge. |
| Vale klaviatuuripaigutus | Ootamatud märgid on hõivatud väärtuses nähtavad ja ei läbi kontrolli. |
| Duplikaatskann | Rakendus järgib oma duplikaadireeglit, näiteks suurendab kogust või lükkab korduse tagasi. |
| Vigane vöötkoodi vorming | Rakendus näitab selle vormingu kontrolliviga ega salvesta väärtust. |
| Kaotatud sisendi fookus | Rakendus ei mõtle vöötkoodi välja. Skann puudub või maandub fookuses olevale juhtelemendile ja leht jääb ohutusse olekusse. |
Käivitage kehtiva, tühja, ENTER, TAB ja järelliiteta read füüsilise skanneriga ja uuesti emulaatoriga. Käivitage klaviatuuripaigutuse, QR-i ja uuestiühendamise read riistvaral. Need read sõltuvad seadmest, sildist või operatsioonisüsteemi paigutusest, mida simuleeritud klahvivajutused ei korda.