Barcode Scanner Emulator
Sådan tester du input fra QR-kodescannere i webapplikationer
Mange eksterne scannere, der kan læse QR, bruger tastaturkile og skriver den afkodede QR-tekst i det felt, der har fokus. Test den vej ved at scanne en kendt nyttelast og sammenligne den med den værdi, siden modtog. Ikke alle QR-scannere skriver som et tastatur. Serielle enheder og kameraafkodere er andre integrationer, og tastaturhændelser i browseren identificerer ikke den fysiske scanner.
En QR-kode gemmer data. Scanneren, eller en kameraafkoder, gør de data til tekst. Webapplikationen skal derefter modtage teksten, afgøre hvornår scanningen er færdig, og validere den. Denne vejledning er den applikationstest. At lave etiketter, tjekke kontrast og bekræfte, at en enhed kan afkode QR Code, er dækket i QR-kodetest: Sådan tester du QR-kodescannere. Almindelige stregkodeformularer, herunder kontrolcifre for EAN, er dækket i Sådan tester du stregkodescannere i webapplikationer.
Test QR-input på 60 sekunder
Brug en nyttelast, du selv har valgt, så et forkert tegn er tydeligt. Denne gennemgang bruger QR-INPUT-TEST-12345.
- Åbn QR-kodegeneratoren, og generer en QR-kode for
QR-INPUT-TEST-12345. Generatoren kører i browseren. Den kontakter ikke scanneren. - Tilslut en scanner, der kan læse QR, og som er sat til tastaturkile. En scanner, der kun klarer 1D, kan ikke afkode dette symbol.
- Åbn Stregkodeinput-testeren.
- Klik på Start test, eller klik i scanningsområdet, så feltet har fokus. Testeren tager ikke selv fokus, og den åbner ikke scanneren.
- Scan QR-koden.
- Læs den indfangede tekst og tegnantallet.
- Sammenlign teksten med
QR-INPUT-TEST-12345. Sammenligningen omfatter store og små bogstaver, bindestreger og længde. - Læs suffikset. Testeren rapporterer ENTER, TAB eller Ingen, når scanneren sender en af de taster.
Testeren registrerer tastaturhændelser, som browseren kan se. Den identificerer ikke USB-enheden, læser ikke en seriel port og afkoder ikke QR-billedet.
Inputtilstande for QR-scannere
Den samme trykte QR-kode kan ankomme gennem tre forskellige integrationer. En test af én tilstand øver ikke de andre.
QR-scannere med tastaturkile
I tilstanden USB HID-tastatur, eller Bluetooth HID-tastatur, behandler operativsystemet scanneren som et tastatur. Efter en afkodning skriver scanneren nyttelasten i den kontrol, der har fokus. Et almindeligt <input> eller <textarea> kan modtage den. Siden åbner ikke enheden. Vejledningen HID-tastaturkile beskriver tastesekvensen, præfikser og suffikser.
Fokus afgør destinationen. Hvis det fokuserede element er dokumentets body, en knap eller en anden ramme, ser lytterne på dette felt ikke scanningen.
Serielle QR-scannere
En USB-seriel scanner eller en scanner med virtuel COM-port sender den afkodede tekst som byte til den proces, der åbnede porten. Fokus vælger ikke den proces. Et felt, der kun lytter efter tastetryk, forbliver tomt, mens en terminal på den port viser nyttelasten.
Chromium-baserede browsere kan åbne en port, som brugeren har valgt, med Web Serial API, i en sikker kontekst, efter en brugergestus. Firefox og Safari stiller ikke det API til rådighed. En kile-scanner vises ikke som en seriel port. Portnavne, baud og indramning afhænger af enheden og driveren. USB HID over for serielle stregkodescannere sammenligner de to grænseflader. Stregkodeinput-testeren kan ikke læse en COM-port.
Kamerabaseret QR-scanning
En kameraintegration optager et billede og afkoder QR-koden i software. Siden bruger et kamera-API og en afkoder. Den modtager ikke keydown-hændelser for nyttelasten. Telefonkamera-apps, kameraknapper på siden og en hardware-billedlæser, der skriver i et felt, er tre forskellige produkter. En bestået kiletest betyder ikke, at kameraknappen virker, og en vellykket kameraafkodning betyder ikke, at en kile-scanner skriver den samme streng.
Indfang QR-input med JavaScript
Siden nedenfor læser ét felt med fokus. Enter sender formularen, og knappen Accept bruger den samme submit-håndtering, så én scanning behandles én gang. Uden et ENTER-suffiks bliver teksten i feltet, indtil nogen aktiverer Accept. Den indfangede nyttelast skrives med textContent, så tegn som < forbliver synlige som tekst.
Eksemplet accepterer tre applikationsformater: et billet-id som QR-INPUT-TEST-12345, en http- eller https-URL eller et JSON-objekt. Det registrerer den scannede tekst. Det navigerer ikke til en URL, der findes i QR-koden. En scanner, der ikke sender Enter, virker stadig via knappen. Tab går gennem etiketten, feltet og knappen som sædvanligt, fordi scriptet ikke fanger den.
<!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>
Gem filen, og åbn den i en desktopbrowser. Klik i feltet, før du scanner. autocomplete="off" mindsker risikoen for, at en gemt værdi erstatter scanningen. Etiketten og knappen er der stadig, så en person kan skrive en nyttelast uden en scanner.
Håndtér Enter kun i formularens submit-hændelse. En anden keydown-lytter for Enter registrerer den samme scanning to gange. preventDefault() holder browseren på denne side. Ryd feltet efter en afgørelse, så den næste scanning ikke føjes til den forrige tekst.
En QR-nyttelast kan indeholde et linjeskift. En kile-scanner skriver ofte det skift som Enter. I et input på én linje kan formularen blive sendt ved første linje og tabe resten. Brug en textarea, eller en seriel læser, der beholder bytene, når applikationen skal acceptere tekst på flere linjer. Bekræft den adfærd med en QR-kode, hvis nyttelast indeholder et linjeskift.
Håndtering af QR-nyttelaster
Et QR-symbol lover ikke et applikationsformat. Den samme symbologi kan bære et af disse:
- Almindelig tekst, for eksempel
QR-INPUT-TEST-12345. - En URL.
- En identifikator, som applikationen har valgt.
- En struktureret nyttelast, for eksempel et billetnummer plus en placeringskode.
- JSON-tekst, når applikationen har defineret den kodning.
Scanneren sender de afkodede tegn. Den kontrollerer ikke, at de matcher en billetregel, et produktkatalog eller et JSON-skema. Validér strengen på siden, og validér den igen på serveren. Den sendte værdi er almindeligt brugerinput. Browseren kan ikke bevise, at en scanner har frembragt den.
Validér QR-input
Gå ikke ud fra, at en QR-nyttelast er numerisk. Regler for EAN-13 gælder ikke. Behandl teksten som upålidelig: vis den som tekst, og tildel den ikke til location, innerHTML eller en script-URL.
Tomme værdier. Et bart Enter, eller Accept på et tomt felt, må ikke oprette en post. trim() afviser også en nyttelast, der kun består af mellemrum.
Uventede tegn. Sammenlign den modtagne streng med det kendte QR-indhold. Et forkert tastaturlayout ændrer ofte tegnsætning, mens længden er den samme. Afvis tegn, som formatet ikke tillader, og vis årsagen i statusteksten.
Nyttelastens længde. Håndhæv det maksimum, din applikation gemmer. maxlength på inputtet afkorter en længere scanning uden fejl. Sæt det kun, når hver accepteret nyttelast kan være der, og sammenlign testerens tegnantal med feltet, når en værdi ser kort ud.
Påkrævede præfikser. Et præfikstjek hører til applikationen. Denne billetregel accepterer QR- plus store bogstaver, cifre og bindestreger:
function isTicketId(value) {
return /^QR-[A-Z0-9-]{1,64}$/.test(value)
}
Fjern kun et scannerpræfiks, når den scanner er konfigureret til at sende ét præcist præfiks, og applikationen ikke gemmer det. En AIM-symbologiidentifikator er data, indtil du beslutter noget andet.
Applikationsspecifikke formater. Hold reglen ved siden af formatet. En billetformular, en liste over tilladte URL'er og et JSON-objekt kræver forskellige tjek. Ét numerisk mønster afviser gyldig QR-tekst.
Dobbeltscanninger. Én fysisk scanning kan ramme to lyttere. Brug én afslutningsvej, som eksemplet gør. Et andet tryk på aftrækkeren er en separat hændelse. Eksemplet afviser en nyttelast, det allerede har accepteret. En lagerformular kan i stedet tælle et antal op. Test den regel, din applikation dokumenterer.
Fejlagtig JSON. JSON.parse kaster ved ufuldstændig tekst. Kontrollér formen efter en vellykket tolkning. Et array eller et bart tal kan være gyldig JSON og alligevel have den forkerte type:
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.' }
}
}
Uventede URL'er. Fortolk URL'en for at se, om den kan bruges, og behold derefter den scannede streng, hvis testen skal matche QR-nyttelasten præcist. URL.href kan tilføje en skråstreg eller ændre kodningen. Acceptér kun de skemaer, applikationen har til hensigt. Åbn ikke URL'en som en bivirkning af scanningen:
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 }
}
Kontroltegn. Afvis ASCII-kontroltegn i en tastaturnyttelast, så et skjult præfiks forbliver synligt i statusteksten. CR og LF er kontroltegn. På en kile-scanner er Enter og Tab taster. De er ikke tegn inde i et normalt tekstinput. En seriel nyttelast kan stadig indeholde bytene 0x0D eller 0x0A. Fjern dem ved den serielle indramningsgrænse, og fjern ikke et CR, der hører til midt i en nyttelast på flere linjer.
Suffikserne ENTER og TAB
Et suffiks er valgfri scannerkonfiguration. Det er ikke en del af QR-symbolet. ENTER- og TAB-suffikser i stregkodescannere viser, hvordan tasterne skelnes. Læs suffikset i inputtesteren, og lad derefter siden passe til de scannere, du sætter i drift.
ENTER sender formularen for et tekstfelt på én linje i aktuelle browsere. Brug det, når én scanning skal bekræfte værdien. Kald preventDefault() på submit, når siden skal blive på plads.
TAB flytter fokus til den næste kontrol. Læs værdien i keydown, mens feltet stadig har fokus. Lad standardhandlingen blive, når det næste felt skal have fokus. Ignorér Shift+Tab, så en tastaturbruger kan gå baglæns.
Intet suffiks lader nyttelasten blive i feltet. Knappen Accept i eksemplet er afslutningsvejen. En inaktivitetstimer kan gætte på, at en pause betyder, at scanningen er slut. Den timer er en heuristik: et langsomt Bluetooth-burst og en person, der skriver hurtigt, kan begge krydse det samme hul. Foretræk et konfigureret suffiks, når arbejdsgangen har brug for en fast afslutning.
CR og LF er byte. Et tastatur-Enter er event.key === "Enter". De kan ikke byttes om. En lytter, der kun fjerner \r fra en inputværdi, ser ikke et kile-Enter, fordi tegnet aldrig blev indsat. En lytter, der kun holder øje med event.key, deler ikke en seriel buffer ved 0x0D. Nogle enheder sender NumPad Enter. event.key er stadig "Enter". Kontrollér event.key, ikke kun event.code === "Enter".
Suffikset kan ændre sig, når nogen scanner en konfigurationsstregkode fra enhedens manual. Test Enter, Tab og intet suffiks igen efter enhver konfigurationsændring. Find ikke på en programmeringsstregkode. Brug manualen til den model.
Fejlfind tastaturhændelser
Når den gemte tekst er forkert, så undersøg hændelserne i denne rækkefølge.
keydown. Udløses for hver tast, herunder Enter og Tab, før browseren indsætter et tegn eller flytter fokus. Læs afslutningstegnet her.
input. Udløses, efter at et udskrivbart tegn ændrer feltet. Det udløses ikke for Enter eller Tab på et tekstinput.
event.key. Tegnet eller tastenavnet, efter at operativsystemet har anvendt tastaturlayoutet.
event.code. Den fysiske tast, for eksempel Digit1 eller Numpad1. Den kan være uændret, når et forkert layout ændrer event.key.
Fokus. Log document.activeElement før scanningen. Hvis det ikke er QR-feltet, beskriver resten af sporet den forkerte kontrol. En iframe har sit eget fokus.
Rækkefølge. Ved en kilescanning i et tekstfelt følges udskrivbare keydown-hændelser af input-opdateringer og derefter en sidste keydown for Enter eller Tab, når det suffiks er konfigureret. change udløses, når feltet bekræfter, som regel ved blur. En scanning, der lader fokus blive i det samme felt, giver ikke change til sidst. Brug ikke change som det eneste afslutningssignal.
Timing. Scannere afslutter ofte en kort nyttelast på et godt stykke under et sekund. Inputtesteren sammenligner det gennemsnitlige mellemrum mellem tegn med en tærskel på 100 ms og mærker resultatet som timing, ikke som hardwareidentifikation. En person, der skriver hurtigt, autofyld eller emulatoren kan lande på scannersiden af den tærskel. En forsinket Bluetooth-scanning kan ligne indtastning. Kontrollér nyttelasten og suffikset. Behandl timing som et spor.
Tastaturhændelsestesteren oplister hvert keydown og keyup med key, code, modifikatorer og tidsstempler. Loggen er browserhændelser. Den er ikke rå USB-trafik.
Test uden en fysisk QR-scanner
Applikationslogik kan testes, før en scanner står på bordet.
- Skriv
QR-INPUT-TEST-12345i feltet, og aktivér Accept. Det tjekker validering og visning. Det tjekker ikke afkodning eller suffikser. - Driv det samme felt fra et automatiseringsværktøj i browseren, som næste afsnit gør.
- Brug Barcode Scanner Emulator, når du har brug for skrivning i scannerstil. Desktopprogrammet sender en værdi, du indtaster, med en skriveforsinkelse og et suffiks på ingen, ENTER eller TAB, ind i den applikation, der har fokus. Det genskaber tastaturvejen. Det fotograferer ikke et QR-billede, afkoder ikke et symbol og opretter ikke en virtuel COM-port.
Hardware er stadig nødvendig for optisk adfærd og enhedsadfærd: om den scanner kan læse den viste eller trykte kode, om QR-symbologien er slået til, tastaturlayout, suffikskonfiguration og serielle tilstande eller leverandør-SDK. Emulatoren er det rigtige tjek for tastaturvejen. Den er det forkerte tjek, når du skal bevise, at en enhed læser en bestemt QR-kode.
Automatisér QR-inputtests
De følgende Playwright-tests driver eksempelsiden. De skriver i feltet, som en kile-scanner ville, og kontrollerer derefter applikationens adfærd. De åbner ikke USB-enheder. @playwright/test er en afhængighed for den, der kører testen. Dette websted kræver det ikke.
Gem HTML-eksemplet som qr-form.html ved siden af denne test.
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 indsætter tegn i det felt, der har fokus. Det er ikke en USB-gadget. Testen af uventede tegn bruger fill, fordi målet er valideringsmeddelelsen og fraværet af et indsat element. Udvid filen med et URL-tilfælde og et JSON-tilfælde, når de formater er med i det build, du udgiver. En URL-kontrol skal sammenligne den indfangede tekst med den oprindelige QR-streng.
Testmatrix for QR-scannere
Kør disse mod applikationen under test. Eksempelsiden ovenfor dækker rækkerne for billet, URL, JSON, dublet, tom værdi og uventede tegn. En applikation, der kun tager tal eller flere linjer, skal have sit eget forventede resultat.
| Scenarie | Forventet resultat |
|---|---|
| QR med almindelig tekst | Præcis værdi modtaget |
| QR med URL | Hele URL'en indfanges, og siden navigerer ikke til den |
| Numerisk QR | Cifrene bevares |
| Specialtegn | Korrekte tegn modtaget |
| JSON-nyttelast | Data indfanges og valideres |
| Suffikset ENTER | Behandlingen sker én gang |
| Suffikset TAB | Fokusadfærden håndteres |
| Intet suffiks | Applikationen bruger en anden afslutningsmekanisme |
| Dobbeltscanning | Applikationen anvender sine dubletregler |
| Ugyldig nyttelast | Valideringsfejl vises |
| Manglende fokus | Applikationen håndterer fraværende input sikkert |
| Lang nyttelast | Ingen utilsigtet afkortning |
Scan også en nyttelast, der indeholder et linjeskift, hvis produktet skal gemme et. Notér, om feltet modtog hver linje.
Fejlfinding
Begynd med en kendt nyttelast i inputtesteren. Hvis testerens værdi allerede er forkert, er siden ikke den første fejl. Hvis testerens værdi er rigtig, og applikationen er forkert, ligger fejlen i fokus, validering eller hændelseshåndtering. Stregkodescanneren virker ikke er den bredere tjekliste for enheden. Sådan tester du input fra en stregkodescanner dækker fokus, layout og POS-arbejdsgange ud over denne formular.
Scanneren bipper, men der kommer intet input
Et bip betyder som regel, at scanneren afkodede et symbol. Det betyder ikke, at siden modtog teksten. Bekræft tastaturkile. Serielle tilstande og kameratilstande skriver ikke i feltet. Klik i feltet, så document.activeElement er det input, og scan derefter igen. Et deaktiveret, skrivebeskyttet eller skjult felt kan ignorere tasterne.
QR-scanneren virker i Notepad, men ikke i browseren
Enheden skriver. Siden accepterer ikke de taster. Tjek fokus, en keydown-lytter der kalder preventDefault() på udskrivbare taster, og en lytter der kun håndterer paste. Kileinput udløser ikke en paste-hændelse. Sammenlign testerens resultat med applikationsfeltet.
Scanneren læser stregkoder, men ikke QR-koder
Enheden kan være kun 1D, eller QR-symbologien kan være slået fra. Siden kan ikke rette det. Bekræft 2D-understøttelse, og slå QR Code til fra enhedens manual med tjekkene i QR-kodetest: Sådan tester du QR-kodescannere. En vellykket scanning af Code 128 beviser kun tastaturvejen.
Forkerte tegn
Scan QR-INPUT-TEST-12345 først. Hvis den matcher, og en URL eller JSON-nyttelast ikke gør, ændrer layoutet tegnsætning som :, /, { eller ". Sammenlign event.key med event.code i tastaturhændelsestesteren, og se Forkert tastaturlayout på stregkodescanneren. Få scannerens tastaturlayout til at passe til operativsystemet.
ENTER sender formularen to gange
Browseren sender formularen, og en keydown-lytter håndterer også Enter. Behold én afslutningsvej, og kald preventDefault() dér. En anden fysisk scanning er en anden fejl. Statusteksten i eksemplet siger, at nyttelasten allerede var accepteret. Hvis den første scanning selv opretter to poster, så led efter to lyttere, før du ændrer scanneren.
QR-input er afkortet
Sammenlign tegnantallet i inputtesteren med værdien i feltet. En maxlength-attribut, en inputmaske eller preventDefault() på tegntaster kan klippe strengen. Et linjeskift inde i QR-nyttelasten kan sende et input på én linje for tidligt. Nogle scannere begrænser også, hvor mange tegn de skriver. Hæv den grænse fra enhedens manual, når testeren, ikke kun applikationen, viser en kort værdi. Stregkodescanneren mangler ENTER dækker det beslægtede tilfælde, hvor nyttelasten ankommer, og formularen aldrig bekræfter.
Scanneren kan ikke læse en QR-kode på skærmen
Bekræft, at scanneren er en 2D-billedlæser. Skru op for skærmens lysstyrke, gør koden større, og hold stilzonen fri for tekst og rammer. Blænding, en mørk telefonskærm og en kode, der er for tæt til arbejdsafstanden, er optiske problemer. Udskriv den samme nyttelast, hvis skærmlæsningen bliver ved med at fejle. Applikationstesten bruger stadig den kendte streng, når en scanning først giver tekst.