Barcode Scanner Emulator
Paano subukan ang input ng QR code scanner sa mga web application
Maraming panlabas na scanner na may kakayahang QR ang gumagamit ng keyboard-wedge mode at nagta-type ng na-decode na tekstong QR sa field na may focus. Subukan ang landas na iyon sa pamamagitan ng pag-scan ng kilalang payload at paghahambing nito sa halagang natanggap ng page. Hindi lahat ng QR scanner ay nagta-type na parang keyboard. Ang mga serial device at camera decoder ay magkaibang integrasyon, at hindi tinutukoy ng mga keyboard event ng browser ang pisikal na scanner.
Ang QR code ay nag-iimbak ng data. Ginagawa ng scanner, o ng camera decoder, ang data na iyon na teksto. Kailangan ng web application na tanggapin ang tekstong iyon, magpasya kung kailan natapos ang scan, at patunayan ito. Ang gabay na ito ang pagsubok na iyon sa application. Ang paggawa ng mga label, ang pagsuri ng contrast, at ang pagkumpirma na kaya ng device na i-decode ang QR Code ay nasa Pagsubok ng QR code: paano subukan ang mga QR code scanner. Ang mga pangkalahatang form ng barcode, kasama ang mga check digit ng EAN, ay nasa Paano subukan ang mga barcode scanner sa mga web application.
Subukan ang input ng QR scanner sa loob ng 60 segundo
Gumamit ng payload na pinili mo, para halata ang maling karakter. Ginagamit ng walkthrough na ito ang QR-INPUT-TEST-12345.
- Buksan ang Generator ng QR code at gumawa ng QR code para sa
QR-INPUT-TEST-12345. Tumatakbo ang generator sa browser. Hindi ito kumokontak sa scanner. - Ikonekta ang scanner na may kakayahang QR na naka-set sa keyboard-wedge mode. Hindi ma-decode ng scanner na 1D lang ang simbolong ito.
- Buksan ang Tester ng barcode input.
- I-click ang Simulan ang pagsubok, o i-click ang scan area, para may focus ang field. Hindi kumukuha ng focus ang tester nang mag-isa, at hindi nito binubuksan ang scanner.
- I-scan ang QR code.
- Basahin ang nakuhang teksto at ang bilang ng karakter.
- Ihambing ang tekstong iyon sa
QR-INPUT-TEST-12345. Kasama sa tugma ang case, mga gitling, at haba. - Basahin ang hulapi. Inuulat ng tester ang ENTER, TAB, o Wala kapag nagpapadala ang scanner ng isa sa mga key na iyon.
Itinatala ng tester ang mga keyboard event na nakikita ng browser. Hindi nito tinutukoy ang USB device, binabasa ang serial port, o dine-decode ang imahe ng QR.
Mga mode ng input ng QR scanner
Ang parehong naka-print na QR code ay maaaring dumating sa tatlong magkakaibang integrasyon. Hindi sinasanay ng pagsubok sa isang mode ang iba.
Mga keyboard-wedge na QR scanner
Sa USB HID keyboard mode, o Bluetooth HID keyboard mode, tinatrato ng operating system ang scanner bilang keyboard. Pagkatapos ng decode, tina-type ng scanner ang payload sa control na may focus. Kayang tumanggap nito ng ordinaryong <input> o <textarea>. Hindi binubuksan ng page ang device. Inilalarawan ng gabay na HID keyboard wedge ang sequence ng keystroke, mga prefix, at mga hulapi.
Ang focus ang nagpapasya sa patutunguhan. Kung ang elementong may focus ay ang document body, isang button, o ibang frame, hindi nakikita ng mga listener ng field na ito ang scan.
Mga serial na QR scanner
Ang USB serial o virtual COM port scanner ay nagpapadala ng na-decode na teksto bilang mga byte sa prosesong nagbukas ng port. Hindi pinipili ng focus ang prosesong iyon. Nanatiling walang laman ang field na nakikinig lang sa mga keystroke habang ipinapakita ng terminal sa port na iyon ang payload.
Maaaring magbukas ang mga Chromium-based na browser ng port na pinili ng user gamit ang Web Serial API, sa secure context, pagkatapos ng user gesture. Hindi ibinibigay ng Firefox at Safari ang API na iyon. Hindi lumalabas ang wedge scanner bilang serial port. Ang mga pangalan ng port, baud, at framing ay nakadepende sa device at driver. Inihahambing ng USB HID laban sa serial barcode scanner ang dalawang interface. Hindi mabasa ng Tester ng barcode input ang COM port.
Camera-based na pag-scan ng QR
Kumukuha ng imahe ang camera integration at dine-decode ang QR code sa software. Gumagamit ang page ng camera API at decoder. Hindi ito tumatanggap ng mga event na keydown para sa payload. Ang mga phone-camera app, ang mga button ng camera sa page, at ang hardware imager na nagta-type sa field ay tatlong magkakaibang produkto. Hindi nangangahulugan ang pagpasa sa wedge test na gumagana ang button ng camera, at hindi nangangahulugan ang matagumpay na camera decode na ita-type ng wedge scanner ang parehong string.
Kunin ang input ng QR scanner gamit ang JavaScript
Binabasa ng page sa ibaba ang isang field na may focus. Isinusumite ng Enter ang form, at ginagamit ng button na Accept ang parehong submit handler, kaya isang beses na pinoproseso ang isang scan. Kapag walang hulaping ENTER, nananatili ang teksto sa field hanggang may mag-activate ng Accept. Isinusulat ang nakuhang payload gamit ang textContent, kaya nananatiling nakikita bilang teksto ang mga karakter gaya ng <.
Tumatanggap ang halimbawa ng tatlong format ng application: isang ticket id gaya ng QR-INPUT-TEST-12345, isang URL na http o https, o isang JSON object. Itinatala nito ang na-scan na teksto. Hindi ito nagna-navigate sa URL na nasa QR code. Gumagana pa rin sa button ang scanner na hindi nagpapadala ng Enter. Gumagalaw ang Tab sa label, sa field, at sa button gaya ng dati, dahil hindi ito hinuhuli ng script.
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>QR input example</title>
</head>
<body>
<form id="qr-form">
<label for="qr">QR payload</label>
<input id="qr" name="qr" type="text" autocomplete="off" spellcheck="false">
<button type="submit">Accept</button>
</form>
<p id="status" role="status"></p>
<pre id="captured"></pre>
<script>
const form = document.querySelector('#qr-form')
const field = document.querySelector('#qr')
const status = document.querySelector('#status')
const captured = document.querySelector('#captured')
if (
!(form instanceof HTMLFormElement) ||
!(field instanceof HTMLInputElement) ||
!(status instanceof HTMLElement) ||
!(captured instanceof HTMLElement)
) {
throw new Error('QR form markup is missing.')
}
const accepted = new Set()
function classify(raw) {
if (/[\u0000-\u001F\u007F]/.test(raw)) {
return { status: 'invalid', message: 'Control character in the QR payload.' }
}
const value = raw.trim()
if (!value) {
return { status: 'empty' }
}
if (value.length > 2048) {
return { status: 'invalid', message: 'QR payload is longer than this form accepts.' }
}
if (/^QR-[A-Z0-9-]{1,64}$/.test(value)) {
return { status: 'ok', value }
}
if (value.startsWith('{')) {
try {
const data = JSON.parse(value)
if (!data || typeof data !== 'object' || Array.isArray(data)) {
return { status: 'invalid', message: 'QR JSON must be an object.' }
}
return { status: 'ok', value }
} catch {
return { status: 'invalid', message: 'QR text is not valid JSON.' }
}
}
if (value.startsWith('http://') || value.startsWith('https://')) {
try {
const url = new URL(value)
if (url.protocol !== 'http:' && url.protocol !== 'https:') {
return { status: 'invalid', message: 'Only http and https URLs are accepted.' }
}
return { status: 'ok', value }
} catch {
return { status: 'invalid', message: 'The QR text is not a valid URL.' }
}
}
return { status: 'invalid', message: 'Unexpected QR payload.' }
}
form.addEventListener('submit', (event) => {
event.preventDefault()
const outcome = classify(field.value)
if (outcome.status === 'empty') {
status.textContent = 'No QR payload received.'
field.focus()
return
}
if (outcome.status === 'invalid') {
status.textContent = outcome.message
captured.textContent = ''
field.focus()
return
}
if (accepted.has(outcome.value)) {
status.textContent = 'Already accepted ' + outcome.value
field.value = ''
field.focus()
return
}
accepted.add(outcome.value)
captured.textContent = outcome.value
status.textContent = 'Accepted ' + outcome.value
field.value = ''
field.focus()
})
</script>
</body>
</html>
I-save ang file at buksan ito sa desktop browser. I-click ang field bago mag-scan. Binabawasan ng autocomplete="off" ang posibilidad na palitan ng naka-save na halaga ang scan. Nanatiling available ang label at ang button, kaya maaaring mag-type ng payload ang isang tao nang walang scanner.
Hawakan ang Enter sa event na submit ng form lamang. Nirerekord ng pangalawang listener na keydown para sa Enter ang parehong scan nang dalawang beses. Pinapanatili ng preventDefault() ang browser sa page na ito. Burahin ang field pagkatapos ng desisyon para hindi idugtong ng susunod na scan ang teksto sa nauna.
Maaaring maglaman ng line break ang QR payload. Madalas itong tina-type ng wedge scanner bilang Enter. Sa one-line input, maaaring mag-submit ang form sa unang linya at iwanan ang iba. Gumamit ng textarea, o ng serial reader na nagpapanatili ng mga byte, kapag kailangang tumanggap ang application ng multi-line na teksto. Kumpirmahin ang kilos na iyon gamit ang QR code na may newline sa payload.
Paghawak ng mga QR payload
Hindi nangangako ang QR symbol ng format ng application. Maaaring dalhin ng parehong symbology ang alinman sa mga ito:
- Plain text, gaya ng
QR-INPUT-TEST-12345. - Isang URL.
- Isang identifier na pinili ng application.
- Isang structured payload gaya ng ticket number at location code.
- Tekstong JSON, kapag tinukoy ng application ang encoding na iyon.
Ipinapadala ng scanner ang mga na-decode na karakter. Hindi nito sinusuri na tumutugma ang mga ito sa ticket rule, product catalog, o JSON schema. Patunayan ang string sa page, at patunayan itong muli sa server. Ang naka-post na halaga ay ordinaryong user input. Hindi mapatunayan ng browser na scanner ang gumawa nito.
Patunayan ang QR input
Huwag ipagpalagay na numeric ang QR payload. Hindi nalalapat ang mga patakaran ng EAN-13. Ituring ang teksto bilang hindi pinagkakatiwalaan: ipakita ito bilang teksto, at huwag itong italaga sa location, innerHTML, o script URL.
Walang lamang halaga. Ang Enter na walang laman, o ang Accept sa blankong field, ay hindi dapat gumawa ng record. Tinatanggihan din ng trim() ang payload na mga espasyo lamang.
Hindi inaasahang karakter. Ihambing ang natanggap na string sa kilalang nilalaman ng QR. Madalas na binabago ng hindi tugmang keyboard layout ang punctuation habang nananatili ang haba. Tanggihan ang mga karakter na hindi pinapayagan ng format, at ipakita ang dahilan sa status text.
Haba ng payload. Ipatupad ang maximum na iniimbak ng application. Pinuputol ng maxlength sa input ang mas mahabang scan nang walang error. Itakda ito lamang kapag kasya ang bawat tinatanggap na payload, at ihambing ang bilang ng karakter ng tester sa field kapag mukhang maikli ang halaga.
Mga kinakailangang prefix. Pag-aari ng application ang prefix check. Tumatanggap ang ticket rule na ito ng QR- kasama ang malalaking titik, digit, at gitling:
function isTicketId(value) {
return /^QR-[A-Z0-9-]{1,64}$/.test(value)
}
Alisin ang prefix ng scanner lamang kapag naka-configure ang scanner na iyon na magpadala ng isang eksaktong prefix at hindi ito itinatabi ng application. Data ang AIM symbology identifier hanggang magpasya ka nang iba.
Mga format na partikular sa application. Panatilihin ang rule sa tabi ng format. Kailangan ng ticket form, URL allow-list, at JSON object ng magkakaibang pagsusuri. Tatanggihan ng isang numeric pattern ang balidong tekstong QR.
Mga duplicate na scan. Maaaring tamaan ng isang pisikal na scan ang dalawang listener. Gumamit ng iisang completion path, gaya ng ginagawa ng halimbawa. Hiwalay na event ang pangalawang trigger pull. Tinatanggihan ng halimbawa ang payload na tinanggap na nito. Maaaring dagdagan ng warehouse form ang quantity. Subukan ang rule na idinodokumento ng application.
Maling JSON. Nagti-throw ang JSON.parse sa hindi kumpletong teksto. Suriin ang hugis pagkatapos ng matagumpay na parse. Maaaring balidong JSON ang array o ang hubad na numero at mali pa rin ang uri:
function readJsonObject(value) {
try {
const data = JSON.parse(value)
if (!data || typeof data !== 'object' || Array.isArray(data)) {
return { ok: false, message: 'QR JSON must be an object.' }
}
return { ok: true, data }
} catch {
return { ok: false, message: 'QR text is not valid JSON.' }
}
}
Hindi inaasahang URL. I-parse ang URL upang makita kung magagamit ito, pagkatapos ay panatilihin ang na-scan na string kung kailangang tumugma nang eksakto ang pagsubok sa QR payload. Maaaring magdagdag ang URL.href ng slash o magbago ng encoding. Tanggapin lamang ang mga scheme na nilalayon ng application. Huwag buksan ang URL bilang side effect ng scan:
function readWebUrl(value) {
let url
try {
url = new URL(value)
} catch {
return { ok: false, message: 'The QR text is not a valid URL.' }
}
if (url.protocol !== 'http:' && url.protocol !== 'https:') {
return { ok: false, message: 'Only http and https URLs are accepted.' }
}
return { ok: true, value }
}
Mga control character. Tanggihan ang mga ASCII control character sa keyboard payload para manatiling nakikita sa status text ang nakatagong prefix. Ang CR at LF ay mga control character. Sa wedge scanner, ang Enter at Tab ay mga key. Hindi sila karakter sa loob ng normal na text input. Maaari pa ring maglaman ang serial payload ng mga byte na 0x0D o 0x0A. Alisin ang mga iyon sa hangganan ng serial framing, at huwag alisin ang CR na kabilang sa gitna ng multi-line na payload.
Mga hulaping ENTER at TAB
Opsyonal na configuration ng scanner ang hulapi. Hindi ito bahagi ng simbolo ng QR. Ipinapakita ng Mga hulaping ENTER laban sa TAB sa mga barcode scanner kung paano paghiwalayin ang mga key. Basahin ang hulapi sa input tester, pagkatapos ay itugma ang page sa mga scanner na dine-deploy mo.
ENTER isinusumite ang form ng one-line text field sa mga kasalukuyang browser. Gamitin iyon kapag dapat i-commit ng isang scan ang halaga. Tawagin ang preventDefault() sa submit kapag dapat manatili sa lugar ang page.
TAB inililipat ang focus sa susunod na control. Basahin ang halaga sa keydown habang may focus pa ang field. Iwanan ang default action kapag dapat tumanggap ng focus ang susunod na field. Balewalain ang Shift+Tab para makagalaw pabalik ang gumagamit ng keyboard.
Walang hulapi iniiwan ang payload sa field. Ang button na Accept sa halimbawa ang completion path. Maaaring hulaan ng inactivity timer na ang paghinto ay nangangahulugang natapos ang scan. Heuristic ang timer na iyon: parehong maaaring tumawid sa parehong agwat ang mabagal na Bluetooth burst at ang mabilis na typist. Mas gusto ang naka-configure na hulapi kapag kailangan ng workflow ng tiyak na wakas.
CR at LF ay mga byte. Ang keyboard Enter ay event.key === "Enter". Hindi sila mapagpapalit. Hindi makikita ng listener na nag-aalis lang ng \r sa input value ang wedge Enter, dahil hindi kailanman naipasok ang karakter. Hindi hahatiin ng listener na nanonood lang ng event.key ang serial buffer sa 0x0D. May mga device na nagpapadala ng NumPad Enter. event.key ay "Enter" pa rin. Suriin ang event.key, hindi lang ang event.code === "Enter".
Maaaring magbago ang hulapi kapag may nag-scan ng configuration barcode mula sa manual ng device. Subukang muli ang Enter, Tab, at walang hulapi pagkatapos ng anumang pagbabago sa configuration. Huwag gumawa ng programming barcode. Gamitin ang manual para sa modelong iyon.
I-debug ang mga keyboard event
Kapag mali ang nakaimbak na teksto, suriin ang mga event sa ganitong pagkakasunod.
keydown. Nagfi-fire para sa bawat key, kasama ang Enter at Tab, bago magpasok ang browser ng karakter o maglipat ng focus. Basahin dito ang terminator.
input. Nagfi-fire pagkatapos baguhin ng printable na karakter ang field. Hindi ito nagfi-fire para sa Enter o Tab sa text input.
event.key. Ang karakter o pangalan ng key pagkatapos ilapat ng operating system ang keyboard layout.
event.code. Ang pisikal na key, gaya ng Digit1 o Numpad1. Maaari itong manatiling pareho kapag binago ng hindi tugmang layout ang event.key.
Focus. I-log ang document.activeElement bago ang scan. Kung hindi ito ang QR field, inilalarawan ng iba pang trace ang maling control. May sariling focus ang iframe.
Pagkakasunod. Para sa wedge scan sa text field, sinusundan ang mga printable na event na keydown ng mga update na input, pagkatapos ay huling keydown para sa Enter o Tab kapag naka-configure ang hulaping iyon. Nagfi-fire ang change kapag nagko-commit ang field, karaniwan sa blur. Hindi gumagawa ng change sa dulo ang scan na nag-iiwan ng focus sa parehong field. Huwag gamitin ang change bilang tanging completion signal.
Timing. Madalas na tinatapos ng mga scanner ang maikling payload nang mas mababa sa isang segundo. Inihahambing ng input tester ang average na agwat ng mga karakter sa threshold na 100 ms at nilalagyan ng label ang resulta bilang timing, hindi bilang pagkilala sa hardware. Maaaring mapunta sa panig ng scanner ng threshold na iyon ang mabilis na typist, autofill, o ang emulator. Maaaring magmukhang pag-type ang naantalang Bluetooth scan. I-assert ang payload at ang hulapi. Ituring ang timing bilang palatandaan.
Inililista ng Tester ng keyboard event ang bawat keydown at keyup kasama ang key, code, mga modifier, at mga timestamp. Ang log ay mga event ng browser. Hindi ito hilaw na USB traffic.
Subukan nang walang pisikal na QR scanner
Masusubok ang lohika ng application bago nasa mesa ang scanner.
- I-type ang
QR-INPUT-TEST-12345sa field at i-activate ang Accept. Sinusuri nito ang pagpapatunay at ang display. Hindi nito sinusuri ang decode o ang mga hulapi. - Patakbuhin ang parehong field mula sa browser automation tool, gaya ng ginagawa ng susunod na seksyon.
- Gamitin ang Barcode Scanner Emulator kapag kailangan mo ng pag-type na parang scanner. Nagpapadala ang desktop app ng halagang inilagay mo, na may typing delay at hulaping wala, ENTER, o TAB, sa application na may focus. Nire-reproduce nito ang landas ng keyboard. Hindi ito kumukuha ng litrato ng imahe ng QR, nagde-decode ng simbolo, o gumagawa ng virtual na COM port.
Kailangan pa rin ang hardware para sa optical at device na kilos: kung nababasa ng scanner na iyon ang ipinapakitang o naka-print na code, kung naka-enable ang QR symbology, keyboard layout, configuration ng hulapi, at mga mode na serial o vendor SDK. Ang emulator ang tamang pagsusuri para sa landas ng keyboard. Mali itong pagsusuri para patunayan na binabasa ng device ang isang partikular na QR code.
I-automate ang mga pagsubok ng QR input
Pinapatakbo ng mga sumusunod na Playwright test ang halimbawang page. Nagta-type ang mga ito sa field sa paraang gagawin ng wedge scanner, pagkatapos ay ina-assert ang kilos ng application. Hindi sila nagbubukas ng mga USB device. Dependency ng mambabasa ang @playwright/test. Hindi ito kailangan ng site na ito.
I-save ang halimbawang HTML bilang qr-form.html sa tabi ng test na ito.
import { readFileSync } from 'node:fs'
import { expect, test } from '@playwright/test'
const html = readFileSync(new URL('./qr-form.html', import.meta.url), 'utf8')
async function openForm(page) {
await page.setContent(html)
}
test('accepts a known QR payload once', async ({ page }) => {
await openForm(page)
const field = page.getByLabel('QR payload')
await field.pressSequentially('QR-INPUT-TEST-12345')
await field.press('Enter')
await expect(page.getByRole('status')).toHaveText('Accepted QR-INPUT-TEST-12345')
await expect(page.locator('#captured')).toHaveText('QR-INPUT-TEST-12345')
})
test('rejects an unexpected payload', async ({ page }) => {
await openForm(page)
const field = page.getByLabel('QR payload')
await field.pressSequentially('not-a-ticket')
await field.press('Enter')
await expect(page.getByRole('status')).toHaveText('Unexpected QR payload.')
await expect(page.locator('#captured')).toBeEmpty()
})
test('commits on ENTER and rejects a duplicate scan', async ({ page }) => {
await openForm(page)
const field = page.getByLabel('QR payload')
await field.pressSequentially('QR-INPUT-TEST-12345')
await field.press('Enter')
await field.pressSequentially('QR-INPUT-TEST-12345')
await field.press('Enter')
await expect(page.getByRole('status')).toHaveText('Already accepted QR-INPUT-TEST-12345')
await expect(page.locator('#captured')).toHaveText('QR-INPUT-TEST-12345')
})
test('does not capture keys while the field is unfocused', async ({ page }) => {
await openForm(page)
await page.getByRole('button', { name: 'Accept' }).focus()
await page.keyboard.type('QR-INPUT-TEST-12345')
await expect(page.getByLabel('QR payload')).toHaveValue('')
await expect(page.locator('#captured')).toBeEmpty()
await expect(page.getByRole('status')).toHaveText('')
})
test('shows unexpected characters as text', async ({ page }) => {
await openForm(page)
const payload = '<img src=x onerror=alert(1)>'
const field = page.getByLabel('QR payload')
await field.fill(payload)
await page.getByRole('button', { name: 'Accept' }).click()
await expect(page.getByRole('status')).toHaveText('Unexpected QR payload.')
await expect(page.locator('#captured img')).toHaveCount(0)
await expect(page.locator('img')).toHaveCount(0)
})
Ipinapasok ng pressSequentially ang mga karakter sa field na may focus. Hindi ito USB gadget. Ginagamit ng unexpected-character test ang fill dahil ang layunin ay ang validation message at ang kawalan ng injected na element. Palawakin ang file ng URL case at JSON case kapag nasa build na ipinapadala mo ang mga format na iyon. Dapat ihambing ng URL assertion ang nakuhang teksto sa orihinal na string ng QR.
Matrix ng pagsubok ng QR scanner
Patakbuhin ang mga ito laban sa application na sinusubok. Sinasaklaw ng sample page sa itaas ang mga row ng ticket, URL, JSON, duplicate, empty, at unexpected character. Kailangan ng numeric-only o multi-line na application ng sarili nitong inaasahang resulta.
| Scenario | Inaasahang resulta |
|---|---|
| Plain text QR | Eksaktong halaga ang natanggap. |
| URL QR | Nakuhan ang buong URL, at hindi nagna-navigate ang page dito. |
| Numeric QR | Napanatili ang mga digit. |
| Mga espesyal na karakter | Natanggap ang tamang mga karakter. |
| JSON payload | Nakuha at napatunayan ang data. |
| Hulaping ENTER | Isang beses na nangyayari ang pagproseso. |
| Hulaping TAB | Nahawakan ang kilos ng focus. |
| Walang hulapi | Gumagamit ang application ng alternatibong completion mechanism. |
| Duplicate na scan | Inilalapat ng application ang mga patakaran sa duplicate. |
| Hindi balidong payload | Ipinapakita ang validation error. |
| Nawawalang focus | Ligtas na hinahawakan ng application ang absent na input. |
| Mahabang payload | Walang hindi sinasadyang pagputol. |
Mag-scan din ng payload na may newline kung kailangang mag-imbak ang produkto ng isa. Itala kung natanggap ng field ang bawat linya.
Pag-troubleshoot
Magsimula sa kilalang payload sa input tester. Kung mali na ang halaga ng tester, hindi ang page ang unang sira. Kung tama ang halaga ng tester at mali ang application, ang sira ay focus, pagpapatunay, o paghawak ng event. Ang Hindi gumagana ang barcode scanner ang mas malawak na checklist ng device. Sinasaklaw ng Paano subukan ang input ng barcode scanner ang focus, layout, at mga workflow ng POS na lampas sa form na ito.
Tumunog ang scanner pero walang lumalabas na input
Karaniwang nangangahulugan ang beep na na-decode ng scanner ang simbolo. Hindi ito nangangahulugan na natanggap ng page ang teksto. Kumpirmahin ang keyboard-wedge mode. Hindi magta-type sa field ang mga serial at camera mode. I-click ang field para ang document.activeElement ay ang input na iyon, pagkatapos ay mag-scan muli. Maaaring balewalain ng disabled, read-only, o nakatagong field ang mga key.
Gumagana ang QR scanner sa Notepad pero hindi sa browser
Nagta-type ang device. Hindi tinatanggap ng page ang mga key na iyon. Suriin ang focus, ang listener na keydown na tumatawag ng preventDefault() sa mga printable na key, at ang listener na paste lang ang hinahawakan. Hindi nagfi-fire ng paste event ang wedge input. Ihambing ang resulta ng tester sa field ng application.
Nagbabasa ang scanner ng mga barcode pero hindi ng mga QR code
Maaaring 1D lang ang device, o maaaring naka-disable ang QR symbology. Hindi ito maaayos ng page. Kumpirmahin ang suportang 2D at i-enable ang QR Code mula sa manual ng device, gamit ang mga pagsusuri sa Pagsubok ng QR code: paano subukan ang mga QR code scanner. Ang matagumpay na scan ng Code 128 ay nagpapatunay lamang ng landas ng keyboard.
Maling mga karakter
I-scan muna ang QR-INPUT-TEST-12345. Kung tumutugma iyon at hindi ang URL o JSON payload, binabago ng layout ang punctuation gaya ng :, /, {, o ". Ihambing ang event.key sa event.code sa Tester ng keyboard event, at tingnan ang Maling keyboard layout ng barcode scanner. Itugma ang keyboard layout ng scanner sa operating system.
Dalawang beses isinusumite ng ENTER ang form
Isinusumite ng browser ang form, at hinahawakan din ng listener na keydown ang Enter. Panatilihin ang isang completion path at tawagin doon ang preventDefault(). Ibang pagkabigo ang pangalawang pisikal na scan. Sinasabi ng status text sa halimbawa na tinanggap na ang payload. Kung ang unang scan mismo ay gumagawa ng dalawang record, hanapin ang dalawang listener bago baguhin ang scanner.
Pinuputol ang QR input
Ihambing ang bilang ng karakter sa input tester sa halaga sa field. Maaaring putulin ng attribute na maxlength, ng input mask, o ng preventDefault() sa mga character key ang string. Maaaring mag-submit nang maaga ng one-line input ang newline sa loob ng QR payload. Nililimitahan din ng ilang scanner kung ilang karakter ang tina-type nila. Itaas ang limitasyong iyon mula sa manual ng device kapag ang tester, hindi lang ang application, ang nagpapakita ng maikling halaga. Sinasaklaw ng Nawawalang ENTER ng barcode scanner ang kaugnay na kaso kung saan dumarating ang payload at hindi kailanman nagko-commit ang form.
Hindi mabasa ng scanner ang QR code sa screen
Kumpirmahing 2D imager ang scanner. Itataas ang liwanag ng display, palakihin ang code, at panatilihing malinis sa teksto at border ang quiet zone. Optical na problema ang glare, ang madilim na screen ng telepono, at ang code na masyadong siksik para sa working distance. I-print ang parehong payload kung patuloy na nabibigo ang pagbasa sa screen. Ginagamit pa rin ng pagsubok sa application ang kilalang string kapag may scan nang gumawa ng teksto.