Preskočiť na obsah

Barcode Scanner Emulator

Ako testovať vstup zo skenera QR kódov vo webových aplikáciách

Mnohé externé skenery, ktoré vedia QR, používajú klávesnicový klin a píšu dekódovaný text QR do poľa so zameraním. Túto cestu otestujte skenom známeho obsahu a porovnaním s hodnotou, ktorú stránka prijala. Nie každý skener QR píše ako klávesnica. Sériové zariadenia a dekodéry kamery sú iné integrácie a udalosti klávesnice v prehliadači fyzický skener neidentifikujú.

QR kód ukladá dáta. Skener, alebo dekodér kamery, z týchto dát spraví text. Webová aplikácia potom musí text prijať, rozhodnúť, kedy je sken hotový, a skontrolovať ho. Tento sprievodca je ten test aplikácie. Tvorba štítkov, kontrola kontrastu a overenie, že zariadenie vie dekódovať QR Code, sú v sprievodcovi Testovanie QR kódov: ako testovať skenery QR. Všeobecné formuláre čiarových kódov, vrátane kontrolných číslic EAN, sú v sprievodcovi Ako testovať skenery čiarových kódov vo webových aplikáciách.

Otestujte vstup QR za 60 sekúnd

Použite obsah, ktorý ste zvolili, aby bol zlý znak zrejmý. Tento postup používa QR-INPUT-TEST-12345.

  1. Otvorte generátor QR kódov a vygenerujte QR kód pre QR-INPUT-TEST-12345. Generátor beží v prehliadači. Skener nekontaktuje.
  2. Pripojte skener, ktorý vie QR a je nastavený na klávesnicový klin. Skener len pre 1D tento symbol nedekóduje.
  3. Otvorte stránku testera vstupu čiarových kódov.
  4. Kliknite na Spustiť test, alebo kliknite na oblasť skenovania, aby pole malo zameranie. Tester si zameranie sám neberie a skener neotvára.
  5. Naskenujte QR kód.
  6. Prečítajte zachytený text a počet znakov.
  7. Porovnajte text s QR-INPUT-TEST-12345. Zhoda zahŕňa veľkosť písmen, spojovníky a dĺžku.
  8. Prečítajte príponu. Tester hlási ENTER, TAB alebo Žiadna, keď skener pošle jednu z týchto kláves.

Tester zaznamenáva udalosti klávesnice, ktoré prehliadač vidí. Nerozpozná zariadenie USB, nečíta sériový port a nedekóduje obraz QR.

Režimy vstupu skenera QR

Ten istý vytlačený QR kód môže prísť troma rôznymi integráciami. Test jedného režimu neprecvičí ostatné.

Skenery QR s klávesnicovým klinom

V režime klávesnice USB HID alebo klávesnice Bluetooth HID operačný systém berie skener ako klávesnicu. Po dekódovaní skener napíše obsah do ovládacieho prvku, ktorý má zameranie. Bežný <input> alebo <textarea> ho môže prijať. Stránka zariadenie neotvára. Sprievodca Klávesnicový klin HID opisuje postupnosť klávesov, predpony a prípony.

Zameranie rozhoduje o cieli. Keď je prvkom so zameraním body dokumentu, tlačidlo alebo iný rám, poslucháči tohto poľa sken nevidia.

Sériové skenery QR

Skener USB serial alebo s virtuálnym portom COM posiela dekódovaný text ako bajty procesu, ktorý port otvoril. Zameranie tento proces nevyberá. Pole, ktoré len počúva stlačenia, ostane prázdne, kým terminál na tom porte obsah ukáže.

Prehliadače založené na Chromium môžu po geste používateľa v zabezpečenom kontexte otvoriť port vybraný používateľom cez Web Serial API. Firefox a Safari toto API nemajú. Klinový skener sa ako sériový port neukáže. Názvy portov, baud a rámec závisia od zariadenia a ovládača. Skenery čiarových kódov USB HID a sériové obe rozhrania porovnáva. Tester vstupu čiarových kódov port COM čítať nevie.

Skenovanie QR kamerou

Integrácia kamery urobí snímku a QR kód dekóduje v softvéri. Stránka používa API kamery a dekodér. Udalosti keydown pre obsah neprijíma. Aplikácie fotoaparátu v telefóne, tlačidlá kamery na stránke a hardvérový imager, ktorý píše do poľa, sú tri rôzne produkty. Úspešný test klinu neznamená, že tlačidlo kamery funguje, a úspešné dekódovanie kamerou neznamená, že klinový skener napíše ten istý reťazec.

