Barcode Scanner Emulator
Kaip testuoti QR kodų skaitytuvo įvestį žiniatinklio programose
Daugelis išorinių skaitytuvų, palaikančių QR, naudoja klaviatūros pleišto režimą ir dekoduotą QR tekstą įrašo į sufokusuotą lauką. Tą kelią patikrinkite nuskaitydami žinomą turinį ir palygindami jį su reikšme, kurią gavo puslapis. Ne kiekvienas QR skaitytuvas rašo kaip klaviatūra. Nuoseklieji įrenginiai ir kameros dekoderiai yra kitos integracijos, o naršyklės klaviatūros įvykiai fizinio skaitytuvo neidentifikuoja.
QR kodas saugo duomenis. Skaitytuvas arba kameros dekoderis tuos duomenis paverčia tekstu. Žiniatinklio programa tada turi tą tekstą gauti, nuspręsti, kada nuskaitymas baigtas, ir jį patikrinti. Šis gidas yra tas programos testas. Etikečių generavimas, kontrasto tikrinimas ir patvirtinimas, kad įrenginys gali dekoduoti QR Code, aprašyti gide QR kodo testavimas: kaip testuoti QR kodų skaitytuvus. Bendros brūkšninių kodų formos, įskaitant EAN kontrolinius skaitmenis, aprašytos gide Kaip testuoti brūkšninių kodų skaitytuvus žiniatinklio programose.
QR skaitytuvo įvesties testas per 60 sekundžių
Naudokite turinį, kurį pasirinkote patys, kad neteisingas ženklas būtų akivaizdus. Šiame aprašyme naudojama QR-INPUT-TEST-12345.
- Atidarykite QR kodo generatorių ir sugeneruokite QR kodą reikšmei
QR-INPUT-TEST-12345. Generatorius veikia naršyklėje. Su skaitytuvu jis nesusisiekia. - Prijunkite QR palaikantį skaitytuvą, nustatytą į klaviatūros pleišto režimą. Tik 1D skaitytuvas šio simbolio dekoduoti negali.
- Atidarykite brūkšninio kodo įvesties testerį.
- Spustelėkite Pradėti testą arba spustelėkite nuskaitymo sritį, kad laukas turėtų fokusą. Testeris pats fokuso nepaima ir skaitytuvo neatidaro.
- Nuskaitykite QR kodą.
- Perskaitykite užfiksuotą tekstą ir ženklų skaičių.
- Palyginkite tą tekstą su
QR-INPUT-TEST-12345. Atitiktis apima raidžių dydį, brūkšnelius ir ilgį. - Perskaitykite priesagą. Testeris praneša ENTER, TAB arba Nėra, kai skaitytuvas siunčia vieną iš tų klavišų.
Testeris registruoja klaviatūros įvykius, kuriuos mato naršyklė. Jis neidentifikuoja USB įrenginio, neskaito nuosekliojo prievado ir nedekoduoja QR vaizdo.
QR skaitytuvo įvesties režimai
Tas pats atspausdintas QR kodas gali ateiti per tris skirtingas integracijas. Vieno režimo testas kitų nepatikrina.
Klaviatūros pleišto QR skaitytuvai
USB HID klaviatūros režimu arba Bluetooth HID klaviatūros režimu operacinė sistema skaitytuvą laiko klaviatūra. Po dekodavimo skaitytuvas įrašo turinį į tą valdiklį, kuris turi fokusą. Jį gali priimti paprastas <input> arba <textarea>. Puslapis įrenginio neatidaro. Gidas HID klaviatūros pleištas aprašo klavišų seką, priešdėlius ir priesagas.
Fokusas nusprendžia paskirties vietą. Jei sufokusuotas elementas yra dokumento turinys, mygtukas arba kitas rėmas, šio lauko klausytojai nuskaitymo nemato.
Nuoseklieji QR skaitytuvai
USB nuosekliojo arba virtualaus COM prievado skaitytuvas dekoduotą tekstą siunčia kaip baitus procesui, kuris atidarė prievadą. Fokusas to proceso neparenka. Laukas, kuris klauso tik klavišų paspaudimų, lieka tuščias, o terminalas tame prievade rodo turinį.
Chromium pagrįstos naršyklės gali atidaryti naudotojo pasirinktą prievadą per Web Serial API saugiame kontekste, po naudotojo gesto. Firefox ir Safari šios API neteikia. Pleišto skaitytuvas nepasirodo kaip nuoseklusis prievadas. Prievadų pavadinimai, sparta bodais ir kadravimas priklauso nuo įrenginio ir tvarkyklės. USB HID ir nuoseklieji brūkšninių kodų skaitytuvai lygina abi sąsajas. Brūkšninio kodo įvesties testeris COM prievado skaityti negali.
QR nuskaitymas kamera
Kameros integracija užfiksuoja vaizdą ir QR kodą dekoduoja programine įranga. Puslapis naudoja kameros API ir dekoderį. Turinio keydown įvykių jis negauna. Telefono kameros programos, puslapio kameros mygtukai ir aparatinis vaizdo skaitytuvas, kuris rašo į lauką, yra trys skirtingi produktai. Išlaikytas pleišto testas nereiškia, kad kameros mygtukas veikia, o sėkmingas kameros dekodavimas nereiškia, kad pleišto skaitytuvas įrašys tą pačią eilutę.
QR skaitytuvo įvesties fiksavimas su JavaScript
Toliau esantis puslapis skaito vieną sufokusuotą lauką. Enter pateikia formą, o mygtukas Accept naudoja tą patį pateikimo doroklį, todėl vienas nuskaitymas apdorojamas vieną kartą. Be ENTER priesagos tekstas lieka lauke, kol kas nors suaktyvina Accept. Užfiksuotas turinys rašomas su textContent, todėl ženklai, tokie kaip <, lieka matomi kaip tekstas.
Pavyzdys priima tris programos formatus: bilieto identifikatorių, tokį kaip QR-INPUT-TEST-12345, http arba https URL, arba JSON objektą. Jis įrašo nuskaitytą tekstą. Jis neina į URL, rastą QR kode. Skaitytuvas, kuris nesiunčia Enter, vis tiek veikia per mygtuką. Tab kaip įprasta pereina per etiketę, lauką ir mygtuką, nes scenarijus jo nesulaiko.
<!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>
Įrašykite failą ir atidarykite jį darbalaukio naršyklėje. Prieš nuskaitymą spustelėkite lauką. autocomplete="off" sumažina tikimybę, kad įrašyta reikšmė pakeis nuskaitymą. Etiketė ir mygtukas lieka pasiekiami, todėl žmogus gali įvesti turinį be skaitytuvo.
Enter apdorokite tik formos submit įvykyje. Antras keydown klausytojas Enter tam pačiam nuskaitymui sukuria du įrašus. preventDefault() palieka naršyklę šiame puslapyje. Po sprendimo išvalykite lauką, kad kitas nuskaitymas neprisijungtų prie ankstesnio teksto.
QR turinys gali turėti eilutės lūžį. Pleišto skaitytuvas tą lūžį dažnai įrašo kaip Enter. Vienos eilutės įvestyje forma gali būti pateikta ties pirmąja eilute, o likutis atmestas. Naudokite textarea arba nuoseklųjį skaitytuvą, kuris išsaugo baitus, kai programa turi priimti kelių eilučių tekstą. Tą elgseną patvirtinkite QR kodu, kurio turinyje yra nauja eilutė.
QR turinio tvarkymas
QR simbolis nežada programos formato. Ta pati simbologija gali nešti bet ką iš šių:
- Paprastą tekstą, tokį kaip
QR-INPUT-TEST-12345. - URL.
- Identifikatorių, kurį pasirenka programa.
- Struktūrinį turinį, pavyzdžiui bilieto numerį ir vietos kodą.
- JSON tekstą, kai programa apibrėžė tą kodavimą.
Skaitytuvas perduoda dekoduotus ženklus. Jis netikrina, ar jie atitinka bilieto taisyklę, prekių katalogą ar JSON schemą. Eilutę tikrinkite puslapyje ir dar kartą serveryje. Pateikta reikšmė yra paprasta naudotojo įvestis. Naršyklė negali įrodyti, kad ją sukūrė skaitytuvas.
QR įvesties tikrinimas
Nemanykite, kad QR turinys yra skaitinis. EAN-13 taisyklės netaikomos. Tekstą laikykite nepatikimu: rodykite jį kaip tekstą ir nepriskirkite jo location, innerHTML ar scenarijaus URL.
Tuščios reikšmės. Vienas Enter arba Accept tuščiame lauke neturi sukurti įrašo. trim() taip pat atmeta turinį, kuris yra tik tarpai.
Netikėti ženklai. Palyginkite gautą eilutę su žinomu QR turiniu. Klaviatūros išdėstymo neatitiktis dažnai pakeičia skyrybą, o ilgis lieka toks pat. Atmestite ženklus, kurių formatas neleidžia, ir priežastį parodykite būsenos tekste.
Turinio ilgis. Taikykite maksimumą, kurį saugo jūsų programa. maxlength įvestyje ilgesnį nuskaitymą nukerpa be klaidos. Nustatykite jį tik tada, kai telpa kiekvienas priimamas turinys, ir palyginkite testerio ženklų skaičių su lauku, kai reikšmė atrodo trumpa.
Privalomi priešdėliai. Priešdėlio tikrinimas priklauso programai. Ši bilieto taisyklė priima QR- ir didžiąsias raides, skaitmenis bei brūkšnelius:
function isTicketId(value) {
return /^QR-[A-Z0-9-]{1,64}$/.test(value)
}
Skaitytuvo priešdėlį šalinkite tik tada, kai tas skaitytuvas sukonfigūruotas siųsti vieną tikslų priešdėlį, o programa jo nesaugo. AIM simbologijos identifikatorius yra duomenys, kol nenuspręsite kitaip.
Programai būdingi formatai. Taisyklę laikykite šalia formato. Bilieto formai, URL leidžiamųjų sąrašui ir JSON objektui reikia skirtingų patikrų. Vienas skaitinis šablonas atmestų galiojantį QR tekstą.
Pasikartojantys nuskaitymai. Vienas fizinis nuskaitymas gali pasiekti du klausytojus. Naudokite vieną užbaigimo kelią, kaip daro pavyzdys. Antras gaiduko paspaudimas yra atskiras įvykis. Pavyzdys atmeta turinį, kurį jau priėmė. Sandėlio forma vietoj to gali padidinti kiekį. Testuokite taisyklę, kurią dokumentuoja jūsų programa.
Netinkamai suformuotas JSON. JSON.parse meta išimtį, kai tekstas nepilnas. Po sėkmingos analizės patikrinkite formą. Masyvas arba plikas skaičius gali būti galiojantis JSON ir vis tiek būti netinkamo tipo:
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.' }
}
}
Netikėti URL. Išanalizuokite URL, kad pamatytumėte, ar jis tinkamas naudoti, tada palikite nuskaitytą eilutę, jei testas turi tiksliai atitikti QR turinį. URL.href gali pridėti pasvirąjį brūkšnį arba pakeisti kodavimą. Priimkite tik tas schemas, kurias numato programa. Neatidarykite URL kaip nuskaitymo šalutinio poveikio:
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 }
}
Valdymo ženklai. Klaviatūros turinyje atmeskite ASCII valdymo ženklus, kad paslėptas priešdėlis liktų matomas būsenos tekste. CR ir LF yra valdymo ženklai. Pleišto skaitytuve Enter ir Tab yra klavišai. Jie nėra ženklai paprastoje teksto įvestyje. Nuoseklusis turinys vis tiek gali turėti 0x0D arba 0x0A baitus. Šalinkite juos nuosekliojo kadravimo riboje ir nešalinkite CR, kuris priklauso kelių eilučių turinio viduryje.
ENTER ir TAB priesagos
Priesaga yra neprivaloma skaitytuvo konfigūracija. Ji nėra QR simbolio dalis. ENTER ir TAB priesagos brūkšninių kodų skaitytuvuose parodo, kaip atskirti klavišus. Priesagą perskaitykite įvesties testeryje, tada pritaikykite puslapį skaitytuvams, kuriuos diegiate.
ENTER dabartinėse naršyklėse pateikia vienos eilutės teksto lauko formą. Naudokite tai, kai vienas nuskaitymas turi patvirtinti reikšmę. Iškvieskite preventDefault() ant submit, kai puslapis turi likti vietoje.
TAB perkelia fokusą į kitą valdiklį. Reikšmę skaitykite per keydown, kol laukas dar turi fokusą. Palikite numatytąjį veiksmą, kai kitas laukas turi gauti fokusą. Ignoruokite Shift+Tab, kad klaviatūros naudotojas galėtų judėti atgal.
Be priesagos turinys lieka lauke. Mygtukas Accept pavyzdyje yra užbaigimo kelias. Neveiklos laikmatis gali manyti, kad pauzė reiškia nuskaitymo pabaigą. Tas laikmatis yra euristika: lėtas Bluetooth pliūpsnis ir greitai rašantis žmogus gali kirsti tą patį tarpą. Rinkitės sukonfigūruotą priesagą, kai darbo eigai reikia tvirtos pabaigos.
CR ir LF yra baitai. Klaviatūros Enter yra event.key === "Enter". Jie nėra sukeičiami. Klausytojas, kuris iš įvesties reikšmės šalina tik \r, pleišto Enter nematys, nes ženklas niekada nebuvo įterptas. Klausytojas, kuris stebi tik event.key, nuosekliojo buferio nepadalys ties 0x0D. Kai kurie įrenginiai siunčia NumPad Enter. event.key vis tiek yra "Enter". Tikrinkite event.key, ne tik event.code === "Enter".
Priesaga gali pasikeisti, kai kas nors nuskaito konfigūracijos brūkšninį kodą iš įrenginio vadovo. Po bet kokio konfigūracijos pakeitimo iš naujo testuokite Enter, Tab ir atvejį be priesagos. Neišgalvokite programavimo brūkšninio kodo. Tam modeliui naudokite vadovą.
Klaviatūros įvykių derinimas
Kai išsaugotas tekstas neteisingas, įvykius tikrinkite šia tvarka.
keydown. Suveikia kiekvienam klavišui, įskaitant Enter ir Tab, prieš naršyklei įterpiant ženklą arba perkeliant fokusą. Užbaigiklį skaitykite čia.
input. Suveikia po to, kai spausdinamas ženklas pakeičia lauką. Teksto įvestyje jis nesuveikia Enter ar Tab.
event.key. Ženklas arba klavišo pavadinimas po to, kai operacinė sistema pritaiko klaviatūros išdėstymą.
event.code. Fizinis klavišas, pavyzdžiui Digit1 arba Numpad1. Jis gali likti toks pat, kai išdėstymo neatitiktis pakeičia event.key.
Fokusas. Prieš nuskaitymą užregistruokite document.activeElement. Jei tai nėra QR laukas, likusi pėdsako dalis aprašo neteisingą valdiklį. Iframe turi savo fokusą.
Tvarka. Pleišto nuskaityme į teksto lauką po spausdinamų keydown įvykių eina input atnaujinimai, tada galutinis keydown Enter arba Tab, kai ta priesaga sukonfigūruota. change suveikia, kai laukas patvirtinamas, paprastai praradus fokusą. Nuskaitymas, kuris fokusą palieka tame pačiame lauke, pabaigoje change nesukuria. Nenaudokite change kaip vienintelio užbaigimo signalo.
Laikas. Skaitytuvai trumpą turinį dažnai baigia gerokai greičiau nei per sekundę. Įvesties testeris vidutinį tarpą tarp ženklų lygina su 100 ms slenksčiu ir rezultatą pažymi kaip laiką, ne kaip aparatinės įrangos atpažinimą. Greitas mašininkas, automatinis pildymas arba emuliatorius gali atsidurti skaitytuvo pusėje to slenksčio. Uždelstas Bluetooth nuskaitymas gali atrodyti kaip rašymas. Tvirtinkite turinį ir priesagą. Laiką laikykite užuomina.
Naudokite klaviatūros įvykių testerį. Jis išvardija kiekvieną keydown ir keyup su key, code, modifikatoriais ir laiko žymomis. Žurnalas yra naršyklės įvykiai. Tai nėra neapdorotas USB srautas.
Testas be fizinio QR skaitytuvo
Programos logiką galima testuoti prieš padedant skaitytuvą ant stalo.
- Į lauką įveskite
QR-INPUT-TEST-12345ir suaktyvinkite Accept. Tai patikrina tikrinimą ir rodymą. Tai nepatikrina dekodavimo ar priesagų. - Tą patį lauką valdykite naršyklės automatizavimo priemone, kaip daro kitas skyrius.
- Naudokite Barcode Scanner Emulator, kai reikia rašymo skaitytuvo stiliumi. Darbalaukio programa išsiunčia jūsų įvestą reikšmę su rašymo delsa ir priesaga Nėra, ENTER arba TAB į sufokusuotą programą. Ji atkartoja klaviatūros kelią. Ji nefotografuoja QR vaizdo, nedekoduoja simbolio ir nesukuria virtualaus COM prievado.
Aparatūra vis tiek būtina optinei ir įrenginio elgsenai: ar tas skaitytuvas gali perskaityti rodomą ar atspausdintą kodą, ar įjungta QR simbologija, klaviatūros išdėstymas, priesagos konfigūracija ir nuoseklieji arba gamintojo SDK režimai. Emuliatorius yra tinkamas klaviatūros kelio patikrinimas. Jis netinkamas įrodymui, kad įrenginys perskaito konkretų QR kodą.
QR įvesties testų automatizavimas
Toliau esantys Playwright testai valdo pavyzdinį puslapį. Jie rašo į lauką taip, kaip rašytų pleišto skaitytuvas, tada tvirtina programos elgseną. Jie neatidaro USB įrenginių. @playwright/test yra skaitančiojo priklausomybė. Ši svetainė jos nereikalauja.
HTML pavyzdį įrašykite kaip qr-form.html šalia šio testo.
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 įterpia ženklus į sufokusuotą lauką. Tai nėra USB įtaisas. Netikėtų ženklų testas naudoja fill, nes tikslas yra tikrinimo pranešimas ir įterpto elemento nebuvimas. Failą papildykite URL atveju ir JSON atveju, kai tie formatai yra jūsų išleidžiamoje versijoje. URL tvirtinimas turi lyginti užfiksuotą tekstą su pradine QR eilute.
QR skaitytuvo testų matrica
Vykdykite tai testuojamoje programoje. Aukščiau esantis pavyzdinis puslapis apima bilieto, URL, JSON, dublikato, tuščios reikšmės ir netikėtų ženklų eilutes. Tik skaitmeninei arba kelių eilučių programai reikia savo laukiamo rezultato.
| Scenarijus | Laukiamas rezultatas |
|---|---|
| Paprastas QR tekstas | Gauta tiksli reikšmė |
| URL QR | Užfiksuotas visas URL, ir puslapis į jį nepereina |
| Skaitinis QR | Skaitmenys išsaugoti |
| Specialieji ženklai | Gauti teisingi ženklai |
| JSON turinys | Duomenys užfiksuoti ir patikrinti |
| ENTER priesaga | Apdorojimas įvyksta vieną kartą |
| TAB priesaga | Fokuso elgsena sutvarkyta |
| Be priesagos | Programa naudoja kitą užbaigimo mechanizmą |
| Pasikartojantis nuskaitymas | Programa taiko dublikatų tvarkymo taisykles |
| Negaliojantis turinys | Parodyta tikrinimo klaida |
| Trūkstamas fokusas | Programa saugiai tvarko nesamą įvestį |
| Ilgas turinys | Nėra nenumatyto nukirpimo |
Taip pat nuskaitykite turinį, kuriame yra nauja eilutė, jei produktas privalo ją saugoti. Užrašykite, ar laukas gavo kiekvieną eilutę.
Trikčių šalinimas
Pradėkite nuo žinomo turinio įvesties testeryje. Jei testerio reikšmė jau neteisinga, puslapis nėra pirmoji klaida. Jei testerio reikšmė teisinga, o programa neteisinga, klaida yra fokuse, tikrinime arba įvykių apdorojime. Brūkšninių kodų skaitytuvas neveikia yra platesnis įrenginio kontrolinis sąrašas. Kaip testuoti brūkšninių kodų skaitytuvo įvestį apima fokusą, išdėstymą ir POS darbo eigas už šios formos ribų.
Skaitytuvas pypteli, bet įvestis nepasirodo
Pyptelėjimas paprastai reiškia, kad skaitytuvas dekodavo simbolį. Jis nereiškia, kad puslapis gavo tekstą. Patvirtinkite klaviatūros pleišto režimą. Nuoseklusis ir kameros režimai į lauką nerašo. Spustelėkite lauką, kad document.activeElement būtų ta įvestis, tada nuskaitykite dar kartą. Išjungtas, tik skaitomas arba paslėptas laukas gali ignoruoti klavišus.
QR skaitytuvas veikia užrašinėje, bet ne naršyklėje
Įrenginys rašo. Puslapis tų klavišų nepriima. Patikrinkite fokusą, keydown klausytoją, kuris spausdinamiems klavišams iškviečia preventDefault(), ir klausytoją, kuris apdoroja tik paste. Pleišto įvestis paste įvykio nesukelia. Palyginkite testerio rezultatą su programos lauku.
Skaitytuvas skaito brūkšninius kodus, bet ne QR kodus
Įrenginys gali būti tik 1D arba QR simbologija gali būti išjungta. Puslapis to neištaisys. Patvirtinkite 2D palaikymą ir įjunkite QR Code pagal įrenginio vadovą, naudodami patikras gide QR kodo testavimas: kaip testuoti QR kodų skaitytuvus. Sėkmingas Code 128 nuskaitymas įrodo tik klaviatūros kelią.
Neteisingi ženklai
Pirmiausia nuskaitykite QR-INPUT-TEST-12345. Jei tai sutampa, o URL arba JSON turinys ne, išdėstymas keičia skyrybą, tokią kaip :, /, { arba ". Klaviatūros įvykių testeryje palyginkite event.key su event.code ir žr. Neteisingas brūkšninių kodų skaitytuvo klaviatūros išdėstymas. Skaitytuvo klaviatūros išdėstymą suderinkite su operacine sistema.
ENTER formą pateikia du kartus
Naršyklė pateikia formą, o keydown klausytojas taip pat apdoroja Enter. Palikite vieną užbaigimo kelią ir ten iškvieskite preventDefault(). Antras fizinis nuskaitymas yra kita klaida. Pavyzdžio būsenos tekstas sako, kad turinys jau priimtas. Jei jau pirmas nuskaitymas sukuria du įrašus, ieškokite dviejų klausytojų prieš keisdami skaitytuvą.
QR įvestis nukirpta
Palyginkite ženklų skaičių įvesties testeryje su reikšme lauke. Atributas maxlength, įvesties kaukė arba preventDefault() ženklų klavišams gali nukirpti eilutę. Nauja eilutė QR turinyje gali per anksti pateikti vienos eilutės įvestį. Kai kurie skaitytuvai taip pat riboja, kiek ženklų įrašo. Tą ribą padidinkite pagal įrenginio vadovą, kai trumpą reikšmę rodo testeris, ne tik programa. Brūkšninių kodų skaitytuvui trūksta ENTER apima susijusį atvejį, kai turinys ateina, o forma niekada nepatvirtinama.
Skaitytuvas negali perskaityti QR kodo ekrane
Patvirtinkite, kad skaitytuvas yra 2D vaizdo skaitytuvas. Padidinkite ekrano ryškumą, padidinkite kodo dydį ir palikite tyliąją zoną be teksto ir rėmelių. Atspindys, blankus telefono ekranas ir kodas, per tankus darbo atstumui, yra optinės problemos. Atspausdinkite tą patį turinį, jei skaitymas iš ekrano ir toliau nepavyksta. Programos testas vis tiek naudoja žinomą eilutę, kai bet kuris nuskaitymas sukuria tekstą.