Barcode Scanner Emulator
Paano subukan ang mga barcode scanner sa mga web application
Maraming USB at Bluetooth barcode scanner ang nagpapadala ng na-decode na data bilang keyboard input, kaya ang field na may focus sa isang web application ay maaaring tumanggap ng scan nang walang browser API na para lang sa scanner. Ang mga serial port at vendor SDK ay hiwalay na integrasyon. Masusubok ang landas ng keyboard gamit ang pisikal na scanner o gamit ang ginayang mga keystroke.
Karaniwang nakikita ng web application ang barcode scanner bilang keyboard. Ang sinusubok ay kung natatanggap ng control na may focus ang payload na inaasahan ng application, at kung hinahawakan ng page ang terminator na naka-configure sa scanner. Ang terminator na iyon ay maaaring Enter, Tab, o wala.
Gamitin ang isang session ng Tester ng barcode input kapag nakakabit ang pisikal na scanner. Gamitin ang Barcode Scanner Emulator kapag kailangan ang parehong landas ng keyboard habang nagde-develop at wala sa mesa ang hardware. Ang mas malawak na pagsusuri sa focus, layout, at mga workflow ng POS ay nasa Paano subukan ang input ng barcode scanner. Nanatili ang gabay na ito sa application sa browser: pagkuha, mga hulapi, pagpapatunay, at mga event na talagang makikita.
Paano nakikipag-ugnayan ang mga barcode scanner sa mga web application
Ang mode ng interface ang nagpapasya kung ano ang matatanggap ng page. Kumpirmahin ito bago baguhin ang code ng form. Kadalasang nakakapagpalit ng mode ang scanner sa pamamagitan ng pag-scan ng configuration barcode mula sa manwal ng tagagawa.
USB HID keyboard wedge
Sa USB HID keyboard mode, nag-e-enumerate ang scanner bilang keyboard. Niloload ng operating system ang karaniwang keyboard driver nito. Pagkatapos i-decode ng scanner ang isang simbolo, ipinapadala nito ang mga character bilang mga keystroke sa control na may keyboard focus. Nakikinig ang page sa mga keystroke na iyon, o binabasa ang text na ipinasok ng mga ito. Hindi nagbubukas ang page ng koneksyon sa device.
Dahil sa landas na iyon, ang field ng checkout, isang search box, o anumang ibang text input ay maaaring tumanggap ng scan gamit ang ordinaryong HTML. Sinasaklaw nang mas detalyado ng gabay na HID keyboard wedge ang pagkakasunod ng keystroke, mga prefix, at mga hulapi.
Bluetooth HID
Ang Bluetooth scanner na naka-pair bilang keyboard ay gumagamit ng parehong landas ng application. Itinuturing ito ng host bilang HID keyboard, at tinatanggap ng field na may focus ang mga keystroke. Ang pag-pair, baterya, at radyo ay usapin ng device. Kapag dumating na ang mga character sa browser, hinahawakan ng page ang mga ito gaya ng paghawak nito sa USB wedge input.
Serial at virtual COM port
Ang serial scanner, kabilang ang maraming USB virtual COM port mode, ay nagpapadala ng na-decode na text bilang mga byte sa isang port. Hindi pinipili ng focus ang patutunguhan. Ang prosesong nagbubukas ng port ang pumipili. Hindi makikita ng text field na nakikinig lang sa mga keystroke ang stream na iyon.
Maaaring magbukas ng serial port ang mga browser na batay sa Chromium sa pamamagitan ng Web Serial API pagkatapos piliin ng user ang port at magbigay ng pahintulot. Hindi ibinibigay ng Firefox at Safari ang API na iyon. Hindi sinasanay ng wedge test ang isang serial integration, at hindi sinasabi ng serial test kung ano ang iti-type ng wedge scanner.
Mga interface na partikular sa vendor
May mga device na gumagamit ng vendor SDK, OPOS, JPOS, o hindi-keyboard na HID interface gaya ng USB HID POS. Hindi nagta-type ang mga interface na iyon sa field na may focus. Hindi makakapag-load ng native SDK ang karaniwang web page. Maaaring humiling ang Chromium ng ilang hindi-keyboard na HID device sa pamamagitan ng WebHID pagkatapos ng kilos ng user. Nananatiling naka-block ang mga keyboard-class na HID device, kaya hindi maibukod ang wedge scanner mula sa keyboard. Ituring ang vendor interface bilang sarili nitong integrasyon at subukan ito gamit ang software na talagang nagbubukas ng interface na iyon.
Ano ang nakikita ng browser
Dumarating ang wedge scan bilang mga event na keydown at keyup, at ina-update ng mga napi-print na character ang field na may focus. Hindi tumatanggap ang browser ng pangalan ng device, USB serial number, o flag na nagsasabing scanner ito. Tinatanggihan pa rin ng mga browser na may WebHID ang mga keyboard interface, kaya hindi rin mabasa ng script ng page ang hilaw na HID report ng wedge scanner.
Ang event.key ay ang character o pangalan ng key pagkatapos ilapat ng operating system ang aktibong keyboard layout. Pinangalanan ng event.code ang pisikal na key, gaya ng Digit1 o Numpad1, at maaari itong manatiling pareho kapag binago ng hindi tugmang layout ang event.key. Hindi kinikilala ng alinmang property ang hardware.
Paano subukan ang pisikal na barcode scanner sa browser
Gawin ito bago i-debug ang code ng application. Ipinapakita nito ang eksaktong string at terminator na natanggap ng browser.
- Ikonekta ang scanner at hintayin hanggang ipakita nitong may power. Para sa Bluetooth, tapusin ang pag-pair at kumpirmahing gumagamit ang host ng keyboard profile.
- Kumpirmahin ang input mode. Ang keyboard wedge, USB HID keyboard, o Bluetooth HID keyboard ay maaaring mag-type sa isang field. Hindi magagawa iyon ng serial, SPP, at vendor-SDK mode.
- Buksan ang Tester ng barcode input.
- I-click ang Simulan ang pagsubok, o i-click ang scan area. Nagiging asul ito kapag handa na. Hindi kumukuha ng focus ang page nang mag-isa.
- Mag-scan ng barcode na alam mo na ang payload. Magsimula sa maikling numerong halaga, tapos mag-scan ng halagang may bantas na iniimbak ng application.
- Basahin ang nakuhang halaga at ang bilang ng character. Ihambing ang dalawa sa payload na inaasahan, kasama ang anumang prefix na ipinapasok ng scanner bago ang data.
- Suriin ang hulapi. Inuulat ng tester ang ENTER, TAB, o Wala. Kapag naka-on ang Awtomatikong pagkuha, lumalabas ang resulta pagkatapos ng Enter, Tab, o maikling paghinto kapag tumigil ang mga key. I-off ang Awtomatikong pagkuha kapag gusto mong manatili ang pagkuha hanggang pindutin mo ang Ihinto.
- Ihambing ang resultang iyon sa string na dapat itabi ng application. Ang prefix, napalitang character, o nawawalang terminator ay dapat ayusin sa configuration ng scanner o sadyang hawakan sa page. Huwag ituring itong pagkabigo sa pag-decode hanggang matapos ang paghahambing na ito.
Itinatala ng tester ang mga keyboard event na nakikita ng browser. Hindi nito matukoy ang USB device at hindi nito mabasa ang serial port. Kapag natanggap ng text editor ang scan at hindi ng browser, magpatuloy sa Gumagana ang scanner sa Notepad pero hindi sa POS.
Kunin ang input ng barcode scanner gamit ang JavaScript
Nagta-type ang scanner sa elementong may focus. Bigyan ang field ng nakikitang label, iwanan itong karaniwang text input para makapag-type ng code ang mga gumagamit ng keyboard, at basahin ang halaga kapag sinabi ng workflow na tapos na ang entry. Ginagawa iyon ng page sa ibaba. Isinusumite ng Enter ang form nang isang beses. Kinukumpleto ng Tab ang hindi walang halaga at pagkatapos ay hinahayaan ang browser na ilipat ang focus. Ang scan na walang terminator ay nananatili sa field hanggang may mag-activate ng 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-save ang file na iyon at buksan ito sa desktop browser. I-click ang field kung lumipat na ang focus. Ang wedge scanner, o ang emulator sa susunod na seksyon, ay magta-type pagkatapos sa #barcode.
Kailangan ang focus. Kung ang document.activeElement ay ang body ng dokumento, isang button, o ibang input, hindi nakikita ng mga listener ng field na ito ang scan. Napupunta ang mga character sa control na may focus, o nawawala. Tawagin ang field.focus() kapag handa na ang workflow para sa scan, kasama na pagkatapos magsara ng dialog.
Binabalewala ang walang laman na input. Nanatili ang form, at sinasabi ng status text na walang natanggap. Ang whitespace lang ay walang laman pagkatapos ng trim().
Hindi nagdaragdag ng Enter o Tab ang halimbawang ito. Kung hindi naka-configure ang scanner na ipadala ang mga iyon, nananatili ang halaga sa field at ang Look up ang landas ng pagkumpleto. Binabawasan ng autocomplete="off" ang tsansang palitan ng naka-save na halaga ang scan. Nananatiling magagamit ang label, ang button, at ang Shift+Tab, kaya maaaring maglagay ng code ang isang tao nang walang scanner.
Hawakan ang Enter sa isang lugar. Ginagamit ng halimbawang ito ang event na submit ng form, na sumasaklaw din sa button na Look up at sa keyboard Enter. Ang pangalawang listener na keydown para sa Enter ay magtatala ng parehong scan nang dalawang beses. Kung wala sa loob ng form ang input, makinig para sa Enter sa keydown at tawagin ang preventDefault() para hindi rin mag-submit ang ancestor form:
field.addEventListener('keydown', (event) => {
if (event.key !== 'Enter') {
return
}
event.preventDefault()
const value = field.value.trim()
if (!value) {
return
}
console.log(value)
field.value = ''
})
Linisin ang field pagkatapos ng matagumpay na pagtanggap para hindi idugtong ng susunod na scan ang sarili sa nakaraang payload. Pagkatapos ng Enter, muling fini-focus ng halimbawa ang parehong field dahil inaasahan ng workflow na iyon ang isa pang scan sa parehong kahon. Pagkatapos ng Tab, hinahayaan nito ang focus para makalipat ang browser sa susunod na control.
Paghawak sa mga hulaping ENTER at TAB
Ang hulapi ay key na maaaring ipadala ng scanner pagkatapos ng payload. Setting ito ng device. Karaniwan ang Enter, at opsiyonal ito. Inilalarawan ng gabay na Mga hulaping ENTER laban sa TAB sa mga barcode scanner kung paano pag-ibahin ang mga terminator. Kumpirmahin ang setting sa scanner na sinusubok, tapos itugma ang page sa workflow na iyon.
ENTER
Ang Enter sa loob ng one-line na text field ay nagsu-submit ng nakapalibot na form sa mga kasalukuyang browser. Gamitin iyon kapag dapat ikumpirma ng isang scan ang halaga, gaya ng lookup box. Pinipigilan ng preventDefault() sa event na submit ang browser na umalis sa page. Huwag itong ilagay kapag ang buong page navigation ang kilos na gusto mo.
Kung lumitaw ang barcode at walang ginagawa ang form, maaaring walang ipinapadalang hulapi ang scanner. Tinutunton ng Nawawalang ENTER ng barcode scanner ang configuration na iyon. May mga device na nagpapadala ng NumPad Enter. Ang event.key ay "Enter" pa rin. Suriin ang event.key, huwag lang ang event.code === "Enter", kung hindi ay magmumukhang sira ang scanner na iyon.
TAB
Inililipat ng Tab ang focus sa susunod na control na puwedeng ma-focus. Angkop iyon sa pagkakasunod gaya ng product code, tapos dami. Nagugulat dito ang form na umasang magsu-submit ang Enter.
Basahin ang halaga sa keydown habang may focus pa ang field. Inililipat ng browser ang focus pagkatapos ng event na iyon. Iwanan ang default na kilos kapag dapat tumanggap ng focus ang susunod na control. Pinapanatili ng preventDefault() ang focus kung nasaan, na kapaki-pakinabang kapag hindi wasto ang halaga at gusto mong makita ito ng operator. Balewalain ang Shift+Tab para makabalik ang gumagamit ng keyboard sa form. Ang Tab hulapi ng scanner ay Tab na walang Shift.
Maaari ring ilipat ng Tab hulapi ang focus bago mabasa ng code ang field, kung nasa blur o change ang listener at may iba pang naglilinis ng control. Basahin ang halaga mula sa target ng event na keydown.
Walang hulapi
Kapag walang hulapi, nakaupo ang payload sa field. Kailangang magpasya ang application kung kailan tapos ang scan. Ang tahasang button, ang susunod na Enter mula sa operator, o ang paglipat sa ibang hakbang ay maaasahang punto ng pagkumpleto. Maaaring ituring ng inactivity timer ang paghinto sa pag-type bilang katapusan ng scan. Heuristic ang timer na iyon. Ang mabagal na scanner, ang pagkaantala ng Bluetooth, o ang taong mabilis mag-type ay maaaring mapunta sa maling panig ng threshold. Mas gusto ang naka-configure na hulapi kapag kailangan ng workflow ng matibay na senyales ng katapusan ng scan.
Mga pagkakaiba sa configuration
Maaaring lumabas ang mga scanner ng iisang brand na may magkakaibang hulapi, at maaaring baguhin ng configuration barcode ang hulapi nang walang pagbabago sa JavaScript. May mga device na nagpapadala ng prefix, symbology identifier gaya ng ]C1, o CR at LF. Subukan ang tatlong setting ng terminator na talagang mapipili ng mga user: Enter, Tab, at wala. Itala kung alin ang ginagamit ng mga naka-deploy na scanner, at subukan ang page laban sa setting na iyon.
Pagpapatunay ng input ng barcode scanner
Patunayan ang string na natanggap ng field. Huwag ipagpalagay na pare-pareho ang haba, character set, o checksum ng bawat barcode. Nag-iiba ang mga payload ng Code 128 at QR. 13 digit ang EAN-13. Ang application na nag-iimbak ng dalawa ay nangangailangan ng mga panuntunan para sa dalawa.
Walang laman na input. Tanggihan o balewalain ito. Ang hulaping walang payload, o ang pag-click sa Look up sa blankong field, ay hindi dapat gumawa ng record.
Hindi inaasahang character. Ihambing ang natanggap na string sa kilalang label. Madalas lumitaw ang hindi tugmang layout bilang nabagong simbolo, gaya ng na-shift na digit o bantas, habang nananatili ang haba. Maaaring manggaling ang mga control character sa prefix o sa GS1 group separator. Payagan ang mga character na tinutukoy ng format mo. Tinatanggihan ng halimbawa sa itaas ang mga ASCII control character para manatili silang nakikita sa status text. Ang GS1 parser na umaasang may group separator ay dapat payagan ang character na iyon at tanggihan ang iba.
Haba. Ipatupad ang mga habang tinatanggap ng application. Mas ligtas ang pandaigdigang minimum at maximum kaysa sa isang kinakailangang haba kapag tumatanggap ang form ng higit sa isang symbology. Tahimik na puputulin ng maxlength sa input ang mas mahabang payload, kaya itakda lang ito kapag kasya ang bawat tinatanggap na code.
Prefix. Alisin ang prefix lang kapag na-configure mo ang scanner na ipadala ang eksaktong prefix na iyon at hindi ito iniimbak ng application.
function withoutConfiguredPrefix(value, prefix) {
if (prefix && value.startsWith(prefix)) {
return value.slice(prefix.length)
}
return value
}
Data ang AIM symbology identifier kung nakatakda ang scanner na ipadala ito. Iwanan ito hanggang magpasya ka kung iimbak ito ng application.
Hulapi. Ilayo ang terminator sa iniimbak na halaga. Mga key ang Enter at Tab. Hindi sila ipinapasok sa karaniwang text input. Maaari pa ring may mga byte na CR o LF ang serial payload. Alisin ang mga iyon sa hangganan kung saan hinuhulag ang serial stream, at subukang hindi mo sila inaalis sa gitna ng payload na lehitimong naglalaman ng mga ito.
Dobleng pagsusumite. Maaaring mahawakan nang dalawang beses ang isang scan kung parehong tumatakbo ang keydown at submit para sa iisang Enter. Gumamit ng iisang landas ng pagkumpleto. Ibang tanong ang pangalawang scan ng parehong code. Maaaring dagdagan ng warehouse form ang dami. Maaaring tanggihan ng ticket form ang code na na-redeem na. Ilagay ang panuntunang iyon sa application, at subukan ito nang sadya. Hindi masasabi ng browser ang pangalawang hatak ng trigger mula sa pangalawang listener.
Mga panuntunan ng application. Ang mga checksum ay para sa partikular na symbology. Ginagamit ng EAN-13 ang huling digit bilang check digit. Ang function na ito ay tumatanggap lang ng format na iyon:
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])
}
Hindi ginagamit ng Code 128, Code 39, at QR ang kalkulasyong iyon. Maaaring nasuri na ng scanner ang sarili nitong symbology at naipadala ang data na nababasa ng tao. Patunayan ang mga format na iniimbak mo, at ulitin ang pagsusuri sa server. Ang ipinost na string ay ordinaryong input ng user. Hindi mapatunayan ng browser na scanner ang gumawa nito.
Pagsubok ng input ng barcode scanner nang walang pisikal na hardware
Ang Barcode Scanner Emulator ay desktop app para sa Windows, macOS, at Linux. Ilalagay mo ang text na ipapadala, pipili ng typing delay, at pipili ng hulaping wala, ENTER, o TAB. Nagta-type ang global shortcut ng text na iyon sa application na may focus. Nire-reproduce nito ang landas ng keyboard na ginagamit ng wedge scanner. Hindi nito iniilawan ang label, binabasa ang simbolo, o dine-decode ang symbology.
Gamitin ang halimbawang page sa itaas, o ang page na binubuo mo:
- Buksan ang page sa desktop browser at i-click ang barcode field.
- Sa emulator, maglagay ng kilalang halaga gaya ng
123456789012. - Itakda ang hulapi sa ENTER. Itakda ang typing delay kung gusto mong kamukha ng burst ang scanner na nasukat mo na.
- Pindutin ang global scan shortcut ng emulator habang may focus pa ang field sa browser.
- Kumpirmahin ang status text at na tinanggap ang halaga nang isang beses.
- Ulitin gamit ang TAB. Dapat lumipat ang focus, at dapat tanggapin ang halaga nang isang beses.
- Ulitin nang walang hulapi. Dapat manatili ang text sa field hanggang i-activate mo ang Look up.
- I-focus ang Tester ng barcode input at ipadala muli ang parehong halaga. Ihambing ang nakuhang string, prefix, at hulapi sa itinabi ng application.
Ang pag-install at ang unang shortcut ay nasa Pagsisimula. Pagkatapos magbago ng setting, magpadala ng isang scan sa input tester bago pagkatiwalaan ang resulta sa application.
Kailangan pa rin ang hardware para sa optical at device-specific na bahagi ng pagsubok:
- Kung made-decode ng scanner na iyon ang naka-print o ipinapakitang simbolo, kasama ang sirang label, laki, contrast, at distansya.
- Suporta sa symbology. Hindi makakabasa ng QR code ang 1D laser scanner. Tingnan ang Pagsubok ng QR code: paano subukan ang mga QR code scanner.
- USB enumeration, Bluetooth pairing, at ang sariling keyboard-layout at suffix configuration ng scanner.
- Mga integrasyon ng serial, HID POS, at vendor SDK.
Ang emulator ang tamang tool para sa logic ng application sa landas ng keyboard. Mali itong tool para patunayan na binabasa ng isang partikular na scanner ang isang partikular na label.
Pag-debug ng mga keyboard event ng barcode scanner
Panoorin ang mga event sa ganitong pagkakasunod kapag mali ang naka-tabing halaga.
keydown. Pumuputok para sa bawat key, kasama ang Enter at Tab, bago magpasok ng character o maglipat ng focus ang browser. Dito basahin ang terminator. True ang event.repeat kapag pinipigilan ang isang key. Karaniwang nagpapadala ang wedge scanner ng hiwalay na pindot para sa bawat character.
input. Pumuputok sa field pagkatapos baguhin ng napi-print na character ang halaga nito. Ito ang tamang event na panoorin kung kailangan ang text habang lumalaki ito. Hindi ito pumuputok para sa Enter o Tab, dahil hindi nagpapasok ng character sa text input ang mga key na iyon.
change. Pumuputok pagkatapos ma-commit ang halaga, karaniwan kapag nawalan ng focus ang field. Ang scanner na nag-iiwan ng focus sa parehong field ay hindi gagawa ng change sa dulo ng scan. Huwag gamitin ang change bilang tanging senyales ng pagkumpleto.
event.key at event.code. I-log ang dalawa kapag mali ang isang character. Binabago ng hindi pagkakatugma ng layout ng scanner at ng operating system ang event.key at iniiwan ang event.code na mukhang key na nilayon ng scanner. Ang mga digit mula sa numeric keypad ay gumagamit ng Numpad1 at mga katulad na code. Iba ang turing ng ilang input mask sa mga iyon kumpara sa Digit1. Ipinapaliwanag ng Maling keyboard layout ng barcode scanner ang hindi pagkakatugma ng layout.
Focus. I-log ang document.activeElement kaagad bago ang scan. Kung hindi iyon ang barcode field, ang iba pang bakas ay nagpapaliwanag ng maling control. May sariling focus ang mga iframe. Ang scan papunta sa naka-embed na frame ay nakikita ng script sa loob ng frame na iyon.
Timing. Madalas natatapos ng mga scanner ang maikling payload nang mas maikli kaysa isang segundo. Inihahambing ng input tester ang average na agwat ng mga character sa threshold na 100 ms at nilalagyan ng label ang resulta bilang timing, hindi bilang pagkilala sa hardware. Maaaring ituring ng agwat na threshold ang mabilis mag-type, ang autofill, o ang emulator bilang scanner. Ang scanner na may pagitan sa pagitan ng mga character, isang Bluetooth link, o mahabang payload ay maaaring magmukhang pagta-type. Gamitin ang nakuhang halaga at ang hulapi. Gamitin ang timing bilang palatandaan.
Inililista ng Tester ng keyboard event ang bawat keydown at keyup kasama ang key, code, mga modifier, at mga timestamp. Gamitin ito kapag tinatago ng nabuong string ang isang prefix key o isang numpad code. Ang log ay mga event ng browser. Hindi ito hilaw na USB traffic.
Mga karaniwang problema sa mga web application
Napupunta ang scan sa maling field. Sumusunod ang wedge input sa focus. I-click ang target na field pagkatapos ng bawat navigation, dialog, o mensahe ng pagpapatunay na naglilipat ng focus. Ang modal na walang text field ay maaaring lunukin ang scan bilang mga shortcut key.
Gumagana ang scanner sa text editor at hindi sa browser. Nagta-type ang device. Hindi tinatanggap ng page ang mga key na iyon. Suriin ang focus, ang disabled o read-only na input, at ang listener na keydown na tumatawag ng preventDefault() sa mga napi-print na key. Hindi kailanman nakikita ng listener na paste lang ang hinahawakan ang wedge input. Magsimula sa Hindi gumagana ang barcode scanner kung walang application na tumatanggap ng mga character.
Dalawang beses isinusumite ng Enter ang form o umaalis sa page. Isinusumite ng browser ang form, at hinahawakan din ng listener mo ang Enter. Tawagin ang preventDefault() sa isa sa mga landas na iyon at iproseso ang halaga nang isang beses. Maaaring mag-submit ang form na maraming field bago mapunan ang mga susunod na field kapag nagpapadala ng Enter ang scanner. Gamitin ang Tab para sa workflow na iyon, o pigilan ang pag-submit hanggang kumpleto ang form.
Binabago ng Tab ang focus. Iyon ang Tab key. I-configure ang Enter sa scanner, o basahin ang halaga sa keydown at payagan ang paglipat ng focus. Tingnan ang seksyon ng hulapi sa itaas.
Mali ang keyboard layout. Maaaring manatili ang mga digit sa hindi pagkakatugmang nagbabago ng bantas. Mag-scan ng kilalang halagang may mga simbolong iniimbak mo, sa layout na talagang ginagamit ng workstation.
Dalawang record ang ginagawa ng parehong scan. Hanapin ang dalawang listener sa isang Enter bago humanap ng dalawang pisikal na scan. Pagkatapos ay subukan ang sadyang pangalawang scan at kumpirmahin ang panuntunan sa dami o sa duplicate na dokumentado ng application.
Nawawala o napuputol ang halaga. Ang attribute na maxlength, isang input mask, o ang preventDefault() sa mga character key ay maaaring maghulog o magputol ng payload. Ihambing ang bilang ng character sa input tester sa halaga sa field mo. Maaari ring magmukhang masyadong mahaba ang tamang payload dahil sa prefix.
Hindi kailanman lumalabas ang mga QR code. Maaaring 1D lang ang scanner, o maaaring naka-off ang QR symbology. Hindi ito maaayos ng application. Kumpirmahin ang hardware gamit ang Pagsubok ng QR code: paano subukan ang mga QR code scanner, tapos bumalik sa pagsubok ng field.
Checklist ng pagsubok ng web application
Gamitin ito sa build na balak mong ilabas, sa bawat browser na sinusuportahan mo. Suriin ang bagong profile at ang profile na may mga extension ng password manager at autofill, dahil inililipat ng mga extension na iyon ang focus.
- Nakakonekta o naka-pair ang scanner, at ipinapakita ng host na handa ito.
- Nasa keyboard-wedge mode ang scanner, hindi serial o vendor SDK mode.
- May focus ang barcode field kaagad bago ang scan. Ang
document.activeElementay ang field na iyon. - Dumarating ang kilalang barcode nang character por character, kasama ang haba.
- Isinusumite o tinatanggap ng hulaping ENTER ang halaga nang isang beses at hindi iniiwan ang terminator sa naka-tabing string.
- Inililipat ng hulaping TAB ang focus sa susunod na control na nilalayon mo, at nababasa ang halaga bago ang paglipat.
- Iniiwan ng configuration na walang hulapi ang halaga hanggang kumpletuhin ito ng application.
- Tinatanggihan o binabalewala ang walang laman na pagsusumite.
- Hindi gumagawa ng dalawang record ang isang scan. Sinusunod ng pangalawang tunay na scan ang panuntunan sa duplicate ng application.
- Nanatili ang bantas, mga simbolo, at anumang GS1 separator na ginagamit ng mga format mo pagkatapos ng round trip.
- Nagbubunga ang keyboard layout ng scanner at ang layout ng operating system ng mga character na naka-print sa label.
- Pagkatapos tanggalin at ikonekta muli, o pagkatapos bumagsak ang Bluetooth link, umaabot pa rin sa field ang susunod na scan.
- Nanatiling magkakahiwalay na halaga ang ilang magkakasunod na scan. Hindi pinagdurugtong ng field ang mga ito.
- Pumapasa ang parehong mga pagsusuri sa mga browser na sinusuportahan mo, may at walang karaniwang autofill extension.
Para sa mga dialog, tab order sa buong checkout, at mga daloy ng dami sa POS, magpatuloy sa Paano subukan ang input ng barcode scanner.
Matrix ng mga test case
Ang column ng scanner ay ang ginagawa ng device at ng browser. Ang column ng inaasahang kilos ay ang dapat gawin ng application bilang tugon. Ang mga panuntunan sa negosyo, gaya ng kung dinadagdagan ng paulit-ulit na product code ang dami, ay sa application. Sabihin ang mga ito sa pagsubok sa halip na ipagpalagay ang iisang panuntunan para sa bawat produkto.
| Sitwasyon | Inaasahang kilos |
|---|---|
| Wastong barcode | Tinatanggap ng application ang halaga at itinatabi ang payload nang walang terminator. |
| Walang laman na input | Tinatanggihan o binabalewala ito ng application at hindi gumagawa ng record. |
| Hulaping ENTER | Isinusumite o tinatanggap ng application ang halaga nang isang beses. |
| Hulaping TAB | Lumilipat ang focus sa nilalayong susunod na control, at pinananatili ang halaga. |
| Walang hulapi | Nananatiling magagamit ang input hanggang iproseso ito ng application. |
| Mabilis na magkakasunod na scan | Pinoproseso nang hiwalay ang bawat halaga at hindi idinudugtong sa nauna. |
| Maling keyboard layout | Nakikita ang mga hindi inaasahang character sa nakuhang halaga at nabibigo ang pagpapatunay. |
| Dobleng scan | Sinusunod ng application ang sarili nitong panuntunan sa duplicate, gaya ng pagdagdag ng dami o pagtanggi sa replay. |
| Hindi wastong format ng barcode | Ipinapakita ng application ang error sa pagpapatunay para sa format na iyon at hindi itinatabi ang halaga. |
| Nawawalang input focus | Hindi gumagawa ang application ng barcode. Wala ang scan o napupunta ito sa control na may focus, at nananatili ang page sa ligtas na estado. |
Patakbuhin ang mga row na wasto, walang laman, ENTER, TAB, at walang hulapi gamit ang pisikal na scanner at muli gamit ang emulator. Patakbuhin ang mga row ng keyboard layout, QR, at muling pagkonekta sa hardware. Nakasalalay ang mga row na iyon sa device, sa label, o sa layout ng operating system, na hindi nire-reproduce ng ginayang mga keystroke.