Zachyťte vstup skenera QR pomocou JavaScriptu

Stránka nižšie číta jedno pole so zameraním. Enter formulár odošle a tlačidlo Accept používa tú istú obsluhu submit, takže jeden sken sa spracuje raz. Bez prípony ENTER text ostane v poli, kým niekto neaktivuje Accept. Zachytený obsah sa zapíše pomocou textContent, takže znaky ako < ostanú viditeľné ako text.

Príklad prijíma tri formáty aplikácie: identifikátor lístka ako QR-INPUT-TEST-12345, URL s http alebo https, alebo objekt JSON. Zaznamená naskenovaný text. Na URL nájdenú v QR kóde neprejde. Skener, ktorý Enter neposiela, stále funguje cez tlačidlo. Tab prechádza popisom, poľom a tlačidlom ako zvyčajne, pretože skript ho nezachytí.

<!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>

Súbor uložte a otvorte ho v desktopovom prehliadači. Pred skenom kliknite do poľa. autocomplete="off" znižuje šancu, že uložená hodnota sken nahradí. Popis a tlačidlo ostávajú k dispozícii, takže človek môže obsah napísať bez skenera.

Enter spracujte len v udalosti submit formulára. Druhý poslucháč keydown pre Enter zaznamená ten istý sken dvakrát. preventDefault() drží prehliadač na tejto stránke. Po rozhodnutí pole vymažte, aby sa ďalší sken nepripojil k predchádzajúcemu textu.

Obsah QR môže obsahovať zalomenie riadka. Klinový skener to zalomenie často napíše ako Enter. V jednoriadkovom vstupe sa formulár môže odoslať na prvom riadku a zvyšok zahodiť. Keď má aplikácia prijať viacriadkový text, použite textarea alebo sériové čítanie, ktoré bajty zachová. Správanie overte QR kódom, ktorého obsah obsahuje nový riadok.

Práca s obsahom QR

Symbol QR nesľubuje formát aplikácie. Tá istá symbolika môže niesť čokoľvek z tohto:

  • Obyčajný text, napríklad QR-INPUT-TEST-12345.
  • URL.
  • Identifikátor zvolený aplikáciou.
  • Štruktúrovaný obsah, napríklad číslo lístka a kód miesta.
  • Text JSON, keď aplikácia toto kódovanie definovala.

Skener prenáša dekódované znaky. Nekontroluje, že zodpovedajú pravidlu lístka, katalógu produktov alebo schéme JSON. Reťazec skontrolujte na stránke a znova na serveri. Odoslaná hodnota je bežný vstup používateľa. Prehliadač nemôže dokázať, že ju vytvoril skener.

Kontrola vstupu QR

Nepredpokladajte, že obsah QR je číselný. Pravidlá EAN-13 neplatia. S textom zaobchádzajte ako s nedôveryhodným: zobrazte ho ako text a nepriraďujte ho do location, innerHTML ani do URL skriptu.

Prázdne hodnoty. Holý Enter alebo Accept na prázdnom poli nemá vytvoriť záznam. trim() odmietne aj obsah, ktorý sú len medzery.

Neočakávané znaky. Porovnajte prijatý reťazec so známym obsahom QR. Nesúlad rozloženia klávesnice často zmení interpunkciu, kým dĺžka ostane rovnaká. Odmietnite znaky, ktoré formát nedovoľuje, a dôvod ukážte v stavovom texte.

Dĺžka obsahu. Vynúťte maximum, ktoré aplikácia ukladá. maxlength na vstupe dlhší sken skráti bez chyby. Nastavte ho len vtedy, keď sa každý prijímaný obsah zmestí, a keď hodnota vyzerá krátko, porovnajte počet znakov v testeri s poľom.

Povinné predpony. Kontrola predpony patrí aplikácii. Toto pravidlo lístka prijíma QR- plus veľké písmená, číslice a spojovníky:

function isTicketId(value) {
  return /^QR-[A-Z0-9-]{1,64}$/.test(value)
}

