Barcode Scanner Emulator
Hogyan tesztelhető a QR-olvasó bemenete webes alkalmazásokban
Sok külső, QR-képes olvasó billentyűzet-ékelés módban a dekódolt QR-szöveget a fókuszált mezőbe gépel. Ezt az útvonalat ismert hasznos adat beolvasásával tesztelje, és hasonlítsa össze az oldal által kapott értékkel. Nem minden QR-olvasó gépel billentyűzetként. A soros eszközök és a kamerás dekódolók külön integrációk, és a böngésző billentyűzeteseményei nem azonosítják a fizikai olvasót.
A QR-kód adatot tárol. Az olvasó, vagy egy kamerás dekódoló, ezt az adatot szöveggé alakítja. A webes alkalmazásnak ezt a szöveget fogadnia kell, el kell döntenie, mikor ért véget a beolvasás, és ellenőriznie kell. Ez az útmutató ezt az alkalmazástesztet írja le. A címkék létrehozása, a kontraszt ellenőrzése és annak megerősítése, hogy egy eszköz dekódolni tudja a QR Code-ot, a QR-kód tesztelése: a QR-olvasók tesztelése útmutatóban szerepel. Az általános vonalkódűrlapok, beleértve az EAN ellenőrző számjegyeket, a Hogyan tesztelhetők a vonalkódolvasók webes alkalmazásokban útmutatóban szerepelnek.
A QR-olvasó bemenetének tesztelése 60 másodperc alatt
Olyan hasznos adatot használjon, amelyet Ön választott, hogy a hibás karakter nyilvánvaló legyen. Ez a menet a QR-INPUT-TEST-12345 értéket használja.
- Nyissa meg a QR-kód generátort, és hozzon létre QR-kódot a
QR-INPUT-TEST-12345értékhez. A generátor a böngészőben fut. Nem lép kapcsolatba az olvasóval. - Csatlakoztasson QR-képes olvasót, amely billentyűzet-ékelés módra van állítva. A csak 1D-s olvasó ezt a szimbólumot nem tudja dekódolni.
- Teszteljen a vonalkódbevitel-tesztelővel.
- Kattintson a Teszt indítása gombra, vagy kattintson a beolvasási területre, hogy a mező fókuszban legyen. A tesztelő magától nem veszi át a fókuszt, és nem nyitja meg az olvasót.
- Olvassa be a QR-kódot.
- Olvassa el a rögzített szöveget és a karakterszámot.
- Hasonlítsa össze ezt a szöveget a
QR-INPUT-TEST-12345értékkel. Az egyezésbe beletartozik a kis- és nagybetű, a kötőjel és a hossz. - Olvassa le az utótagot. A tesztelő ENTER, TAB vagy Nincs értéket jelez, amikor az olvasó e billentyűk egyikét küldi.
A tesztelő azokat a billentyűzeteseményeket rögzíti, amelyeket a böngésző lát. Nem azonosítja az USB-eszközt, nem olvas soros portot, és nem dekódolja a QR-képet.
A QR-olvasó bemeneti módjai
Ugyanaz a kinyomtatott QR-kód három különböző integráción keresztül érkezhet. Az egyik mód tesztje a többit nem gyakoroltatja.
Billentyűzet-ékeléses QR-olvasók
USB HID billentyűzetmódban, vagy Bluetooth HID billentyűzetmódban az operációs rendszer az olvasót billentyűzetként kezeli. Dekódolás után az olvasó a hasznos adatot abba a vezérlőbe gépel, amelynek fókusza van. Egy közönséges <input> vagy <textarea> fogadhatja. Az oldal nem nyitja meg az eszközt. A HID billentyűzet-ékelés útmutató a billentyűleütés-sorozatot, az előtagokat és az utótagokat írja le.
A fókusz dönti el a célt. Ha a fókuszált elem a dokumentum törzse, egy gomb vagy egy másik keret, ennek a mezőnek a figyelői nem látják a beolvasást.
Soros QR-olvasók
Az USB-soros vagy virtuális COM-portos olvasó a dekódolt szöveget bájtokként küldi annak a folyamatnak, amely megnyitotta a portot. A fókusz nem választja ki ezt a folyamatot. Az a mező, amely csak billentyűleütéseket figyel, üres marad, miközben a porton lévő terminál megjeleníti a hasznos adatot.
A Chromium-alapú böngészők felhasználó által kiválasztott portot nyithatnak a Web Serial API-val, biztonságos környezetben, felhasználói gesztus után. A Firefox és a Safari nem biztosítja ezt az API-t. Az ékeléses olvasó nem jelenik meg soros portként. A portnevek, a baud és a keretezés az eszköztől és az illesztőprogramtól függenek. Az USB HID és soros vonalkódolvasók a két interfészt hasonlítja össze. A vonalkódbevitel-tesztelő nem tud COM-portot olvasni.
Kamerás QR-beolvasás
A kamerás integráció képet rögzít, és a QR-kódot szoftverben dekódolja. Az oldal kamera-API-t és dekódolót használ. A hasznos adathoz nem kap keydown eseményeket. A telefonos kameraalkalmazások, az oldalon belüli kameragombok és a mezőbe gépelő hardveres képalkotó három különböző termék. Az ékelésteszt sikere nem jelenti, hogy a kameragomb működik, és a sikeres kamerás dekódolás nem jelenti, hogy az ékeléses olvasó ugyanazt a karakterláncot fogja begépelni.
A QR-olvasó bemenetének rögzítése JavaScripttel
Az alábbi oldal egy fókuszált mezőt olvas. Az Enter elküldi az űrlapot, és az Accept gomb ugyanazt a submit-kezelőt használja, így egy beolvasás egyszer kerül feldolgozásra. ENTER utótag nélkül a szöveg a mezőben marad, amíg valaki aktiválja az Accept gombot. A rögzített hasznos adat textContent segítségével íródik ki, ezért az olyan karakterek, mint a <, szövegként láthatók maradnak.
A példa három alkalmazásformátumot fogad el: egy jegyazonosítót, például QR-INPUT-TEST-12345, egy http vagy https URL-t, vagy egy JSON-objektumot. Rögzíti a beolvasott szöveget. Nem navigál a QR-kódban talált URL-re. Az Entert nem küldő olvasó a gombon keresztül továbbra is működik. A Tab a szokott módon halad a címkén, a mezőn és a gombon, mert a szkript nem ejti csapdába.
<!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>
Mentse a fájlt, és nyissa meg egy asztali böngészőben. Kattintson a mezőre a beolvasás előtt. Az autocomplete="off" csökkenti annak esélyét, hogy egy mentett érték helyettesítse a beolvasást. A címke és a gomb elérhető marad, ezért egy személy olvasó nélkül is begépelhet egy hasznos adatot.
Az Entert csak az űrlap submit eseményében kezelje. Egy második keydown figyelő az Enterre ugyanazt a beolvasást kétszer rögzíti. A preventDefault() ezen az oldalon tartja a böngészőt. A döntés után törölje a mezőt, hogy a következő beolvasás ne fűződjön az előző szöveghez.
A QR hasznos adat tartalmazhat sortörést. Az ékeléses olvasó ezt a törést gyakran Enterként gépel. Egysoros inputban az űrlap az első sornál elküldheti magát, és a többit eldobhatja. Használjon textarea-t, vagy olyan soros olvasót, amely megőrzi a bájtokat, ha az alkalmazásnak többsoros szöveget kell elfogadnia. Ezt a viselkedést olyan QR-kóddal erősítse meg, amelynek hasznos adata sortörést tartalmaz.
A QR hasznos adatok kezelése
A QR-szimbólum nem ígér alkalmazásformátumot. Ugyanaz a szimbológia ezek bármelyikét hordozhatja:
- Egyszerű szöveg, például
QR-INPUT-TEST-12345. - URL.
- Az alkalmazás által választott azonosító.
- Strukturált hasznos adat, például jegyszám és helykód.
- JSON-szöveg, ha az alkalmazás ezt a kódolást határozta meg.
Az olvasó a dekódolt karaktereket továbbítja. Nem ellenőrzi, hogy jegyszabálynak, termékkatalógusnak vagy JSON-sémának megfelelnek-e. Ellenőrizze a karakterláncot az oldalon, majd újra a szerveren. A beküldött érték közönséges felhasználói bemenet. A böngésző nem tudja bizonyítani, hogy olvasó hozta létre.
A QR-bemenet ellenőrzése
Ne feltételezze, hogy a QR hasznos adat numerikus. Az EAN-13 szabályok nem érvényesek. A szöveget megbízhatatlanként kezelje: szövegként jelenítse meg, és ne rendelje a location, az innerHTML vagy egy szkript-URL értékéhez.
Üres értékek. A puszta Enter, vagy az Accept üres mezőn, nem hozhat létre rekordot. A trim() azt a hasznos adatot is elutasítja, amely csak szóközökből áll.
Váratlan karakterek. Hasonlítsa össze a kapott karakterláncot az ismert QR-tartalommal. A billentyűzetkiosztás eltérése gyakran az írásjeleket változtatja meg, miközben a hossz ugyanaz marad. Utasítsa el a formátum által nem engedett karaktereket, és az okot a státuszszövegben mutassa.
A hasznos adat hossza. Kényszerítse ki azt a maximumot, amelyet az alkalmazás tárol. Az input maxlength attribútuma a hosszabb beolvasást hiba nélkül csonkolja. Csak akkor állítsa be, ha minden elfogadott hasznos adat belefér, és hasonlítsa össze a tesztelő karakterszámát a mezővel, ha egy érték rövidnek tűnik.
Kötelező előtagok. Az előtagellenőrzés az alkalmazáshoz tartozik. Ez a jegyszabály a QR- előtagot fogadja el, valamint nagybetűket, számjegyeket és kötőjeleket:
function isTicketId(value) {
return /^QR-[A-Z0-9-]{1,64}$/.test(value)
}
Olvasó-előtagot csak akkor vágjon le, ha az olvasó úgy van beállítva, hogy egy pontos előtagot küldjön, és az alkalmazás nem tárolja azt. Az AIM szimbológia-azonosító adat, amíg másként nem dönt.
Alkalmazásspecifikus formátumok. A szabályt a formátum mellett tartsa. A jegyűrlap, az URL-engedélylista és a JSON-objektum különböző ellenőrzéseket igényel. Egy numerikus minta az érvényes QR-szöveget elutasítja.
Ismételt beolvasások. Egy fizikai beolvasás két figyelőt is eltalálhat. Egyetlen lezárási útvonalat használjon, ahogy a példa teszi. A ravasz második meghúzása külön esemény. A példa elutasítja azt a hasznos adatot, amelyet már elfogadott. Egy raktári űrlap inkább mennyiséget növelhet. Azt a szabályt tesztelje, amelyet az alkalmazás dokumentál.
Hibás JSON. A JSON.parse hiányos szövegre kivételt dob. Sikeres elemzés után ellenőrizze az alakot. Egy tömb vagy egy puszta szám lehet érvényes JSON, és mégis rossz típus:
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.' }
}
}
Váratlan URL-ek. Elemezze az URL-t, hogy lássa, használható-e, majd tartsa meg a beolvasott karakterláncot, ha a tesztnek pontosan a QR hasznos adattal kell egyeznie. A URL.href perjelet adhat hozzá, vagy megváltoztathatja a kódolást. Csak azokat a sémákat fogadja el, amelyeket az alkalmazás szándékozik. Ne nyissa meg az URL-t a beolvasás mellékhatásaként:
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 }
}
Vezérlőkarakterek. Utasítsa el az ASCII vezérlőkaraktereket a billentyűzetes hasznos adatban, hogy a rejtett előtag a státuszszövegben látható maradjon. A CR és az LF vezérlőkarakterek. Ékeléses olvasón az Enter és a Tab billentyűk. Nem karakterek egy közönséges szöveges inputon belül. A soros hasznos adat továbbra is tartalmazhat 0x0D vagy 0x0A bájtokat. Ezeket a soros keretezés határán vágja le, és ne távolítson el olyan CR-t, amely egy többsoros hasznos adat közepéhez tartozik.
ENTER és TAB utótagok
Az utótag opcionális olvasóbeállítás. Nem része a QR-szimbólumnak. Az ENTER és TAB utótagok a vonalkódolvasókban azt mutatja, hogyan lehet a billentyűket megkülönböztetni. Olvassa le az utótagot a vonalkódbevitel-tesztelőben, majd igazítsa az oldalt a telepített olvasókhoz.
ENTER egysoros szövegmező űrlapját küldi el a jelenlegi böngészőkben. Akkor használja, amikor egy beolvasásnak véglegesítenie kell az értéket. Hívja a preventDefault() függvényt a submit eseményen, ha az oldalnak a helyén kell maradnia.
TAB a fókuszt a következő vezérlőre viszi. Olvassa az értéket keydown közben, amíg a mezőnek még fókusza van. Hagyja meg az alapértelmezett műveletet, ha a következő mezőnek kell megkapnia a fókuszt. Hagyja figyelmen kívül a Shift+Tab kombinációt, hogy a billentyűzetet használó visszafelé is mozoghasson.
Nincs utótag a hasznos adatot a mezőben hagyja. A példa Accept gombja a lezárási útvonal. Egy inaktivitási időzítő találgathatja, hogy a szünet a beolvasás végét jelenti. Ez az időzítő heurisztika: egy lassú Bluetooth-sorozat és egy gyors gépíró ugyanazt a rést átlépheti. Részesítse előnyben a beállított utótagot, ha a munkafolyamatnak határozott végre van szüksége.
CR és LF bájtok. A billentyűzetes Enter az event.key === "Enter". Ezek nem cserélhetők fel. Az a figyelő, amely csak a \r karaktert vágja le egy input értékéből, nem látja az ékeléses Entert, mert a karakter soha nem került beillesztésre. Az a figyelő, amely csak az event.key értékét figyeli, nem választja szét a soros puffert a 0x0D mentén. Egyes eszközök NumPad Entert küldenek. Az event.key továbbra is "Enter". Az event.key értékét ellenőrizze, ne csak az event.code === "Enter" feltételt.
Billentyűzetesemények hibakeresése
Ha a tárolt szöveg hibás, az eseményeket ebben a sorrendben vizsgálja.
keydown. Minden billentyűre lefut, beleértve az Entert és a Tabot, mielőtt a böngésző karaktert szúrna be vagy fókuszt helyezne át. A lezárót itt olvassa.
input. Azután fut le, hogy egy nyomtatható karakter megváltoztatta a mezőt. Szöveges inputon Enterre vagy Tabra nem fut le.
event.key. A karakter vagy a billentyű neve azután, hogy az operációs rendszer alkalmazta a billentyűzetkiosztást.
event.code. A fizikai billentyű, például Digit1 vagy Numpad1. Ugyanaz maradhat, amikor a kiosztáseltérés megváltoztatja az event.key értékét.
Fókusz. Naplózza a document.activeElement értékét a beolvasás előtt. Ha nem a QR-mező, a nyomkövetés többi része a rossz vezérlőt írja le. Az iframe-nek saját fókusza van.
Sorrend. Ékeléses beolvasásnál szövegmezőbe a nyomtatható keydown eseményeket input frissítések követik, majd egy utolsó keydown Enterre vagy Tabra, ha ez az utótag be van állítva. A change akkor fut le, amikor a mező véglegesít, általában blur esetén. Az a beolvasás, amely a fókuszt ugyanabban a mezőben hagyja, a végén nem hoz létre change eseményt. Ne a change legyen az egyetlen lezárási jel.
Időzítés. Az olvasók egy rövid hasznos adatot gyakran jóval egy másodperc alatt befejeznek. A vonalkódbevitel-tesztelő a karakterek közötti átlagos rést egy 100 ms küszöbhöz hasonlítja, és az eredményt időzítésként címkézi, nem hardverazonosításként. Egy gyors gépíró, az automatikus kitöltés vagy az emulátor a küszöb olvasói oldalára kerülhet. A késleltetett Bluetooth-beolvasás gépelésnek tűnhet. A hasznos adatot és az utótagot ellenőrizze. Az időzítést nyomnak tekintse.
A billentyűzetesemény-tesztelőt minden keydown és keyup felsorolására használja, a key, a code, a módosítók és az időbélyegek mellett. A napló böngészőesemény. Nem nyers USB-forgalom.
Tesztelés fizikai QR-olvasó nélkül
Az alkalmazáslogika tesztelhető, mielőtt olvasó kerülne az asztalra.
- Gépelje a
QR-INPUT-TEST-12345értéket a mezőbe, és aktiválja az Accept gombot. Ez az ellenőrzést és a megjelenítést vizsgálja. A dekódolást vagy az utótagokat nem. - Ugyanazt a mezőt böngészőautomatizálási eszközzel vezérelje, ahogy a következő szakasz teszi.
- Használja a Barcode Scanner Emulator alkalmazást, amikor olvasószerű gépelésre van szükség. Az asztali alkalmazás az Ön által megadott értéket küldi, gépelési késleltetéssel és nincs, ENTER vagy TAB utótaggal, a fókuszált alkalmazásba. A billentyűzetes útvonalat adja vissza. Nem fényképez QR-képet, nem dekódol szimbólumot, és nem hoz létre virtuális COM-portot.
A hardver továbbra is szükséges az optikai és az eszközviselkedéshez: hogy az olvasó el tudja-e olvasni a megjelenített vagy nyomtatott kódot, hogy a QR szimbológia engedélyezve van-e, a billentyűzetkiosztáshoz, az utótagbeállításhoz, valamint a soros vagy gyártói SDK módokhoz. Az emulátor a billentyűzetes útvonal megfelelő vizsgálata. Nem alkalmas annak bizonyítására, hogy egy eszköz egy adott QR-kódot olvas.
A QR-bemenet tesztjeinek automatizálása
Az alábbi Playwright-tesztek a példoldalt vezérlik. Úgy gépelnek a mezőbe, ahogy az ékeléses olvasó tenné, majd az alkalmazás viselkedését ellenőrzik. Nem nyitnak USB-eszközöket. Az @playwright/test annak a függősége, aki a példát futtatja. Ez a webhely nem igényli.
Mentse a HTML-példát qr-form.html néven e teszt mellé.
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)
})
A pressSequentially karaktereket szúr a fókuszált mezőbe. Nem USB-eszköz. A váratlan karakter tesztje a fill metódust használja, mert a cél az ellenőrző üzenet és a beinjektált elem hiánya. Egészítse ki a fájlt egy URL-esettel és egy JSON-esettel, ha ezek a formátumok a szállított változatban szerepelnek. Az URL-ellenőrzésnek a rögzített szöveget az eredeti QR-karakterlánccal kell összehasonlítania.
A QR-olvasó tesztmátrixa
Ezeket a tesztelt alkalmazáson futtassa. A fenti mintaoldal a jegy, az URL, a JSON, az ismétlés, az üres és a váratlan karakter sorait lefedi. A csak numerikus vagy többsoros alkalmazásnak saját várt eredményre van szüksége.
| Forgatókönyv | Várt eredmény |
|---|---|
| Sima szöveges QR | Pontos érték érkezett |
| URL-es QR | A teljes URL rögzítve, és az oldal nem navigál rá |
| Numerikus QR | A számjegyek megmaradnak |
| Speciális karakterek | A helyes karakterek érkeztek |
| JSON hasznos adat | Az adat rögzítve és ellenőrizve |
| ENTER utótag | A feldolgozás egyszer történik |
| TAB utótag | A fókusz viselkedése kezelve |
| Nincs utótag | Az alkalmazás alternatív lezárási módot használ |
| Ismételt beolvasás | Az alkalmazás az ismétléskezelési szabályokat alkalmazza |
| Érvénytelen hasznos adat | Ellenőrzési hiba jelenik meg |
| Hiányzó fókusz | Az alkalmazás a hiányzó bemenetet biztonságosan kezeli |
| Hosszú hasznos adat | Nincs nem szándékolt csonkolás |
Akkor is olvasson be olyan hasznos adatot, amely sortörést tartalmaz, ha a terméknek egyet tárolnia kell. Jegyezze fel, hogy a mező minden sort megkapott-e.
Hibaelhárítás
Ismert hasznos adattal kezdjen a vonalkódbevitel-tesztelőben. Ha a tesztelő értéke már hibás, az oldal nem az első hiba. Ha a tesztelő értéke helyes, és az alkalmazás hibás, a hiba a fókusz, az ellenőrzés vagy az eseménykezelés. A vonalkódolvasó nem működik a tágabb eszköz-ellenőrzőlista. A vonalkódolvasó bemenetének tesztelése a fókuszt, a kiosztást és a POS-munkafolyamatokat fedi le ezen az űrlapon túl.
Az olvasó sípol, de nem jelenik meg bemenet
A sípolás általában azt jelenti, hogy az olvasó dekódolt egy szimbólumot. Nem jelenti azt, hogy az oldal megkapta a szöveget. Erősítse meg a billentyűzet-ékelés módot. A soros és a kamerás mód nem gépel a mezőbe. Kattintson a mezőre, hogy a document.activeElement az az input legyen, majd olvasson be újra. A letiltott, csak olvasható vagy rejtett mező figyelmen kívül hagyhatja a billentyűket.
A QR-olvasó Notepadben működik, a böngészőben nem
Az eszköz gépel. Az oldal nem fogadja ezeket a billentyűket. Ellenőrizze a fókuszt, azt a keydown figyelőt, amely nyomtatható billentyűkön preventDefault()-ot hív, és azt a figyelőt, amely csak a paste eseményt kezeli. Az ékeléses bemenet nem vált ki paste eseményt. Hasonlítsa össze a tesztelő eredményét az alkalmazás mezőjével.
Az olvasó vonalkódot olvas, QR-kódot nem
Az eszköz lehet csak 1D-s, vagy a QR szimbológia le lehet tiltva. Az oldal ezt nem tudja javítani. Erősítse meg a 2D támogatást, és engedélyezze a QR Code-ot az eszköz kézikönyvéből, a QR-kód tesztelése: a QR-olvasók tesztelése ellenőrzéseivel. A sikeres Code 128 beolvasás csak a billentyűzetes útvonalat bizonyítja.
Hibás karakterek
Először a QR-INPUT-TEST-12345 értéket olvassa be. Ha az egyezik, egy URL vagy JSON hasznos adat pedig nem, a kiosztás az írásjeleket változtatja, például a :, /, { vagy " jeleket. Hasonlítsa össze az event.key és az event.code értékét a billentyűzetesemény-tesztelőben, és lásd a A vonalkódolvasó billentyűzetkiosztása hibás oldalt. Igazítsa az olvasó billentyűzetkiosztását az operációs rendszeréhez.
Az ENTER kétszer küldi el az űrlapot
A böngésző elküldi az űrlapot, és egy keydown figyelő is kezeli az Entert. Egy lezárási útvonalat tartson meg, és ott hívja a preventDefault() függvényt. A második fizikai beolvasás más hiba. A példa státuszszövege azt mondja, hogy a hasznos adatot már elfogadták. Ha maga az első beolvasás két rekordot hoz létre, két figyelőt keressen, mielőtt az olvasón változtatna.
A QR-bemenet csonkolva van
Hasonlítsa össze a vonalkódbevitel-tesztelő karakterszámát a mezőben lévő értékkel. A maxlength attribútum, egy inputmaszk vagy a preventDefault() a karakterbillentyűkön elvághatja a karakterláncot. A QR hasznos adatban lévő sortörés az egysoros inputot korán elküldheti. Egyes olvasók azt is korlátozzák, hány karaktert gépelnek. Emelje meg ezt a korlátot az eszköz kézikönyvéből, ha a tesztelő, nemcsak az alkalmazás, rövid értéket mutat. A vonalkódolvasóról hiányzik az ENTER azt a kapcsolódó esetet fedi le, amikor a hasznos adat megérkezik, és az űrlap soha nem véglegesít.
Az olvasó nem tudja elolvasni a képernyőn lévő QR-kódot
Erősítse meg, hogy az olvasó 2D képalkotó. Növelje a kijelző fényerejét, növelje a kód méretét, és tartsa a csendes zónát szövegtől és szegélyektől tisztán. A tükröződés, a halvány telefonképernyő és a munkatávolsághoz képest túl sűrű kód optikai problémák. Nyomtassa ki ugyanazt a hasznos adatot, ha a képernyőről olvasás továbbra is sikertelen. Az alkalmazásteszt továbbra is az ismert karakterláncot használja, amint bármely beolvasás szöveget ad.