Barcode Scanner Emulator
Kaip testuoti brūkšninių kodų skaitytuvus žiniatinklio programose
Daugelis USB ir Bluetooth brūkšninių kodų skaitytuvų siunčia dekoduotus duomenis kaip klaviatūros įvestį, todėl sufokusuotas laukas žiniatinklio programoje gali gauti nuskaitymą be skaitytuvui skirtos naršyklės API. Nuoseklieji prievadai ir gamintojo SDK yra atskiros integracijos. Klaviatūros kelią galite testuoti fiziniu skaitytuvu arba imituotais klavišų paspaudimais.
Žiniatinklio programa brūkšninių kodų skaitytuvą paprastai mato kaip klaviatūrą. Testas yra tai, ar sufokusuotas valdiklis gauna turinį, kurio programa tikisi, ir ar puslapis apdoroja užbaigiklį, kurį skaitytuvas sukonfigūruotas siųsti. Tas užbaigiklis gali būti Enter, Tab arba nieko.
Naudokite brūkšninio kodo įvesties testerį, kai prijungtas fizinis skaitytuvas. Naudokite Barcode Scanner Emulator, kai to paties klaviatūros kelio reikia kuriant, o aparatūra nėra ant stalo. Platesnė fokuso, išdėstymo ir POS darbo eigų apžvalga yra gide Kaip testuoti brūkšninių kodų skaitytuvo įvestį. Šis gidas lieka prie naršyklės programos: fiksavimas, priesagos, tikrinimas ir įvykiai, kuriuos iš tikrųjų galite stebėti.
Kaip brūkšninių kodų skaitytuvai bendrauja su žiniatinklio programomis
Sąsajos režimas nusprendžia, ką puslapis gali gauti. Patvirtinkite jį prieš keisdami formos kodą. Skaitytuvas dažnai gali perjungti režimą nuskaitęs konfigūracijos brūkšninį kodą iš gamintojo vadovo.
USB HID klaviatūros pleištas
USB HID klaviatūros režimu skaitytuvas prisistato kaip klaviatūra. Operacinė sistema įkelia įprastą klaviatūros tvarkyklę. Dekodavęs simbolį, skaitytuvas siunčia ženklus kaip klavišų paspaudimus tam valdikliui, kuris turi klaviatūros fokusą. Puslapis klauso tų paspaudimų arba skaito tekstą, kurį jie įterpia. Jis neatidaro ryšio su įrenginiu.
Dėl šio kelio kasos laukas, paieškos laukas ar bet kuri kita teksto įvestis gali priimti nuskaitymą su paprastu HTML. Gidas HID klaviatūros pleištas išsamiau aprašo klavišų seką, priešdėlius ir priesagas.
Bluetooth HID
Kaip klaviatūra suporuotas Bluetooth skaitytuvas naudoja tą patį programos kelią. Kompiuteris laiko jį HID klaviatūra, o sufokusuotas laukas gauna klavišų paspaudimus. Suporavimas, baterija ir radijas yra įrenginio klausimai. Kai ženklai pasiekia naršyklę, puslapis juos apdoroja taip pat kaip USB pleišto įvestį.
Nuoseklioji sąsaja ir virtualusis COM prievadas
Nuoseklusis skaitytuvas, įskaitant daugelį USB virtualiojo COM prievado režimų, siunčia dekoduotą tekstą kaip baitus prievade. Fokusas neparenka paskirties. Tai daro procesas, kuris atidaro prievadą. Teksto laukas, kuris klauso tik klavišų paspaudimų, to srauto nematys.
Chromium pagrindu veikiančios naršyklės gali atidaryti nuoseklųjį prievadą per Web Serial API, kai naudotojas pasirenka prievadą ir suteikia leidimą. Firefox ir Safari tos API neteikia. Pleišto testas neišbando nuosekliosios integracijos, o nuoseklusis testas nepasako, ką rašys pleišto skaitytuvas.
Gamintojui būdingos sąsajos
Kai kurie įrenginiai naudoja gamintojo SDK, OPOS, JPOS arba ne klaviatūros HID sąsają, pavyzdžiui USB HID POS. Tos sąsajos nerašo į sufokusuotą lauką. Paprastas tinklalapis negali įkelti vietinio SDK. Chromium po naudotojo gesto per WebHID gali paprašyti kai kurių ne klaviatūros HID įrenginių. Klaviatūros klasės HID įrenginiai lieka užblokuoti, todėl pleišto skaitytuvas lieka neatskiriamas nuo klaviatūros. Gamintojo sąsają laikykite atskira integracija ir testuokite ją programine įranga, kuri tą sąsają iš tikrųjų atidaro.
Ką mato naršyklė
Pleišto nuskaitymas ateina kaip keydown ir keyup įvykiai, o spausdinami ženklai atnaujina sufokusuotą lauką. Naršyklė negauna įrenginio pavadinimo, USB serijos numerio ar žymos, kad tai skaitytuvas. Naršyklės, kurios įgyvendina WebHID, vis tiek atmeta klaviatūros sąsajas, todėl puslapio scenarijus taip pat negali skaityti neapdorotų pleišto skaitytuvo HID ataskaitų.
event.key yra ženklas arba klavišo pavadinimas po to, kai operacinė sistema pritaiko aktyvų klaviatūros išdėstymą. event.code įvardija fizinį klavišą, pavyzdžiui Digit1 arba Numpad1, ir gali likti toks pat, kai išdėstymo neatitiktis pakeičia event.key. Nė viena savybė neidentifikuoja aparatūros.
Kaip testuoti fizinį brūkšninių kodų skaitytuvą naršyklėje
Padarykite tai prieš derindami programos kodą. Tai parodo tikslią eilutę ir užbaigiklį, kuriuos gavo naršyklė.
- Prijunkite skaitytuvą ir palaukite, kol jis parodys, kad turi maitinimą. Bluetooth atveju baikite suporavimą ir patvirtinkite, kad kompiuteris naudoja klaviatūros profilį.
- Patvirtinkite įvesties režimą. Klaviatūros pleištas, USB HID klaviatūra arba Bluetooth HID klaviatūra gali rašyti į lauką. Nuoseklusis, SPP ir gamintojo SDK režimai nerašys.
- Atidarykite brūkšninio kodo įvesties testerį.
- Spustelėkite Pradėti testą arba spustelėkite nuskaitymo sritį. Ji tampa mėlyna, kai yra pasirengusi. Puslapis pats neperima fokuso.
- Nuskaitykite brūkšninį kodą, kurio turinį jau žinote. Pradėkite nuo trumpos skaitinės reikšmės, tada nuskaitykite reikšmę su skyrybos ženklais, kuriuos saugo programa.
- Perskaitykite užfiksuotą reikšmę ir ženklų skaičių. Palyginkite abu su laukiamu turiniu, įskaitant priešdėlį, kurį skaitytuvas įterpia prieš duomenis.
- Patikrinkite priesagą. Testeris praneša ENTER, TAB arba Nėra. Kai Automatinis fiksavimas įjungtas, rezultatas pasirodo po Enter, Tab arba trumpos pauzės, kai klavišai sustoja. Išjunkite Automatinis fiksavimas, kai norite, kad fiksavimas būtų laikomas, kol paspausite Stabdyti.
- Palyginkite tą rezultatą su eilute, kurią programa turi išsaugoti. Priešdėlį, pakeistą ženklą arba trūkstamą užbaigiklį reikia taisyti skaitytuvo konfigūracijoje arba sąmoningai apdoroti puslapyje. Nelaikykite to dekodavimo klaida, kol šis palyginimas neatliktas.
Testeris registruoja klaviatūros įvykius, kuriuos naršyklė gali matyti. Jis negali atpažinti USB įrenginio ir negali skaityti nuosekliojo prievado. Kai tekstų rengyklė gauna nuskaitymą, o naršyklė negauna, tęskite su Skaitytuvas veikia užrašinėje, bet ne POS.
Brūkšninių kodų skaitytuvo įvesties fiksavimas su JavaScript
Skaitytuvas rašo į elementą, kuris turi fokusą. Duokite laukui matomą etiketę, palikite jį įprasta teksto įvestimi, kad klaviatūros naudotojas galėtų įvesti kodą, ir skaitykite reikšmę, kai darbo eiga sako, kad įrašas baigtas. Toliau esantis puslapis tai daro. Enter pateikia formą vieną kartą. Tab užbaigia netuščią reikšmę ir tada leidžia naršyklei perkelti fokusą. Nuskaitymas be užbaigiklio lieka lauke, kol kas nors suaktyvina 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>
Išsaugokite tą failą ir atidarykite jį darbalaukio naršyklėje. Spustelėkite lauką, jei fokusas pasislinko. Pleišto skaitytuvas arba emuliatorius kitoje dalyje tada rašo į #barcode.
Fokusas būtinas. Jei document.activeElement yra dokumento turinys, mygtukas arba kita įvestis, šio lauko klausytojai nuskaitymo nemato. Ženklai patenka į sufokusuotą valdiklį arba dingsta. Kvieskite field.focus(), kai darbo eiga pasirengusi nuskaitymui, taip pat po to, kai dialogas užsidaro.
Tuščia įvestis ignoruojama. Forma lieka vietoje, o būsenos tekstas sako, kad nieko negauta. Vien tik tarpai po trim() yra tušti.
Pavyzdys neprideda Enter ar Tab. Jei skaitytuvas nesukonfigūruotas jų siųsti, reikšmė lieka lauke, o Look up yra užbaigimo kelias. autocomplete="off" sumažina tikimybę, kad išsaugota reikšmė pakeis nuskaitymą. Etiketė, mygtukas ir Shift+Tab lieka prieinami, todėl žmogus gali įvesti kodą be skaitytuvo.
Apdorokite Enter vienoje vietoje. Šis pavyzdys naudoja formos submit įvykį, kuris apima ir mygtuką Look up, ir klaviatūros Enter. Antras keydown klausytojas Enter įrašytų tą patį nuskaitymą du kartus. Jei įvestis nėra formoje, klausykite Enter per keydown ir kvieskite preventDefault(), kad protėvio forma taip pat nebūtų pateikta:
field.addEventListener('keydown', (event) => {
if (event.key !== 'Enter') {
return
}
event.preventDefault()
const value = field.value.trim()
if (!value) {
return
}
console.log(value)
field.value = ''
})
Išvalykite lauką po sėkmingo priėmimo, kad kitas nuskaitymas neprisijungtų prie ankstesnio turinio. Po Enter pavyzdys vėl sufokusuoja tą patį lauką, nes ta darbo eiga tikisi kito nuskaitymo tame pačiame lauke. Po Tab jis palieka fokusą ramybėje, kad naršyklė galėtų pereiti prie kito valdiklio.
ENTER ir TAB priesagų apdorojimas
Priesaga yra klavišas, kurį skaitytuvas gali siųsti po turinio. Tai įrenginio nustatymas. Enter yra įprastas ir jis neprivalomas. Gidas ENTER ir TAB priesagos brūkšninių kodų skaitytuvuose aprašo, kaip atskirti užbaigiklius. Patvirtinkite nustatymą skaitytuve, kurį testuojate, tada pritaikykite puslapį tai darbo eigai.
ENTER
Enter vienos eilutės teksto lauke dabartinėse naršyklėse pateikia apimančią formą. Naudokite tai, kai vienas nuskaitymas turi patvirtinti reikšmę, kaip paieškos lauke. preventDefault() per submit įvykį sustabdo naršyklę nuo navigacijos kitur. Praleiskite jį, kai norite viso puslapio navigacijos.
Jei brūkšninis kodas pasirodo, o forma nieko nedaro, skaitytuvas gali nesiųsti priesagos. Brūkšninių kodų skaitytuvui trūksta ENTER veda per tą konfigūraciją. Kai kurie įrenginiai siunčia NumPad Enter. event.key vis tiek yra "Enter". Tikrinkite event.key, ne tik event.code === "Enter", kitaip tas skaitytuvas atrodys sugedęs.
TAB
Tab perkelia fokusą į kitą sufokusuojamą valdiklį. Tai tinka sekai, pavyzdžiui prekės kodas, tada kiekis. Tai nustebina formą, kuri tikėjosi, kad Enter pateiks.
Skaitykite reikšmę per keydown, kol laukas dar turi fokusą. Naršyklė perkelia fokusą po to įvykio. Palikite numatytąjį veiksmą, kai kitas valdiklis turi gauti fokusą. preventDefault() išlaiko fokusą vietoje, o tai naudinga, kai reikšmė negalioja ir norite, kad operatorius ją matytų. Ignoruokite Shift+Tab, kad klaviatūros naudotojas galėtų judėti atgal per formą. Skaitytuvo Tab priesaga yra Tab be Shift.
Tab priesaga taip pat gali perkelti fokusą anksčiau, nei jūsų kodas perskaito lauką, jei klausytojas yra ant blur arba change, o kas nors kitas išvalo valdiklį. Skaitykite reikšmę iš keydown įvykio taikinio.
Be priesagos
Be priesagos turinys lieka lauke. Programa turi nuspręsti, kada nuskaitymas baigtas. Aiškus mygtukas, vėlesnis operatoriaus Enter arba perėjimas prie kito žingsnio yra patikimi užbaigimo taškai. Neveiklos laikmatis gali laikyti rašymo pauzę nuskaitymo pabaiga. Tas laikmatis yra euristika. Lėtas skaitytuvas, Bluetooth delsa arba greitai rašantis žmogus gali atsidurti neteisingoje slenksčio pusėje. Rinkitės sukonfigūruotą priesagą, kai darbo eigai reikia tvirto nuskaitymo pabaigos signalo.
Konfigūracijos skirtumai
To paties gamintojo skaitytuvai gali būti pristatomi su skirtingomis priesagomis, o konfigūracijos brūkšninis kodas gali pakeisti priesagą be jokio JavaScript pakeitimo. Kai kurie įrenginiai siunčia priešdėlį, simbologijos identifikatorių, pavyzdžiui ]C1, arba CR ir LF. Testuokite tris užbaigiklio nustatymus, kuriuos naudotojai iš tikrųjų gali pasirinkti: Enter, Tab ir nėra. Užrašykite, kurį naudoja įdiegti skaitytuvai, ir testuokite puslapį pagal tą nustatymą.
Brūkšninių kodų skaitytuvo įvesties tikrinimas
Tikrinkite eilutę, kurią gavo laukas. Nemanykite, kad kiekvienas brūkšninis kodas turi tą patį ilgį, ženklų rinkinį ar kontrolinę sumą. Code 128 ir QR turinys skiriasi. EAN-13 yra 13 skaitmenų. Programai, kuri saugo abu, reikia taisyklių abiem.
Tuščia įvestis. Atmeskite arba ignoruokite ją. Priesaga be turinio arba Look up spustelėjimas tuščiame lauke neturi sukurti įrašo.
Netikėti ženklai. Palyginkite gautą eilutę su žinoma etikete. Išdėstymo neatitiktis dažnai pasirodo kaip pakeistas simbolis, pavyzdžiui paslinktas skaitmuo ar skyryba, o ilgis lieka toks pat. Valdymo ženklai gali ateiti iš priešdėlio arba iš GS1 grupės skirtuko. Leiskite ženklus, kuriuos apibrėžia jūsų formatas. Aukščiau esantis pavyzdys atmeta ASCII valdymo ženklus, kad jie liktų matomi būsenos tekste. GS1 analizatorius, kuris tikisi grupės skirtuko, turėtų leisti tą ženklą ir atmesti kitus.
Ilgis. Taikykite ilgius, kuriuos priima programa. Bendras minimumas ir maksimumas yra saugesnis už vieną privalomą ilgį, kai forma gauna daugiau nei vieną simbologiją. maxlength įvestyje tyliai nukerpa ilgesnį turinį, todėl nustatykite jį tik tada, kai telpa kiekvienas priimamas kodas.
Priešdėlis. Šalinkite priešdėlį tik tada, kai sukonfigūravote skaitytuvą siųsti būtent tą priešdėlį, o programa jo nesaugo.
function withoutConfiguredPrefix(value, prefix) {
if (prefix && value.startsWith(prefix)) {
return value.slice(prefix.length)
}
return value
}
AIM simbologijos identifikatorius yra duomenys, jei skaitytuvas nustatytas jį perduoti. Palikite jį vietoje, kol nuspręsite, ar programa jį saugo.
Priesaga. Laikykite užbaigiklį už išsaugotos reikšmės ribų. Enter ir Tab yra klavišai. Jie neįterpiami į įprastą teksto įvestį. Nuoseklusis turinys vis tiek gali turėti CR arba LF baitus. Šalinkite juos ties riba, kur analizuojate nuoseklųjį srautą, ir patikrinkite, kad jų nešalinate iš turinio vidurio, kuriame jie teisėtai yra.
Dvigubi pateikimai. Vienas nuskaitymas gali būti apdorotas du kartus, jei ir keydown, ir submit suveikia tam pačiam Enter. Naudokite vieną užbaigimo kelią. Antras to paties kodo nuskaitymas yra kitas klausimas. Sandėlio forma gali didinti kiekį. Bilieto forma gali atmesti kodą, kuris jau panaudotas. Įdėkite tą taisyklę į programą ir testuokite ją tyčia. Naršyklė negali atskirti antro gaiduko paspaudimo nuo antro klausytojo.
Programos taisyklės. Kontrolinės sumos priklauso konkrečioms simbologijoms. EAN-13 naudoja paskutinį skaitmenį kaip kontrolinį skaitmenį. Ši funkcija priima tik tą 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 ir QR to skaičiavimo nenaudoja. Skaitytuvas jau gali būti patikrinęs savo simbologiją ir perdavęs žmogui skaitomus duomenis. Tikrinkite formatus, kuriuos saugote, ir pakartokite patikrą serveryje. Pateikta eilutė yra įprasta naudotojo įvestis. Naršyklė negali įrodyti, kad ją sukūrė skaitytuvas.
Brūkšninių kodų skaitytuvo įvesties testavimas be fizinės aparatūros
Barcode Scanner Emulator yra darbalaukio programa, skirta Windows, macOS ir Linux. Įvedate siunčiamą tekstą, pasirenkate rašymo delsą ir priesagą Nėra, ENTER arba TAB. Visuotinis spartusis klavišas įrašo tą tekstą į sufokusuotą programą. Jis atkartoja klaviatūros kelią, kurį naudoja pleišto skaitytuvas. Jis neapšviečia etiketės, neskaito simbolio ir nedekoduoja simbologijos.
Naudokite aukščiau esantį pavyzdžio puslapį arba puslapį, kurį kuriate:
- Atidarykite puslapį darbalaukio naršyklėje ir spustelėkite brūkšninio kodo lauką.
- Emuliatoriuje įveskite žinomą reikšmę, pavyzdžiui
123456789012. - Nustatykite priesagą į ENTER. Nustatykite rašymo delsą, jei norite, kad pliūpsnis primintų jau išmatuotą skaitytuvą.
- Paspauskite emuliatoriaus visuotinį nuskaitymo spartųjį klavišą, kol naršyklės laukas dar turi fokusą.
- Patvirtinkite būsenos tekstą ir tai, kad reikšmė priimta vieną kartą.
- Pakartokite su TAB. Fokusas turi pasislinkti, o reikšmė turi būti priimta vieną kartą.
- Pakartokite be priesagos. Tekstas turi likti lauke, kol suaktyvinsite Look up.
- Sufokusuokite brūkšninio kodo įvesties testerį ir vėl nusiųskite tą pačią reikšmę. Palyginkite užfiksuotą eilutę, priešdėlį ir priesagą su tuo, ką išsaugojo programa.
Diegimą ir pirmą spartųjį klavišą aprašo Darbo pradžia. Pakeitę nustatymą, nusiųskite vieną nuskaitymą į įvesties testerį, prieš pasitikėdami rezultatu programoje.
Aparatūra vis dar reikalinga optinėms ir įrenginiui būdingoms testo dalims:
- Ar tas skaitytuvas gali dekoduoti atspausdintą arba rodomą simbolį, įskaitant pažeistas etiketes, dydį, kontrastą ir atstumą.
- Simbologijos palaikymas. 1D lazerinis skaitytuvas negali nuskaityti QR kodo. Žr. QR kodo testavimas: kaip testuoti QR kodų skaitytuvus.
- USB surašymas, Bluetooth suporavimas ir paties skaitytuvo klaviatūros išdėstymas bei priesagos konfigūracija.
- Nuoseklioji, HID POS ir gamintojo SDK integracijos.
Emuliatorius yra tinkama priemonė programos logikai klaviatūros kelyje. Jis yra netinkama priemonė įrodyti, kad konkretus skaitytuvas nuskaito konkrečią etiketę.
Brūkšninių kodų skaitytuvo klaviatūros įvykių derinimas
Stebėkite įvykius šia tvarka, kai išsaugota reikšmė neteisinga.
keydown. Suveikia kiekvienam klavišui, įskaitant Enter ir Tab, prieš naršyklei įterpiant ženklą arba perkeliant fokusą. Užbaigiklį skaitykite čia. event.repeat yra teisingas, kai klavišas laikomas nuspaustas. Pleišto skaitytuvas paprastai siunčia atskirą paspaudimą kiekvienam ženklui.
input. Suveikia lauke po to, kai spausdinamas ženklas pakeičia jo reikšmę. Tai tinkamas įvykis, jei reikia teksto jam augant. Jis nesuveikia Enter ar Tab, nes tie klavišai neįterpia ženklo į teksto įvestį.
change. Suveikia po to, kai reikšmė patvirtinama, paprastai kai laukas praranda fokusą. Skaitytuvas, kuris palieka fokusą tame pačiame lauke, nuskaitymo pabaigoje nesukurs change. Nenaudokite change kaip vienintelio užbaigimo signalo.
event.key ir event.code. Registruokite abu, kai ženklas neteisingas. Neatitiktis tarp skaitytuvo išdėstymo ir operacinės sistemos išdėstymo keičia event.key ir palieka event.code atrodantį kaip klavišą, kurį skaitytuvas turėjo omenyje. Skaitmenų klaviatūros skaitmenys naudoja Numpad1 ir panašius kodus. Kai kurios įvesties kaukės juos traktuoja kitaip nei Digit1. Neteisingas brūkšninių kodų skaitytuvo klaviatūros išdėstymas paaiškina išdėstymo neatitiktį.
Fokusas. Registruokite document.activeElement iškart prieš nuskaitymą. Jei tai nėra brūkšninio kodo laukas, likusi pėdsako dalis aiškina neteisingą valdiklį. Iframe turi savo fokusą. Nuskaitymas į įdėtą rėmą matomas scenarijui to rėmo viduje.
Laikas. Skaitytuvai dažnai užbaigia trumpą turinį gerokai greičiau nei per sekundę. Įvesties testeris lygina vidutinį tarpą tarp ženklų su 100 ms slenksčiu ir pažymi rezultatą kaip laiką, o ne kaip aparatūros atpažinimą. Tarpo slenkstis gali laikyti greitą mašininką, automatinį pildymą arba emuliatorių skaitytuvu. Skaitytuvas su tarpu tarp ženklų, Bluetooth ryšiu arba ilgu turiniu gali atrodyti kaip rašymas. Naudokite užfiksuotą reikšmę ir priesagą. Laiką naudokite kaip užuominą.
Naudokite klaviatūros įvykių testerį. Jis išvardija kiekvieną keydown ir keyup su key, code, modifikatoriais ir laiko žymomis. Naudokite jį, kai surinkta eilutė slepia priešdėlio klavišą arba skaitmenų klaviatūros kodą. Žurnalas yra naršyklės įvykiai. Tai nėra neapdorotas USB srautas.
Dažnos problemos žiniatinklio programose
Nuskaitymas patenka į neteisingą lauką. Pleišto įvestis seka fokusą. Spustelėkite tikslinį lauką po kiekvienos navigacijos, dialogo ar tikrinimo pranešimo, kuris perkelia fokusą. Modalas be teksto lauko gali praryti nuskaitymą kaip sparčiuosius klavišus.
Skaitytuvas veikia tekstų rengyklėje, bet ne naršyklėje. Įrenginys rašo. Puslapis tų klavišų nepriima. Patikrinkite fokusą, išjungtą arba tik skaitomą įvestį ir keydown klausytoją, kuris kviečia preventDefault() spausdinamiems klavišams. Klausytojas, kuris apdoroja tik paste, niekada nemato pleišto įvesties. Pradėkite nuo Brūkšninių kodų skaitytuvas neveikia, jei jokia programa negauna ženklų.
Enter pateikia formą du kartus arba nukreipia kitur. Naršyklė pateikia formą, o jūsų klausytojas taip pat apdoroja Enter. Kvieskite preventDefault() viename iš tų kelių ir apdorokite reikšmę vieną kartą. Kelių laukų forma gali būti pateikta anksčiau, nei užpildomi vėlesni laukai, kai skaitytuvas siunčia Enter. Tai darbo eigai naudokite Tab arba neleiskite pateikti, kol forma neužbaigta.
Tab keičia fokusą. Tai Tab klavišas. Arba sukonfigūruokite Enter skaitytuve, arba skaitykite reikšmę per keydown ir leiskite fokuso perkėlimą. Žr. priesagų dalį aukščiau.
Klaviatūros išdėstymas neteisingas. Skaitmenys gali išlikti neatitiktyje, kuri keičia skyrybą. Nuskaitykite žinomą reikšmę, kurioje yra saugomi simboliai, išdėstymu, kurį darbo vieta iš tikrųjų naudoja.
Tas pats nuskaitymas sukuria du įrašus. Ieškokite dviejų klausytojų vienam Enter, prieš ieškodami dviejų fizinių nuskaitymų. Tada testuokite tyčinį antrą nuskaitymą ir patvirtinkite kiekio arba dublikato taisyklę, kurią dokumentuoja programa.
Reikšmės trūksta arba ji nukirsta. Atributas maxlength, įvesties kaukė arba preventDefault() ženklų klavišams gali atmesti arba nukirsti turinį. Palyginkite ženklų skaičių įvesties testeryje su reikšme savo lauke. Priešdėlis taip pat gali priversti teisingą turinį atrodyti per ilgą.
QR kodai niekada nepasirodo. Skaitytuvas gali būti tik 1D arba QR simbologija gali būti išjungta. Programa to neištaisys. Patvirtinkite aparatūrą su QR kodo testavimas: kaip testuoti QR kodų skaitytuvus, tada grįžkite prie lauko testo.
Žiniatinklio programos testavimo kontrolinis sąrašas
Naudokite jį kūrinyje, kurį ketinate išleisti, kiekvienoje palaikomoje naršyklėje. Patikrinkite ir šviežią profilį, ir profilį su slaptažodžių tvarkyklės bei automatinio pildymo plėtiniais, nes tie plėtiniai perkelia fokusą.
- Skaitytuvas prijungtas arba suporuotas, o kompiuteris rodo, kad jis pasirengęs.
- Skaitytuvas yra klaviatūros pleišto režimu, ne nuosekliuoju ar gamintojo SDK režimu.
- Brūkšninio kodo laukas sufokusuotas iškart prieš nuskaitymą.
document.activeElementyra tas laukas. - Žinomas brūkšninis kodas ateina ženklas po ženklo, įskaitant ilgį.
- ENTER priesaga pateikia arba priima reikšmę vieną kartą ir nepalieka užbaigiklio išsaugotoje eilutėje.
- TAB priesaga perkelia fokusą į numatytą kitą valdiklį, o reikšmė perskaitoma prieš perkėlimą.
- Konfigūracija be priesagos palieka reikšmę prieinamą, kol programa ją užbaigia.
- Tuščias pateikimas atmetamas arba ignoruojamas.
- Vienas nuskaitymas nesukuria dviejų įrašų. Antras tikras nuskaitymas laikosi programos dublikato taisyklės.
- Skyryba, simboliai ir bet kuris GS1 skirtukas, kurį naudoja jūsų formatai, išlieka visame kelyje.
- Skaitytuvo klaviatūros išdėstymas ir operacinės sistemos išdėstymas sukuria etiketėje atspausdintus ženklus.
- Atjungus ir vėl prijungus arba nutrūkus Bluetooth ryšiui, kitas nuskaitymas vis tiek pasiekia lauką.
- Keli nuskaitymai iš eilės lieka atskiromis reikšmėmis. Laukas jų nesujungia.
- Tos pačios patikros pavyksta palaikomose naršyklėse, su įprastais automatinio pildymo plėtiniais ir be jų.
Dialogams, tabuliavimo tvarkai per visą kasą ir POS kiekio eigoms tęskite su Kaip testuoti brūkšninių kodų skaitytuvo įvestį.
Testų atvejų matrica
Skaitytuvo stulpelis yra tai, ką daro įrenginys ir naršyklė. Laukiamos elgsenos stulpelis yra tai, ką programa turi daryti atsakydama. Verslo taisyklės, pavyzdžiui ar pakartotas prekės kodas padidina kiekį, priklauso programai. Nurodykite jas teste, užuot tarę vieną taisyklę kiekvienam produktui.
| Scenarijus | Laukiama elgsena |
|---|---|
| Galiojantis brūkšninis kodas | Programa priima reikšmę ir išsaugo turinį be užbaigiklio. |
| Tuščia įvestis | Programa ją atmeta arba ignoruoja ir nesukuria įrašo. |
| ENTER priesaga | Programa pateikia arba priima reikšmę vieną kartą. |
| TAB priesaga | Fokusas pereina į numatytą kitą valdiklį, o reikšmė išlaikoma. |
| Be priesagos | Įvestis lieka prieinama, kol programa ją apdoroja. |
| Greiti iš eilės nuskaitymai | Kiekviena reikšmė apdorojama atskirai ir neprijungiama prie ankstesnės. |
| Neteisingas klaviatūros išdėstymas | Netikėti ženklai matomi užfiksuotoje reikšmėje ir nepraeina tikrinimo. |
| Dubliuotas nuskaitymas | Programa laikosi savo dublikato taisyklės, pavyzdžiui padidina kiekį arba atmeta pakartojimą. |
| Negaliojantis brūkšninio kodo formatas | Programa parodo to formato tikrinimo klaidą ir neišsaugo reikšmės. |
| Prarastas įvesties fokusas | Programa neišgalvoja brūkšninio kodo. Nuskaitymo nėra arba jis patenka į sufokusuotą valdiklį, o puslapis lieka saugioje būsenoje. |
Galiojančią, tuščią, ENTER, TAB ir be priesagos eilutes vykdykite fiziniu skaitytuvu ir dar kartą emuliatoriumi. Klaviatūros išdėstymo, QR ir pakartotinio prijungimo eilutes vykdykite aparatūroje. Tos eilutės priklauso nuo įrenginio, etiketės arba operacinės sistemos išdėstymo, kurių imituoti klavišų paspaudimai neatkartoja.