Liigu sisu juurde

Barcode Scanner Emulator

Kuidas testida QR-koodi skanneri sisendit veebirakendustes

Paljud välised QR-võimelised skannerid kasutavad klaviatuurikiilu režiimi ja trükivad dekodeeritud QR-teksti fookuses olevasse välja. Testige seda teed, skannides tuntud andmesisu ja võrreldes seda väärtusega, mille leht sai. Mitte iga QR-skanner ei trüki nagu klaviatuur. Jadaseadmed ja kaamera dekoodrid on teised integratsioonid ning brauseri klaviatuurisündmused ei tuvasta füüsilist skannerit.

QR-kood salvestab andmeid. Skanner või kaamera dekooder muudab need andmed tekstiks. Veebirakendus peab selle teksti vastu võtma, otsustama, millal skann on lõppenud, ja selle üle kontrollima. See juhend on see rakenduse test. Siltide loomine, kontrasti kontroll ja kinnitus, et seade suudab QR Code dekodeerida, on juhendis QR-koodi testimine: kuidas testida QR-koodi skannereid. Üldised vöötkoodivormid, sealhulgas EAN-i kontrollnumbrid, on juhendis Kuidas testida vöötkoodiskannereid veebirakendustes.

QR-skanneri sisendi test 60 sekundiga

Kasutage andmesisu, mille ise valisite, et vale märk oleks ilmne. See läbivaatus kasutab väärtust QR-INPUT-TEST-12345.

  1. Avage QR-koodi generaator ja genereerige QR-kood väärtusele QR-INPUT-TEST-12345. Generaator töötab brauseris. See ei võta skanneriga ühendust.
  2. Ühendage QR-võimeline skanner, mis on seatud klaviatuurikiilu režiimi. Ainult 1D-skanner ei suuda seda sümbolit dekodeerida.
  3. Avage vöötkoodisisendi testerit.
  4. Klõpsake Alusta testi või klõpsake skannimisala, et väljal oleks fookus. Tester ei võta fookust ise ega ava skannerit.
  5. Skannige QR-kood.
  6. Lugege hõivatud tekst ja märkide arv.
  7. Võrrelge seda teksti väärtusega QR-INPUT-TEST-12345. Vaste hõlmab suur- ja väiketähti, sidekriipse ja pikkust.
  8. Lugege järelliide. Tester teatab ENTER, TAB või Puudub, kui skanner saadab ühe neist klahvidest.

Tester salvestab klaviatuurisündmused, mida brauser näeb. See ei tuvasta USB-seadet, ei loe jadaporti ega dekodeeri QR-pilti.

QR-skanneri sisendi režiimid

Sama trükitud QR-kood võib saabuda kolme erineva integratsiooni kaudu. Ühe režiimi test teisi ei läbi.

Klaviatuurikiilu QR-skannerid

USB HID-klaviatuuri režiimis või Bluetooth HID-klaviatuuri režiimis kohtleb operatsioonisüsteem skannerit klaviatuurina. Pärast dekodeerimist trükib skanner andmesisu juhtelementi, millel on fookus. Tavaline <input> või <textarea> saab selle vastu võtta. Leht seadet ei ava. Juhend HID-klaviatuurikiil kirjeldab klahvivajutuste jada, eesliiteid ja järelliiteid.

Fookus otsustab sihtkoha. Kui fookuses olev element on dokumendi keha, nupp või muu raam, ei näe selle välja kuulajad skanni.

Jada-QR-skannerid

USB-jada või virtuaalse COM-pordi skanner saadab dekodeeritud teksti baitidena protsessile, mis pordi avas. Fookus seda protsessi ei vali. Väli, mis kuulab ainult klahvivajutusi, jääb tühjaks, samal ajal kui terminal sellel pordil näitab andmesisu.

Chromiumil põhinevad brauserid saavad turvalises kontekstis pärast kasutaja žesti avada kasutaja valitud pordi Web Serial API-ga. Firefox ja Safari seda API-t ei paku. Kiiluskanner ei ilmu jadapordina. Pordinimed, bodikiirus ja kadreering sõltuvad seadmest ja draiverist. USB HID ja jada-vöötkoodiskannerid võrdleb kaht liidest. Vöötkoodisisendi tester ei saa COM-porti lugeda.

Kaamerapõhine QR-skannimine

