Barcode Scanner Emulator
Hoe om QR-kodeskandeerderinvoer in webtoepassings te toets
Baie eksterne QR-bekwame skandeerders gebruik sleutelbordwigmodus en tik die gedekodeerde QR-teks in die gefokusde veld. Toets daardie pad deur ’n bekende loonvrag te skandeer en dit met die waarde te vergelyk wat die bladsy ontvang het. Nie elke QR-skandeerder tik soos ’n sleutelbord nie. Serietoestelle en kameradekodeerders is verskillende integrasies, en blaaier-sleutelbordgebeure identifiseer nie die fisiese skandeerder nie.
’n QR-kode stoor data. Die skandeerder, of ’n kameradekodeerder, verander daardie data in teks. Die webtoepassing moet dan daardie teks ontvang, besluit wanneer die skandering klaar is, en dit valideer. Hierdie gids is daardie toepassingstoets. Die genereer van etikette, die nagaan van kontras, en die bevestiging dat ’n toestel QR Code kan dekodeer, word gedek in QR-kodetoetsing: hoe om QR-kodeskandeerders te toets. Algemene strepieskodevorms, insluitend EAN-kontrolesyfers, word gedek in Hoe om strepieskodeskandeerders in webtoepassings te toets.
Toets QR-skandeerderinvoer in 60 sekondes
Gebruik ’n loonvrag wat jy gekies het, sodat ’n verkeerde karakter opvallend is. Hierdie deurloop gebruik QR-INPUT-TEST-12345.
- Maak die QR-kodegenerator oop en genereer ’n QR-kode vir
QR-INPUT-TEST-12345. Die generator loop in die blaaier. Dit kontak nie die skandeerder nie. - Koppel ’n QR-bekwame skandeerder wat op sleutelbordwigmodus gestel is. ’n Skandeerder wat net 1D lees, kan nie hierdie simbool dekodeer nie.
- Maak die Strepieskode-invoertoetser oop.
- Klik Begin toets, of klik die skandeerarea, sodat die veld fokus het. Die toetser neem nie self fokus nie, en dit maak nie die skandeerder oop nie.
- Skandeer die QR-kode.
- Lees die vasgevange teks en die karaktertelling.
- Vergelyk daardie teks met
QR-INPUT-TEST-12345. Die passing sluit kas, koppeltekens en lengte in. - Lees die agtervoegsel. Die toetser rapporteer ENTER, TAB of Geen wanneer die skandeerder een van daardie sleutels stuur.
Die toetser teken sleutelbordgebeure aan wat die blaaier kan sien. Dit identifiseer nie die USB-toestel nie, lees nie ’n seriepoort nie, en dekodeer nie die QR-beeld nie.
QR-skandeerderinvoermodi
Dieselfde gedrukte QR-kode kan deur drie verskillende integrasies aankom. ’n Toets van een modus oefen nie die ander nie.
Sleutelbordwig-QR-skandeerders
In USB HID-sleutelbordmodus, of Bluetooth HID-sleutelbordmodus, behandel die bedryfstelsel die skandeerder as ’n sleutelbord. Ná ’n dekodering tik die skandeerder die loonvrag in watter kontrole ook al fokus het. ’n Gewone <input> of <textarea> kan dit ontvang. Die bladsy maak nie die toestel oop nie. Die gids HID-sleutelbordwig beskryf die toetsaanslagvolgorde, voorvoegsels en agtervoegsels.
Fokus besluit die bestemming. As die gefokusde element die dokumentliggaam, ’n knoppie of ’n ander raam is, sien hierdie veld se luisteraars nie die skandering nie.
Reeks-QR-skandeerders
’n USB-reeks- of virtuele COM-poortskandeerder stuur die gedekodeerde teks as grepe na die proses wat die poort oopgemaak het. Fokus kies nie daardie proses nie. ’n Veld wat net na toetsaanslae luister, bly leeg terwyl ’n terminaal op daardie poort die loonvrag wys.
Chromium-gebaseerde blaaiers kan ’n gebruikergekose poort met die Web Serial API oopmaak, in ’n veilige konteks, ná ’n gebruikergebaar. Firefox en Safari verskaf nie daardie API nie. ’n Wigskandeerder verskyn nie as ’n seriepoort nie. Poortname, baud en raming hang van die toestel en drywer af. USB HID teenoor reeks-strepieskodeskandeerders vergelyk die twee koppelvlakke. Die Strepieskode-invoertoetser kan nie ’n COM-poort lees nie.
Kameragebaseerde QR-skandering
’n Kameraintegrasie vang ’n beeld en dekodeer die QR-kode in sagteware. Die bladsy gebruik ’n kamera-API en ’n dekodeerder. Dit ontvang nie keydown-gebeure vir die loonvrag nie. Foonkamera-toepassings, kameraknoppies op die bladsy, en ’n hardewarebeelder wat in ’n veld tik, is drie verskillende produkte. Om ’n wigtoets te slaag, beteken nie dat die kameraknoppie werk nie, en ’n suksesvolle kameradekodering beteken nie dat ’n wigskandeerder dieselfde string sal tik nie.
Vang QR-skandeerderinvoer met JavaScript
Die bladsy hieronder lees een gefokusde veld. Enter dien die vorm in, en die Accept-knoppie gebruik dieselfde indieningshanteerder, sodat een skandering een keer verwerk word. Sonder ’n ENTER-agtervoegsel bly die teks in die veld totdat iemand Accept aktiveer. Die vasgevange loonvrag word met textContent geskryf, sodat karakters soos < as teks sigbaar bly.
Die voorbeeld aanvaar drie toepassingsformate: ’n kaartjie-id soos QR-INPUT-TEST-12345, ’n http- of https-URL, of ’n JSON-objek. Dit teken die geskandeerde teks aan. Dit navigeer nie na ’n URL in die QR-kode nie. ’n Skandeerder wat geen Enter stuur nie, werk steeds deur die knoppie. Tab beweeg soos gewoonlik deur die etiket, die veld en die knoppie, omdat die skrip dit nie vang nie.
<!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>
Stoor die lêer en maak dit in ’n lessenaarblaaier oop. Klik die veld voordat jy skandeer. autocomplete="off" verminder die kans dat ’n gestoorde waarde die skandering vervang. Die etiket en die knoppie bly beskikbaar, sodat ’n persoon ’n loonvrag sonder ’n skandeerder kan tik.
Hanteer Enter net in die vorm se submit-gebeurtenis. ’n Tweede keydown-luisteraar vir Enter teken dieselfde skandering twee keer aan. preventDefault() hou die blaaier op hierdie bladsy. Maak die veld ná ’n besluit skoon sodat die volgende skandering nie by die vorige teks aanlas nie.
’n QR-loonvrag kan ’n reëlbreuk bevat. ’n Wigskandeerder tik daardie breuk dikwels as Enter. In ’n eenreëlinvoer kan die vorm by die eerste reël indien en die res laat val. Gebruik ’n textarea, of ’n reeksleser wat die grepe behou, wanneer die toepassing meerlynige teks moet aanvaar. Bevestig daardie gedrag met ’n QR-kode waarvan die loonvrag ’n nuwe reël insluit.
Hantering van QR-loonvragte
’n QR-simbool belowe nie ’n toepassingsformaat nie. Dieselfde simbologie kan enige van hierdie dra:
- Gewone teks, soos
QR-INPUT-TEST-12345. - ’n URL.
- ’n identifiseerder wat die toepassing gekies het.
- ’n gestruktureerde loonvrag soos ’n kaartjienommer plus ’n liggingkode.
- JSON-teks, wanneer die toepassing daardie enkodering gedefinieer het.
Die skandeerder stuur die gedekodeerde karakters. Dit kontroleer nie dat hulle by ’n kaartjiereël, ’n produkkatalogus of ’n JSON-skema pas nie. Valideer die string op die bladsy, en valideer dit weer op die bediener. Die gepose waarde is gewone gebruikerinvoer. Die blaaier kan nie bewys dat ’n skandeerder dit voortgebring het nie.
Valideer QR-invoer
Moenie aanneem dat ’n QR-loonvrag numeries is nie. EAN-13-reëls geld nie. Behandel die teks as onvertroud: vertoon dit as teks, en ken dit nie aan location, innerHTML of ’n skrip-URL toe nie.
Leë waardes. ’n Kaal Enter, of Accept op ’n leë veld, behoort nie ’n rekord te skep nie. trim() verwerp ook ’n loonvrag wat net spasies is.
Onverwagte karakters. Vergelyk die ontvangde string met die bekende QR-inhoud. ’n Sleutelborduitleg wat nie pas nie, verander dikwels leestekens terwyl die lengte dieselfde bly. Verwerp karakters wat die formaat nie toelaat nie, en wys die rede in die statusteks.
Loonvraglengte. Dwing die maksimum af wat jou toepassing stoor. maxlength op die invoer kap ’n langer skandering af sonder ’n fout. Stel dit net wanneer elke aanvaarde loonvrag pas, en vergelyk die toetser se karaktertelling met die veld wanneer ’n waarde kort lyk.
Vereiste voorvoegsels. ’n Voorvoegselkontrole behoort aan die toepassing. Hierdie kaartjiereël aanvaar QR- plus hoofletters, syfers en koppeltekens:
function isTicketId(value) {
return /^QR-[A-Z0-9-]{1,64}$/.test(value)
}
Stroop ’n skandeerdervoorvoegsel net wanneer daardie skandeerder opgestel is om een presiese voorvoegsel te stuur en die toepassing dit nie stoor nie. ’n AIM-simbologie-identifiseerder is data totdat jy anders besluit.
Toepassingspesifieke formate. Hou die reël langs die formaat. ’n Kaartjievorm, ’n URL-toelaatlys en ’n JSON-objek het verskillende kontroles nodig. Een numeriese patroon sal geldige QR-teks verwerp.
Duplikaatskanderings. Een fisiese skandering kan twee luisteraars tref. Gebruik ’n enkele voltooiingspad, soos die voorbeeld doen. ’n Tweede snellertrek is ’n afsonderlike gebeurtenis. Die voorbeeld verwerp ’n loonvrag wat dit reeds aanvaar het. ’n Pakhuisvorm kan eerder ’n hoeveelheid verhoog. Toets die reël wat jou toepassing dokumenteer.
Misvormde JSON. JSON.parse gooi op onvolledige teks. Kontroleer die vorm ná ’n suksesvolle ontleding. ’n Skikking of ’n kaal getal kan geldige JSON wees en steeds die verkeerde tipe wees:
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.' }
}
}
Onverwagte URL’s. Ontleed die URL om te sien of dit bruikbaar is, en hou dan die geskandeerde string as die toets presies by die QR-loonvrag moet pas. URL.href kan ’n skuinsstreep byvoeg of enkodering verander. Aanvaar net die skemas wat die toepassing bedoel. Moenie die URL as ’n newe-effek van die skandering oopmaak nie:
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 }
}
Beheerkarakters. Verwerp ASCII-beheerkarakters in ’n sleutelbordloonvrag sodat ’n versteekte voorvoegsel in die statusteks sigbaar bly. CR en LF is beheerkarakters. Op ’n wigskandeerder is Enter en Tab sleutels. Hulle is nie karakters binne ’n normale teksinvoer nie. ’n Reeksloonvrag kan steeds 0x0D- of 0x0A-grepe bevat. Stroop dié by die reeksramingsgrens, en verwyder nie ’n CR wat in die middel van ’n meerlynige loonvrag hoort nie.
ENTER- en TAB-agtervoegsels
’n Agtervoegsel is opsionele skandeerderopstelling. Dit is nie deel van die QR-simbool nie. ENTER- teenoor TAB-agtervoegsels in strepieskodeskandeerders wys hoe om die sleutels uitmekaar te ken. Lees die agtervoegsel in die invoertoetser, en laat dan die bladsy by die skandeerders pas wat jy ontplooi.
ENTER dien ’n eenreël-teksveld se vorm in huidige blaaiers in. Gebruik dit wanneer een skandering die waarde moet vaslê. Roep preventDefault() op submit wanneer die bladsy in plek moet bly.
TAB skuif fokus na die volgende kontrole. Lees die waarde in keydown terwyl die veld nog fokus het. Los die verstekaksie wanneer die volgende veld fokus moet ontvang. Ignoreer Shift+Tab sodat ’n sleutelbordgebruiker agteruit kan beweeg.
Geen agtervoegsel laat die loonvrag in die veld. Die Accept-knoppie in die voorbeeld is die voltooiingspad. ’n Onaktiwiteitstydhouer kan raai dat ’n pouse beteken die skandering het geëindig. Daardie tydhouer is ’n heuristiek: ’n stadige Bluetooth-stuwing en ’n vinnige tikker kan albei dieselfde gaping oorsteek. Verkies ’n opgestelde agtervoegsel wanneer die werkvloei ’n harde einde nodig het.
CR en LF is grepe. ’n Sleutelbord-Enter is event.key === "Enter". Dié is nie uitruilbaar nie. ’n Luisteraar wat net \r uit ’n invoerwaarde stroop, sal nie ’n wig-Enter sien nie, omdat die karakter nooit ingevoeg is nie. ’n Luisteraar wat net event.key dophou, sal nie ’n reeksbuffer op 0x0D verdeel nie. Sommige toestelle stuur NumPad Enter. event.key is steeds "Enter". Kontroleer event.key, nie net event.code === "Enter" nie.
Die agtervoegsel kan verander wanneer iemand ’n opstellingstrepieskode uit die toestelhandleiding skandeer. Hertoets Enter, Tab en geen agtervoegsel ná enige opstellingsverandering. Moenie ’n programmeringstrepieskode uitdink nie. Gebruik die handleiding vir daardie model.
Ontfout sleutelbordgebeure
Wanneer die gestoorde teks verkeerd is, inspekteer die gebeure in hierdie volgorde.
keydown. Vuur vir elke sleutel, insluitend Enter en Tab, voordat die blaaier ’n karakter invoeg of fokus skuif. Lees die afsluiter hier.
input. Vuur nadat ’n drukbare karakter die veld verander. Dit vuur nie vir Enter of Tab op ’n teksinvoer nie.
event.key. Die karakter of sleutelnaam nadat die bedryfstelsel die sleutelborduitleg toepas.
event.code. Die fisiese sleutel, soos Digit1 of Numpad1. Dit kan dieselfde bly wanneer ’n uitleg wat nie pas nie event.key verander.
Fokus. Teken document.activeElement aan voor die skandering. As dit nie die QR-veld is nie, beskryf die res van die spoor die verkeerde kontrole. ’n iframe het sy eie fokus.
Volgorde. Vir ’n wigskandering in ’n teksveld word drukbare keydown-gebeure deur input-bywerkings gevolg, dan ’n finale keydown vir Enter of Tab wanneer daardie agtervoegsel opgestel is. change vuur wanneer die veld vaslê, gewoonlik by blur. ’n Skandering wat fokus in dieselfde veld laat, lewer nie change aan die einde nie. Moenie change as die enigste voltooiingsein gebruik nie.
Tydsberekening. Skandeerders voltooi dikwels ’n kort loonvrag in heelwat minder as ’n sekonde. Die invoertoetser vergelyk die gemiddelde gaping tussen karakters met ’n drempel van 100 ms en benoem die resultaat as tydsberekening, nie as hardeware-identifikasie nie. ’n Vinnige tikker, outovul of die emulator kan aan die skandeerderkant van daardie drempel beland. ’n Vertraagde Bluetooth-skandering kan soos tik lyk. Beweer die loonvrag en die agtervoegsel. Behandel tydsberekening as ’n leidraad.
Die Sleutelbordgebeurtenistoetser lys elke keydown en keyup met key, code, wysigers en tydstempels. Die log is blaaiergebeure. Dit is nie rou USB-verkeer nie.
Toets sonder ’n fisiese QR-skandeerder
Toepassingslogika kan getoets word voordat ’n skandeerder op die lessenaar is.
- Tik
QR-INPUT-TEST-12345in die veld en aktiveer Accept. Dit kontroleer validering en vertoon. Dit kontroleer nie dekodering of agtervoegsels nie. - Dryf dieselfde veld vanuit ’n blaaieroutomatiseringshulpmiddel, soos die volgende afdeling doen.
- Gebruik Barcode Scanner Emulator wanneer jy skandeerderstyl-tik nodig het. Die lessenaartoepassing stuur ’n waarde wat jy invoer, met ’n tikvertraging en ’n agtervoegsel van geen, ENTER of TAB, na die gefokusde toepassing. Dit reproduseer die sleutelbordpad. Dit fotografeer nie ’n QR-beeld nie, dekodeer nie ’n simbool nie, en skep nie ’n virtuele COM-poort nie.
Hardeware is steeds nodig vir optiese en toestelgedrag: of daardie skandeerder die vertoonde of gedrukte kode kan lees, of QR-simbologie geaktiveer is, sleutelborduitleg, agtervoegselopstelling, en reeks- of verkoper-SDK-modusse. Die emulator is die regte kontrole vir die sleutelbordpad. Dit is die verkeerde kontrole om te bewys dat ’n toestel ’n bepaalde QR-kode lees.
Outomatiseer QR-invoertoetse
Die volgende Playwright-toetse dryf die voorbeeldbladsy. Hulle tik in die veld soos ’n wigskandeerder sou, en beweer dan toepassingsgedrag. Hulle maak nie USB-toestelle oop nie. @playwright/test is ’n leserafhanklikheid. Hierdie werf vereis dit nie.
Stoor die HTML-voorbeeld as qr-form.html langs hierdie toets.
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)
})
pressSequentially voeg karakters in die gefokusde veld in. Dit is nie ’n USB-toestel nie. Die onverwagte-karaktertoets gebruik fill omdat die doel die valideringsboodskap en die afwesigheid van ’n ingespuite element is. Brei die lêer uit met ’n URL-geval en ’n JSON-geval wanneer daardie formate in die bou is wat jy verskeep. ’n URL-bewering behoort die vasgevange teks met die oorspronklike QR-string te vergelyk.
QR-skandeerdertoetsmatriks
Voer hierdie teen die toepassing onder toets uit. Die voorbeeldbladsy hierbo dek die kaartjie-, URL-, JSON-, duplikaat-, leë- en onverwagte-karakterrye. ’n Slegs-numeriese of meerlynige toepassing het sy eie verwagte resultaat nodig.
| Scenario | Verwagte resultaat |
|---|---|
| Gewone-teks-QR | Presiese waarde ontvang. |
| URL-QR | Volledige URL vasgelê, en die bladsy navigeer nie daarna nie. |
| Numeriese QR | Syfers behou. |
| Spesiale karakters | Korrekte karakters ontvang. |
| JSON-loonvrag | Data vasgelê en gevalideer. |
| ENTER-agtervoegsel | Verwerking vind een keer plaas. |
| TAB-agtervoegsel | Fokusgedrag hanteer. |
| Geen agtervoegsel | Toepassing gebruik ’n alternatiewe voltooiingsmeganisme. |
| Duplikaatskandering | Toepassing pas duplikaathanteringsreëls toe. |
| Ongeldige loonvrag | Valideringsfout vertoon. |
| Ontbrekende fokus | Toepassing hanteer afwesige invoer veilig. |
| Lang loonvrag | Geen onbedoelde afkapping. |
Skandeer ook ’n loonvrag wat ’n nuwe reël bevat as die produk een moet stoor. Teken aan of die veld elke reël ontvang het.
Probleemoplossing
Begin met ’n bekende loonvrag in die invoertoetser. As die toetser se waarde reeds verkeerd is, is die bladsy nie die eerste fout nie. As die toetser se waarde reg is en die toepassing verkeerd is, is die fout fokus, validering of gebeurtenishantering. Strepieskodeskandeerder werk nie is die breër toestelkontrolelys. Hoe om strepieskodeskandeerderinvoer te toets dek fokus, uitleg en POS-werkvloeie anderkant hierdie vorm.
Skandeerder piep, maar geen invoer verskyn
’n Piep beteken gewoonlik dat die skandeerder ’n simbool gedekodeer het. Dit beteken nie dat die bladsy die teks ontvang het nie. Bevestig sleutelbordwigmodus. Reeks- en kameramodi sal nie in die veld tik nie. Klik die veld sodat document.activeElement daardie invoer is, en skandeer dan weer. ’n Gedeaktiveerde, leesalleen- of versteekte veld kan die sleutels ignoreer.
QR-skandeerder werk in Notepad maar nie in die blaaier nie
Die toestel tik. Die bladsy aanvaar nie daardie sleutels nie. Kontroleer fokus, ’n keydown-luisteraar wat preventDefault() op drukbare sleutels roep, en ’n luisteraar wat net paste hanteer. Wiginvoer vuur nie ’n plakgebeurtenis nie. Vergelyk die toetserresultaat met die toepassingsveld.
Skandeerder lees strepieskodes maar nie QR-kodes nie
Die toestel is dalk net 1D, of die QR-simbologie is dalk gedeaktiveer. Die bladsy kan dit nie regstel nie. Bevestig 2D-ondersteuning en aktiveer QR Code uit die toestelhandleiding, met die kontroles in QR-kodetoetsing: hoe om QR-kodeskandeerders te toets. ’n Suksesvolle Code 128-skandering bewys net die sleutelbordpad.
Verkeerde karakters
Skandeer eers QR-INPUT-TEST-12345. As dit pas en ’n URL- of JSON-loonvrag nie, verander die uitleg leestekens soos :, /, { of ". Vergelyk event.key met event.code in die Sleutelbordgebeurtenistoetser, en sien Verkeerde sleutelborduitleg op die strepieskodeskandeerder. Laat die skandeerder se sleutelborduitleg by die bedryfstelsel pas.
ENTER dien die vorm twee keer in
Die blaaier dien die vorm in, en ’n keydown-luisteraar hanteer ook Enter. Hou een voltooiingspad en roep preventDefault() daar. ’n Tweede fisiese skandering is ’n ander mislukking. Die statusteks in die voorbeeld sê die loonvrag is reeds aanvaar. As die eerste skandering self twee rekords skep, soek twee luisteraars voordat jy die skandeerder verander.
QR-invoer word afgekap
Vergelyk die karaktertelling in die invoertoetser met die waarde in die veld. ’n maxlength-kenmerk, ’n invoermasker of preventDefault() op karaktersleutels kan die string sny. ’n Nuwe reël binne die QR-loonvrag kan ’n eenreëlinvoer vroeg indien. Sommige skandeerders beperk ook hoeveel karakters hulle tik. Verhoog daardie limiet uit die toestelhandleiding wanneer die toetser, nie net die toepassing nie, ’n kort waarde wys. Strepieskodeskandeerder se ENTER ontbreek dek die verwante geval waar die loonvrag aankom en die vorm nooit vaslê nie.
Skandeerder kan nie ’n QR-kode op die skerm lees nie
Bevestig dat die skandeerder ’n 2D-beelder is. Verhoog die skermhelderheid, vergroot die kode, en hou die stiltesone vry van teks en rande. Glans, ’n dowwe foonkerm en ’n kode wat te dig is vir die werkafstand is optiese probleme. Druk dieselfde loonvrag as die skermlesing aanhou misluk. Die toepassingstoets gebruik steeds die bekende string sodra enige skandering teks lewer.