Predponu skenera odoberajte len vtedy, keď je skener nastavený posielať jednu presnú predponu a aplikácia ju neukladá. Identifikátor symboliky AIM je dáta, kým nerozhodnete inak.

Formáty podľa aplikácie. Pravidlo držte pri formáte. Formulár lístka, zoznam povolených URL a objekt JSON potrebujú rôzne kontroly. Jeden číselný vzor odmietne platný text QR.

Duplicitné skeny. Jeden fyzický sken môže trafiť dvoch poslucháčov. Použite jednu cestu dokončenia, ako to robí príklad. Druhé stlačenie spúšte je samostatná udalosť. Príklad odmietne obsah, ktorý už prijal. Skladový formulár môže namiesto toho zvýšiť množstvo. Otestujte pravidlo, ktoré aplikácia opisuje.

Poškodený JSON. JSON.parse pri neúplnom texte vyhodí výnimku. Po úspešnom rozbore skontrolujte tvar. Pole alebo holé číslo môže byť platný JSON a predsa nesprávny typ:

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.' }
  }
}

Neočakávané URL. URL rozoberte, aby ste videli, či je použiteľná, a naskenovaný reťazec si nechajte, keď test musí presne zodpovedať obsahu QR. URL.href môže pridať lomku alebo zmeniť kódovanie. Prijímajte len schémy, ktoré aplikácia zamýšľa. URL neotvárajte ako vedľajší účinok skenu:

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 }
}

Riadiace znaky. Vo vstupe z klávesnice odmietnite riadiace znaky ASCII, aby skrytá predpona ostala viditeľná v stavovom texte. CR a LF sú riadiace znaky. Pri klinovom skeneri sú Enter a Tab klávesy. Nie sú to znaky vnútri bežného textového vstupu. Sériový obsah môže stále obsahovať bajty 0x0D alebo 0x0A. Odoberte ich na hranici sériového rámca a neodeberajte CR, ktoré patrí doprostred viacriadkového obsahu.

Prípony ENTER a TAB

Prípona je voliteľné nastavenie skenera. Nie je súčasťou symbolu QR. Prípony ENTER a TAB v skeneroch čiarových kódov ukazuje, ako klávesy rozlíšiť. Prečítajte príponu v testeri vstupu a stránku potom prispôsobte skenerom, ktoré nasadzujete.

ENTER v súčasných prehliadačoch odošle formulár jednoriadkového textového poľa. Použite ho, keď má jeden sken hodnotu potvrdiť. Zavolajte preventDefault() na submit, keď má stránka ostať na mieste.

TAB presunie zameranie na ďalší ovládací prvok. Hodnotu čítajte v keydown, kým pole zameranie ešte má. Predvolenú akciu nechajte, keď má zameranie dostať ďalšie pole. Ignorujte Shift+Tab, aby používateľ klávesnice mohol ísť späť.

Žiadna prípona nechá obsah v poli. Tlačidlo Accept v príklade je cesta dokončenia. Časovač nečinnosti môže odhadnúť, že pauza znamená koniec skenu. Ten časovač je heuristika: pomalý zhluk Bluetooth a človek, ktorý píše rýchlo, môžu prekročiť tú istú medzeru. Keď postup potrebuje pevný koniec, dajte prednosť nastavenej prípone.

CR a LF sú bajty. Enter z klávesnice je event.key === "Enter". Nie sú zameniteľné. Poslucháč, ktorý z hodnoty vstupu len odstraňuje \r, klinový Enter neuvidí, pretože znak sa nikdy nevložil. Poslucháč, ktorý len sleduje event.key, sériový buffer na 0x0D nerozdelí. Niektoré skenery posielajú NumPad Enter. event.key je stále "Enter". Kontrolujte event.key, nie len event.code === "Enter".

Prípona sa môže zmeniť, keď niekto naskenuje konfiguračný čiarový kód z návodu zariadenia. Po každej zmene nastavenia znova otestujte Enter, Tab a žiadnu príponu. Nevymýšľajte programovací čiarový kód. Použite návod k danému modelu.

Ladenie udalostí klávesnice

Keď je uložený text nesprávny, prezrite udalosti v tomto poradí.

keydown. Spustí sa pre každý kláves, vrátane Enter a Tab, skôr než prehliadač vloží znak alebo presunie zameranie. Ukončovací kláves čítajte tu.

input. Spustí sa, keď tlačiteľný znak zmení pole. Pre Enter alebo Tab na textovom vstupe sa nespustí.