Kaamera integratsioon jäädvustab pildi ja dekodeerib QR-koodi tarkvaras. Leht kasutab kaamera API-t ja dekoodrit. See ei saa andmesisu jaoks keydown-sündmusi. Telefoni kaamerarakendused, lehe kaameranupud ja riistvaraline pildiskanner, mis trükib välja, on kolm erinevat toodet. Läbitud kiilu test ei tähenda, et kaameranupp töötab, ja õnnestunud kaamera dekodeerimine ei tähenda, et kiiluskanner trükib sama stringi.

QR-skanneri sisendi hõive JavaScriptiga

Allolev leht loeb üht fookuses olevat välja. Enter saadab vormi ja nupp Accept kasutab sama saatmiskäsitlejat, nii et üks skann töödeldakse ühe korra. Ilma ENTER-järelliiteta jääb tekst välja, kuni keegi aktiveerib Accept. Hõivatud andmesisu kirjutatakse textContent abil, nii et märgid nagu < jäävad tekstina nähtavaks.

Näide võtab vastu kolm rakenduse vormingut: pileti identifikaatori, näiteks QR-INPUT-TEST-12345, http- või https-URL-i või JSON-objekti. See salvestab skannitud teksti. See ei liigu QR-koodist leitud URL-ile. Skanner, mis Enterit ei saada, töötab ikkagi nupu kaudu. Tab liigub nagu tavaliselt sildi, välja ja nupu vahel, sest skript seda ei püüa.

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

Salvestage fail ja avage see töölauabrauseris. Enne skannimist klõpsake välja. autocomplete="off" vähendab võimalust, et salvestatud väärtus asendab skanni. Silt ja nupp jäävad kättesaadavaks, nii et inimene saab andmesisu sisestada ilma skannerita.

Käsitlege Enterit ainult vormi submit-sündmuses. Teine keydown-kuulaja Enteri jaoks salvestab sama skanni kaks korda. preventDefault() hoiab brauseri sellel lehel. Pärast otsust tühjendage väli, et järgmine skann ei lisanduks eelmisele tekstile.

QR-andmesisu võib sisaldada reavahetust. Kiiluskanner trükib selle vahetuse sageli Enterina. Üherealises sisendis võib vorm saata esimese rea juures ja ülejäänu kaotada. Kasutage textarea-d või jadaseadme lugejat, mis hoiab baidid alles, kui rakendus peab vastu võtma mitmerealist teksti. Kinnitage seda käitumist QR-koodiga, mille andmesisu sisaldab uut rida.

QR-andmesisu käsitlemine

QR-sümbol ei luba rakenduse vormingut. Sama sümboloogia võib kanda ükskõik mida neist:

  • Lihtteksti, näiteks QR-INPUT-TEST-12345.
  • URL-i.
  • Identifikaatorit, mille valib rakendus.
  • Struktureeritud andmesisu, näiteks pileti numbrit ja asukohakoodi.
  • JSON-teksti, kui rakendus määras selle kodeeringu.

Skanner edastab dekodeeritud märgid. See ei kontrolli, kas need vastavad pileti reeglile, tootekataloogile või JSON-skeemile. Kontrollige stringi lehel ja uuesti serveris. Saadetud väärtus on tavaline kasutaja sisend. Brauser ei saa tõestada, et selle tekitas skanner.

QR-sisendi kontroll

Ärge eeldage, et QR-andmesisu on numbriline. EAN-13 reeglid ei kehti. Käsitlege teksti ebausaldusväärsena: kuvage see tekstina ja ärge omistage seda location-ile, innerHTML-ile ega skripti URL-ile.

Tühjad väärtused. Paljas Enter või Accept tühjal väljal ei tohi luua kirjet. trim() lükkab tagasi ka andmesisu, mis on ainult tühikud.

Ootamatud märgid. Võrrelge saadud stringi tuntud QR-sisuga. Klaviatuuripaigutuse mittevastavus muudab sageli kirjavahemärke, pikkus jääb aga samaks. Lükake tagasi märgid, mida vorming ei luba, ja näidake põhjust olekutekstis.

Andmesisu pikkus. Jõustage maksimum, mida teie rakendus salvestab. maxlength sisendil kärbib pikema skanni veata. Seadke see ainult siis, kui iga vastuvõetav andmesisu mahub, ja võrrelge testeri märkide arvu väljaga, kui väärtus näib lühike.

Nõutavad eesliited. Eesliite kontroll kuulub rakendusele. See pileti reegel võtab vastu QR- ning suurtähed, numbrid ja sidekriipsud:

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

Eemaldage skanneri eesliide ainult siis, kui see skanner on seadistatud saatma üht täpset eesliidet ja rakendus seda ei salvesta. AIM-sümboloogia identifikaator on andmed, kuni otsustate teisiti.

Rakendusepõhised vormingud. Hoidke reegel vormingu kõrval. Piletivorm, URL-ide lubatud loend ja JSON-objekt vajavad erinevaid kontrolle. Üks numbriline muster lükkaks kehtiva QR-teksti tagasi.

Topeltskannid. Üks füüsiline skann võib tabada kahte kuulajat. Kasutage üht lõpetamisteed, nagu näide teeb. Teine päästiku tõmme on eraldi sündmus. Näide lükkab tagasi andmesisu, mille see on juba vastu võtnud. Laovorm võib selle asemel kogust suurendada. Testige reeglit, mida teie rakendus dokumenteerib.

Vigane JSON. JSON.parse viskab erindi, kui tekst on poolik. Pärast õnnestunud sõelumist kontrollige kuju. Massiiv või paljas arv võib olla kehtiv JSON ja ikkagi vale tüüp:

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

Ootamatud URL-id. Sõeluge URL, et näha, kas see on kasutatav, ja hoidke seejärel skannitud string alles, kui test peab QR-andmesisuga täpselt kattuma. URL.href võib lisada kaldkriipsu või muuta kodeeringut. Võtke vastu ainult skeemid, mida rakendus ette näeb. Ärge avage URL-i skanni kõrvalmõjuna:

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

Juhtmärgid. Lükake klaviatuuri andmesisus ASCII juhtmärgid tagasi, et peidetud eesliide jääks olekutekstis nähtavaks. CR ja LF on juhtmärgid. Kiiluskanneril on Enter ja Tab klahvid. Need ei ole märgid tavalises tekstisisendis. Jadaandmesisu võib ikkagi sisaldada baite 0x0D või 0x0A. Eemaldage need jadakadreeringu piiril ja ärge eemaldage CR-i, mis kuulub mitmerealise andmesisu keskele.

ENTER- ja TAB-järelliited

Järelliide on valikuline skanneri seadistus. See ei ole QR-sümboli osa. ENTER ja TAB järelliited vöötkoodiskannerites näitab, kuidas klahve eristada. Lugege järelliide sisendi testeris, seejärel kohandage leht skanneritega, mida juurutate.

ENTER saadab praegustes brauserites üherealise tekstivälja vormi. Kasutage seda, kui üks skann peab väärtuse kinnitama. Kutsuge preventDefault() sündmusel submit, kui leht peab paigale jääma.

TAB viib fookuse järgmisele juhtelemendile. Lugege väärtus keydown ajal, kui väljal on veel fookus. Jätke vaiketoiming alles, kui järgmine väli peab fookuse saama. Ignoreerige Shift+Tab, et klaviatuurikasutaja saaks tagasi liikuda.

Järelliide puudub jätab andmesisu välja. Näite nupp Accept on lõpetamistee. Tegevusetuse taimer võib arvata, et paus tähendab skanni lõppu. See taimer on heuristika: aeglane Bluetoothi purse ja kiire tippija võivad ületada sama vahe. Eelistage seadistatud järelliidet, kui töövoog vajab kindlat lõppu.

CR ja LF on baidid. Klaviatuuri Enter on event.key === "Enter". Need ei ole asendatavad. Kuulaja, mis eemaldab sisendi väärtusest ainult \r, ei näe kiilu Enterit, sest märki ei lisatud kunagi. Kuulaja, mis jälgib ainult event.key, ei tükelda jadapuhvrit 0x0D juures. Mõni seade saadab NumPad Enteri. event.key on ikka "Enter". Kontrollige event.key, mitte ainult event.code === "Enter".

Järelliide võib muutuda, kui keegi skannib seadistusvöötkoodi seadme juhendist. Pärast iga seadistuse muutmist testige uuesti Enterit, Tabi ja järelliite puudumist. Ärge leiutage programmeerimisvöötkoodi. Selle mudeli jaoks kasutage juhendit.

Klaviatuurisündmuste silumine

Kui salvestatud tekst on vale, uurige sündmusi selles järjekorras.

keydown. Käivitub iga klahvi puhul, sealhulgas Enter ja Tab, enne kui brauser märgi lisab või fookust liigutab. Lugege lõpetaja siin.

input. Käivitub pärast seda, kui trükitav märk muudab välja. Tekstisisendil ei käivitu see Enteri ega Tabi puhul.