event.key. Znak alebo názov klávesu potom, čo operačný systém použije rozloženie klávesnice.

event.code. Fyzický kláves, napríklad Digit1 alebo Numpad1. Môže ostať rovnaký, keď zlé rozloženie zmení event.key.

Zameranie. Pred skenom zapíšte document.activeElement. Keď to nie je pole QR, zvyšok stopy opisuje nesprávny ovládací prvok. Iframe má vlastné zameranie.

Poradie. Pri klinovom skene do textového poľa po tlačiteľných udalostiach keydown nasledujú aktualizácie input a potom záverečné keydown pre Enter alebo Tab, keď je tá prípona nastavená. change sa spustí, keď pole hodnotu potvrdí, zvyčajne pri blur. Sken, ktorý nechá zameranie v tom istom poli, na konci change nevyvolá. Nepoužívajte change ako jediný signál dokončenia.

Časovanie. Skenery krátky obsah často dokončia výrazne pod sekundu. Tester vstupu porovná priemernú medzeru medzi znakmi s prahom 100 ms a výsledok označí ako časovanie, nie ako identifikáciu hardvéru. Človek, ktorý píše rýchlo, automatické vypĺňanie alebo emulátor môžu spadnúť na stranu skenera pri tomto prahu. Oneskorený sken Bluetooth môže vyzerať ako písanie. Overte obsah a príponu. Časovanie berte ako stopu.

Tester udalostí klávesnice vypisuje každé keydown a keyup s key, code, modifikátormi a časovými značkami. Záznam sú udalosti prehliadača. Nie je to surová prevádzka USB.

Test bez fyzického skenera QR

Logiku aplikácie možno testovať skôr, než skener leží na stole.

  • Napíšte QR-INPUT-TEST-12345 do poľa a aktivujte Accept. To skontroluje validáciu a zobrazenie. Nekontroluje dekódovanie ani prípony.
  • To isté pole riaďte nástrojom automatizácie prehliadača, ako to robí ďalšia časť.
  • Použite Barcode Scanner Emulator, keď potrebujete písanie v štýle skenera. Desktopová aplikácia pošle hodnotu, ktorú zadáte, s oneskorením písania a príponou žiadna, ENTER alebo TAB do aplikácie so zameraním. Napodobňuje cestu klávesnice. Nevyfotí obraz QR, nedekóduje symbol a nevytvorí virtuálny port COM.

Hardvér je stále nutný pre optické správanie a správanie zariadenia: či ten skener prečíta zobrazený alebo vytlačený kód, či je symbolika QR zapnutá, rozloženie klávesnice, nastavenie prípony a sériové režimy alebo SDK výrobcu. Emulátor je správna kontrola cesty klávesnice. Je to nesprávna kontrola, keď máte dokázať, že zariadenie číta konkrétny QR kód.

Automatizujte testy vstupu QR

Nasledujúce testy Playwright riadia ukážkovú stránku. Píšu do poľa tak, ako by to urobil klinový skener, a potom overujú správanie aplikácie. Zariadenia USB neotvárajú. @playwright/test je závislosť pre toho, kto test spúšťa. Tento web ju nevyžaduje.

HTML príklad uložte ako qr-form.html vedľa tohto testu.

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 vkladá znaky do poľa so zameraním. Nie je to USB gadget. Test neočakávaných znakov používa fill, pretože cieľom je správa kontroly a neprítomnosť vloženého prvku. Súbor rozšírte o prípad URL a prípad JSON, až budú tieto formáty v builde, ktorý vydávate. Kontrola URL má porovnať zachytený text s pôvodným reťazcom QR.

Testovacia matica skenera QR

Spustite ich proti testovanej aplikácii. Ukážková stránka vyššie pokrýva riadky lístka, URL, JSON, duplicity, prázdnej hodnoty a neočakávaných znakov. Aplikácia len pre čísla alebo pre viac riadkov potrebuje vlastný očakávaný výsledok.