event.key. Märk või klahvi nimi pärast seda, kui operatsioonisüsteem rakendab klaviatuuripaigutuse.

event.code. Füüsiline klahv, näiteks Digit1 või Numpad1. See võib jääda samaks, kui paigutuse mittevastavus muudab event.key.

Fookus. Logige document.activeElement enne skanni. Kui see ei ole QR-väli, kirjeldab ülejäänud jälg vale juhtelementi. Iframe'il on oma fookus.

Järjekord. Kiiluskannil tekstivälja järgnevad trükitavatele keydown-sündmustele input-uuendused, seejärel lõplik keydown Enterile või Tabile, kui see järelliide on seadistatud. change käivitub, kui väli kinnitatakse, tavaliselt fookuse kaotamisel. Skann, mis jätab fookuse samale väljale, ei tekita lõpus change. Ärge kasutage change ainsa lõpetamise signaalina.

Ajastus. Skannerid lõpetavad lühikese andmesisu sageli tublisti alla sekundi. Sisendi tester võrdleb keskmist vahet märkide vahel 100 ms lävega ja sildistab tulemuse ajastusena, mitte riistvara tuvastusena. Kiire tippija, automaattäitmine või emulaator võib sattuda selle läve skanneri poolele. Hilinenud Bluetoothi skann võib paista tippimisena. Kinnitage andmesisu ja järelliide. Võtke ajastust vihjena.

Kasutage klaviatuurisündmuste testerit. See loetleb iga keydown ja keyup koos key, code, muuteklahvide ja ajatemplitega. Logi on brauseri sündmused. See ei ole toores USB-liiklus.

Test ilma füüsilise QR-skannerita

Rakenduse loogikat saab testida enne, kui skanner on laual.

  • Tippige väljale QR-INPUT-TEST-12345 ja aktiveerige Accept. See kontrollib valideerimist ja kuvamist. See ei kontrolli dekodeerimist ega järelliiteid.
  • Juhtige sama välja brauseri automatiseerimisvahendiga, nagu teeb järgmine jaotis.
  • Kasutage rakendust Barcode Scanner Emulator, kui vajate skannerilaadset tippimist. Töölauarakendus saadab teie sisestatud väärtuse tippimisviivituse ja järelliitega Puudub, ENTER või TAB fookuses olevasse rakendusse. See kordab klaviatuuriteed. See ei pildista QR-pilti, ei dekodeeri sümbolit ega loo virtuaalset COM-porti.

Riistvara on endiselt vajalik optilise ja seadme käitumise jaoks: kas see skanner suudab kuvatud või trükitud koodi lugeda, kas QR-sümboloogia on lubatud, klaviatuuripaigutus, järelliite seadistus ning jada- või tootja SDK-režiimid. Emulaator on õige kontroll klaviatuuriteele. See on vale kontroll tõestamaks, et seade loeb kindlat QR-koodi.

QR-sisendi testide automatiseerimine

Järgnevad Playwrighti testid juhivad näidislehte. Need trükivad välja nii, nagu teeks kiiluskanner, ja seejärel kinnitavad rakenduse käitumist. Need ei ava USB-seadmeid. @playwright/test on lugeja sõltuvus. See sait seda ei nõua.

Salvestage HTML-näide nimega qr-form.html selle testi kõrvale.

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 lisab märgid fookuses olevasse välja. See ei ole USB-seade. Ootamatute märkide test kasutab fill, sest eesmärk on valideerimissõnum ja sisestatud elemendi puudumine. Laiendage faili URL-i juhtumi ja JSON-i juhtumiga, kui need vormingud on väljalaskes, mille tarnite. URL-i kinnitus peab võrdlema hõivatud teksti algse QR-stringiga.

QR-skanneri testimaatriks

Käivitage need testitava rakenduse vastu. Ülaltoodud näidisleht katab pileti, URL-i, JSON-i, duplikaadi, tühja väärtuse ja ootamatute märkide read. Ainult numbrilisel või mitmerealisel rakendusel on vaja oma oodatavat tulemust.

Stsenaarium Oodatav tulemus
Lihttekstiga QR Saadud on täpne väärtus
URL-iga QR Kogu URL on hõivatud ja leht sellele ei liigu
Numbriline QR Numbrid on säilinud
Erimärgid Saadud on õiged märgid
JSON-andmesisu Andmed on hõivatud ja kontrollitud
ENTER-järelliide Töötlus toimub ühe korra
TAB-järelliide Fookuse käitumine on käsitletud
Järelliide puudub Rakendus kasutab muud lõpetamismehhanismi
Topeltskann Rakendus rakendab duplikaatide käsitlemise reegleid
Vigane andmesisu Kuvatakse valideerimisviga
Puuduv fookus Rakendus käsitleb puuduvat sisendit ohutult
Pikk andmesisu Soovimatut kärpimist ei ole

Skannige ka andmesisu, mis sisaldab uut rida, kui toode peab selle salvestama. Märkige üles, kas väli sai iga rea.

Tõrkeotsing

Alustage tuntud andmesisuga sisendi testeris. Kui testeri väärtus on juba vale, ei ole leht esimene viga. Kui testeri väärtus on õige ja rakendus vale, on viga fookuses, valideerimises või sündmuste käsitlemises. Vöötkoodiskanner ei tööta on laiem seadme kontrollnimekiri. Kuidas testida vöötkoodiskanneri sisendit käsitleb fookust, paigutust ja POS-i töövooge väljaspool seda vormi.

Skanner piiksub, kuid sisendit ei ilmu

Piiks tähendab tavaliselt, et skanner dekodeeris sümboli. See ei tähenda, et leht teksti sai. Kinnitage klaviatuurikiilu režiim. Jada- ja kaamerarežiim välja ei trüki. Klõpsake välja, nii et document.activeElement on see sisend, ja skannige uuesti. Keelatud, kirjutuskaitstud või peidetud väli võib klahve eirata.

QR-skanner töötab Notepadis, kuid mitte brauseris

Seade trükib. Leht neid klahve vastu ei võta. Kontrollige fookust, keydown-kuulajat, mis kutsub trükitavatel klahvidel preventDefault(), ja kuulajat, mis käsitleb ainult paste. Kiilu sisend ei käivita paste-sündmust. Võrrelge testeri tulemust rakenduse väljaga.

Skanner loeb vöötkoode, kuid mitte QR-koode

Seade võib olla ainult 1D või QR-sümboloogia võib olla keelatud. Leht seda parandada ei saa. Kinnitage 2D-tugi ja lubage QR Code seadme juhendi järgi, kasutades kontrolle juhendis QR-koodi testimine: kuidas testida QR-koodi skannereid. Edukas Code 128 skann tõestab ainult klaviatuuriteed.

Valed märgid

Skannige esmalt QR-INPUT-TEST-12345. Kui see kattub, aga URL või JSON-andmesisu mitte, muudab paigutus kirjavahemärke, näiteks :, /, { või ". Võrrelge klaviatuurisündmuste testeris event.key väärtust event.code väärtusega ja vaadake Vöötkoodiskanneri vale klaviatuuripaigutus. Viige skanneri klaviatuuripaigutus vastavusse operatsioonisüsteemiga.

ENTER saadab vormi kaks korda

Brauser saadab vormi ja keydown-kuulaja käsitleb samuti Enterit. Hoidke üks lõpetamistee ja kutsuge seal preventDefault(). Teine füüsiline skann on teine viga. Näite olekutekst ütleb, et andmesisu oli juba vastu võetud. Kui juba esimene skann loob kaks kirjet, otsige kahte kuulajat, enne kui skannerit muudate.

QR-sisend on kärbitud

Võrrelge märkide arvu sisendi testeris välja väärtusega. Atribuut maxlength, sisendimask või preventDefault() märgiklahvidel võib stringi lõigata. Uus rida QR-andmesisus võib saata üherealise sisendi liiga vara. Mõni skanner piirab ka seda, mitu märki ta trükib. Tõstke seda piiri seadme juhendi järgi, kui lühikest väärtust näitab tester, mitte ainult rakendus. Vöötkoodiskanneril puudub ENTER käsitleb seotud juhtu, kus andmesisu saabub, aga vorm ei kinnitu kunagi.

Skanner ei suuda lugeda ekraanil olevat QR-koodi

Kinnitage, et skanner on 2D-pildiskanner. Tõstke ekraani heledust, suurendage koodi suurust ja hoidke vaiksetsoon tekstist ja äärtest vaba. Peegeldus, hämar telefoniekraan ja kood, mis on töökauguse jaoks liiga tihe, on optilised probleemid. Trükkige sama andmesisu, kui ekraanilt lugemine jääb ebaõnnestuma. Rakenduse test kasutab ikkagi tuntud stringi, kui mis tahes skann teksti tekitab.