Scenár Očakávaný výsledok
Obyčajný text QR Presná hodnota prijatá
QR s URL Celá URL zachytená a stránka na ňu neprejde
Číselné QR Číslice zachované
Špeciálne znaky Správne znaky prijaté
Obsah JSON Dáta zachytené a skontrolované
Prípona ENTER Spracovanie prebehne raz
Prípona TAB Správanie zamerania je ošetrené
Žiadna prípona Aplikácia použije iný mechanizmus dokončenia
Duplicitný sken Aplikácia použije svoje pravidlá duplicít
Neplatný obsah Zobrazí sa chyba kontroly
Chýbajúce zameranie Aplikácia chýbajúci vstup ošetrí bezpečne
Dlhý obsah Žiadne nezamýšľané skrátenie

Naskenujte aj obsah, ktorý obsahuje nový riadok, ak ho produkt musí uložiť. Zapíšte, či pole prijalo každý riadok.

Riešenie problémov

Začnite známym obsahom v testeri vstupu. Keď je hodnota testera už nesprávna, stránka nie je prvá porucha. Keď je hodnota testera správna a aplikácia nesprávna, porucha je v zameraní, kontrole alebo spracovaní udalostí. Skener čiarových kódov nefunguje je širší kontrolný zoznam zariadenia. Ako testovať vstup zo skenera čiarových kódov pokrýva zameranie, rozloženie a postupy POS nad rámec tohto formulára.

Skener pípa, ale vstup sa neobjaví

Pípnutie zvyčajne znamená, že skener dekódoval symbol. Neznamená to, že stránka text prijala. Overte klávesnicový klin. Sériové režimy a režimy kamery do poľa nepíšu. Kliknite do poľa, aby document.activeElement bol tento vstup, a skenujte znova. Zakázané, len na čítanie alebo skryté pole môže klávesy ignorovať.

Skener QR funguje v Notepade, ale nie v prehliadači

Zariadenie píše. Stránka tieto klávesy neprijíma. Skontrolujte zameranie, poslucháča keydown, ktorý na tlačiteľných klávesoch volá preventDefault(), a poslucháča, ktorý rieši len paste. Vstup klinom udalosť paste nespustí. Porovnajte výsledok testera s poľom aplikácie.

Skener číta čiarové kódy, ale nie QR kódy

Zariadenie môže byť len 1D, alebo môže byť symbolika QR vypnutá. Stránka to neopraví. Overte podporu 2D a zapnite QR Code podľa návodu zariadenia, s kontrolami v sprievodcovi Testovanie QR kódov: ako testovať skenery QR. Úspešný sken Code 128 dokazuje len cestu klávesnice.

Nesprávne znaky

Najprv naskenujte QR-INPUT-TEST-12345. Keď sa zhoduje a URL alebo obsah JSON nie, rozloženie mení interpunkciu ako :, /, { alebo ". Porovnajte event.key s event.code v testeri udalostí klávesnice a pozrite Nesprávne rozloženie klávesnice skenera čiarových kódov. Zlaďte rozloženie klávesnice skenera s operačným systémom.

ENTER odošle formulár dvakrát

Prehliadač formulár odošle a poslucháč keydown Enter tiež spracuje. Nechajte jednu cestu dokončenia a zavolajte tam preventDefault(). Druhý fyzický sken je iná porucha. Stavový text v príklade hovorí, že obsah už bol prijatý. Keď už prvý sken sám vytvorí dva záznamy, hľadajte dvoch poslucháčov, kým skener zmeníte.

Vstup QR je skrátený

Porovnajte počet znakov v testeri vstupu s hodnotou v poli. Atribút maxlength, maska vstupu alebo preventDefault() na znakových klávesoch môžu reťazec useknúť. Nový riadok vnútri obsahu QR môže jednoriadkový vstup odoslať predčasne. Niektoré skenery tiež obmedzujú, koľko znakov napíšu. Limit zvýšte podľa návodu zariadenia, keď krátku hodnotu ukazuje tester, nielen aplikácia. Skeneru čiarových kódov chýba ENTER pokrýva príbuzný prípad, keď obsah dorazí a formulár sa nikdy nepotvrdí.

Skener neprečíta QR kód na obrazovke

Overte, že skener je 2D imager. Zvýšte jas displeja, zväčšite kód a nechajte tichú zónu bez textu a okrajov. Odlesk, tmavá obrazovka telefónu a kód príliš hustý na pracovnú vzdialenosť sú optické problémy. Keď čítanie z obrazovky ďalej zlyháva, vytlačte ten istý obsah. Test aplikácie stále používa známy reťazec, keď nejaký sken vytvorí text.