Siirry sisältöön

Barcode Scanner Emulator

Miten QR-lukijan syöte testataan verkkosovelluksissa

Monet ulkoiset QR-koodia lukevat lukijat käyttävät näppäimistökiilaa ja kirjoittavat puretun QR-tekstin kohdistettuun kenttään. Testaa tämä polku skannaamalla tunnettu tietosisältö ja vertaamalla sitä arvoon, jonka sivu vastaanotti. Kaikki QR-lukijat eivät kirjoita kuin näppäimistö. Sarjalaitteet ja kamerapurkajat ovat eri integraatioita, eivätkä selaimen näppäintapahtumat tunnista fyysistä lukijaa.

QR-koodi tallentaa dataa. Lukija tai kamerapurkaja muuttaa datan tekstiksi. Verkkosovelluksen on sitten vastaanotettava teksti, päätettävä milloin skannaus on valmis ja validoitava se. Tämä opas on tuo sovellustesti. Etikettien luonti, kontrastin tarkistus ja sen varmistaminen, että laite osaa purkaa QR Code -koodin, käsitellään oppaassa QR-koodin testaus: miten QR-lukijoita testataan. Yleiset viivakoodilomakkeet, mukaan lukien EAN-tarkistusnumerot, käsitellään oppaassa Miten viivakoodinlukijoita testataan verkkosovelluksissa.

Testaa QR-syöte 60 sekunnissa

Käytä itse valitsemaasi tietosisältöä, jotta väärä merkki erottuu. Tämä läpikäynti käyttää arvoa QR-INPUT-TEST-12345.

  1. Avaa QR-koodigeneraattori ja luo QR-koodi arvolle QR-INPUT-TEST-12345. Generaattori toimii selaimessa. Se ei ole yhteydessä lukijaan.
  2. Kytke QR-koodia lukeva lukija, joka on näppäimistökiilatilassa. Vain 1D-koodeja lukeva lukija ei pura tätä symbolia.
  3. Käytä viivakoodisyötteen testaajaa.
  4. Napsauta Aloita testi tai napsauta skannausaluetta, jotta kentällä on kohdistus. Testaaja ei ota kohdistusta itse, eikä se avaa lukijaa.
  5. Skannaa QR-koodi.
  6. Lue kaapattu teksti ja merkkimäärä.
  7. Vertaa tekstiä arvoon QR-INPUT-TEST-12345. Vastaavuus sisältää kirjainkoon, yhdysmerkit ja pituuden.
  8. Lue pääte. Testaaja ilmoittaa ENTER, TAB tai Ei mitään, kun lukija lähettää jonkin näistä näppäimistä.

Testaaja tallentaa näppäimistötapahtumat, jotka selain näkee. Se ei tunnista USB-laitetta, ei lue sarjaporttia eikä pura QR-kuvaa.

QR-lukijan syötetilat

Sama tulostettu QR-koodi voi saapua kolmen eri integraation kautta. Yhden tilan testi ei harjoita muita.

Näppäimistökiilan QR-lukijat

USB HID -näppäimistötilassa tai Bluetooth HID -näppäimistötilassa käyttöjärjestelmä käsittelee lukijaa näppäimistönä. Purun jälkeen lukija kirjoittaa tietosisällön siihen kontrolliin, jolla on kohdistus. Tavallinen <input> tai <textarea> voi vastaanottaa sen. Sivu ei avaa laitetta. Opas HID-näppäimistökiila kuvaa näppäinjärjestyksen, etuliitteet ja päätteet.

Kohdistus ratkaisee kohteen. Jos kohdistettu elementti on asiakirjan body, painike tai toinen kehys, tämän kentän kuuntelijat eivät näe skannausta.

Sarja-QR-lukijat

USB-sarjalukija tai virtuaalisen COM-portin lukija lähettää puretun tekstin tavuina prosessille, joka avasi portin. Kohdistus ei valitse tätä prosessia. Kenttä, joka kuuntelee vain näppäilyjä, pysyy tyhjänä, kun saman portin pääte näyttää tietosisällön.

Chromium-pohjaiset selaimet voivat avata käyttäjän valitseman portin Web Serial API:lla suojatussa kontekstissa käyttäjän eleen jälkeen. Firefox ja Safari eivät tarjoa tätä APIa. Kiilalukija ei näy sarjaporttina. Porttien nimet, baud ja kehys riippuvat laitteesta ja ajurista. USB HID ja sarjaviivakoodinlukijat vertaa näitä kahta liitäntää. Viivakoodisyötteen testaaja ei voi lukea COM-porttia.

Kamerapohjainen QR-skannaus

Kameraintegraatio ottaa kuvan ja purkaa QR-koodin ohjelmistossa. Sivu käyttää kamera-APIa ja purkajaa. Se ei vastaanota keydown-tapahtumia tietosisällölle. Puhelimen kamerasovellukset, sivun kamerapainikkeet ja kenttään kirjoittava laitteistokuvalukija ovat kolme eri tuotetta. Läpäisty kiilatesti ei tarkoita, että kamerapainike toimii, eikä onnistunut kamerapurku tarkoita, että kiilalukija kirjoittaa saman merkkijonon.

Kaappaa QR-lukijan syöte JavaScriptillä

Alla oleva sivu lukee yhden kohdistetun kentän. Enter lähettää lomakkeen, ja Accept-painike käyttää samaa submit-käsittelijää, joten yksi skannaus käsitellään kerran. Ilman ENTER-päätettä teksti jää kenttään, kunnes joku aktivoi Accept-painikkeen. Kaapattu tietosisältö kirjoitetaan textContent-ominaisuudella, joten merkit kuten < näkyvät tekstinä.

Esimerkki hyväksyy kolme sovellusmuotoa: lipputunnuksen kuten QR-INPUT-TEST-12345, http- tai https-URL-osoitteen tai JSON-olion. Se tallentaa skannatun tekstin. Se ei siirry QR-koodissa olevaan URL-osoitteeseen. Lukija, joka ei lähetä Enteriä, toimii silti painikkeen kautta. Tab kulkee tunnisteen, kentän ja painikkeen läpi tavalliseen tapaan, koska komentosarja ei kaappaa sitä.

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

Tallenna tiedosto ja avaa se työpöytäselaimessa. Napsauta kenttää ennen skannausta. autocomplete="off" vähentää riskiä, että tallennettu arvo korvaa skannauksen. Tunniste ja painike jäävät käyttöön, joten henkilö voi kirjoittaa tietosisällön ilman lukijaa.

Käsittele Enter vain lomakkeen submit-tapahtumassa. Toinen Enterin keydown-kuuntelija tallentaa saman skannauksen kahdesti. preventDefault() pitää selaimen tällä sivulla. Tyhjennä kenttä päätöksen jälkeen, jotta seuraava skannaus ei liity edelliseen tekstiin.

QR-tietosisältö voi sisältää rivinvaihdon. Kiilalukija kirjoittaa vaihdon usein Enterinä. Yksirivisessä syötteessä lomake voi lähteä ensimmäisellä rivillä ja pudottaa loput. Käytä textarea-kenttää tai tavut säilyttävää sarjalukijaa, kun sovelluksen on hyväksyttävä monirivinen teksti. Vahvista toiminta QR-koodilla, jonka tietosisällössä on rivinvaihto.

QR-tietosisältöjen käsittely

QR-symboli ei lupaa sovellusmuotoa. Sama symbologia voi sisältää jonkin näistä:

  • Tavallista tekstiä, kuten QR-INPUT-TEST-12345.
  • URL-osoitteen.
  • Sovelluksen valitseman tunnisteen.
  • Jäsennellyn tietosisällön, kuten lippunumeron ja sijaintikoodin.
  • JSON-tekstiä, kun sovellus on määritellyt tämän koodauksen.

Lukija lähettää puretut merkit. Se ei tarkista, että ne vastaavat lippusääntöä, tuoteluetteloa tai JSON-skeemaa. Validoi merkkijono sivulla ja validoi se uudelleen palvelimella. Lähetetty arvo on tavallista käyttäjän syötettä. Selain ei voi todistaa, että lukija tuotti sen.

Validoi QR-syöte

Älä oleta, että QR-tietosisältö on numeerinen. EAN-13-säännöt eivät päde. Käsittele tekstiä epäluotettavana: näytä se tekstinä, äläkä sijoita sitä kohteeseen location, innerHTML tai komentosarjan URL-osoitteeseen.

Tyhjät arvot. Pelkkä Enter tai Accept tyhjässä kentässä ei saa luoda tietuetta. trim() hylkää myös tietosisällön, joka on pelkkiä välilyöntejä.

Odottamattomat merkit. Vertaa vastaanotettua merkkijonoa tunnettuun QR-sisältöön. Näppäimistöasettelun ero muuttaa usein välimerkkejä, vaikka pituus pysyy samana. Hylkää merkit, joita muoto ei salli, ja näytä syy tilatekstissä.

Tietosisällön pituus. Pakota sovelluksesi tallentama enimmäispituus. Syötteen maxlength katkaisee pidemmän skannauksen ilman virhettä. Aseta se vain, kun jokainen hyväksytty tietosisältö mahtuu, ja vertaa testaajan merkkimäärää kenttään, kun arvo näyttää lyhyeltä.

Pakolliset etuliitteet. Etuliitteen tarkistus kuuluu sovellukselle. Tämä lippusääntö hyväksyy QR--alkuiset merkkijonot, joissa on isoja kirjaimia, numeroita ja yhdysmerkkejä:

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

Poista lukijan etuliite vain, kun kyseinen lukija on asetettu lähettämään yksi täsmällinen etuliite eikä sovellus tallenna sitä. AIM-symbologiatunniste on dataa, kunnes päätät toisin.

Sovelluskohtaiset muodot. Pidä sääntö muodon vieressä. Lippulomake, sallittujen URL-osoitteiden lista ja JSON-olio tarvitsevat eri tarkistukset. Yksi numeerinen kuvio hylkää kelvollisen QR-tekstin.

Kaksoisskannaukset. Yksi fyysinen skannaus voi osua kahteen kuuntelijaan. Käytä yhtä valmistumispolkua, kuten esimerkki tekee. Toinen liipaisimen painallus on erillinen tapahtuma. Esimerkki hylkää tietosisällön, jonka se on jo hyväksynyt. Varastolomake voi sen sijaan kasvattaa määrää. Testaa sääntö, jonka sovelluksesi dokumentoi.

Virheellinen JSON. JSON.parse heittää poikkeuksen keskeneräisestä tekstistä. Tarkista muoto onnistuneen jäsennyksen jälkeen. Taulukko tai pelkkä luku voi olla kelvollista JSONia ja silti väärää tyyppiä:

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

Odottamattomat URL-osoitteet. Jäsennä URL nähdäksesi, onko se käyttökelpoinen, ja säilytä skannattu merkkijono, jos testin on vastattava QR-tietosisältöä täsmälleen. URL.href voi lisätä vinoviivan tai muuttaa koodausta. Hyväksy vain ne skeemat, jotka sovellus tarkoittaa. Älä avaa URL-osoitetta skannauksen sivuvaikutuksena:

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

Ohjausmerkit. Hylkää ASCII-ohjausmerkit näppäimistötietosisällössä, jotta piilotettu etuliite pysyy näkyvissä tilatekstissä. CR ja LF ovat ohjausmerkkejä. Kiilalukijassa Enter ja Tab ovat näppäimiä. Ne eivät ole merkkejä tavallisen tekstikentän sisällä. Sarjatietosisältö voi silti sisältää tavut 0x0D tai 0x0A. Poista ne sarjakehyksen rajalla, äläkä poista CR-merkkiä, joka kuuluu monirivisen tietosisällön keskelle.

ENTER- ja TAB-päätteet

Pääte on valinnainen lukijan asetus. Se ei ole osa QR-symbolia. ENTER- ja TAB-päätteet viivakoodinlukijoissa näyttää, miten näppäimet erotetaan. Lue pääte syötetestaajassa ja sovita sivu käyttöön ottamiisi lukijoihin.

ENTER lähettää yksirivisen tekstikentän lomakkeen nykyisissä selaimissa. Käytä sitä, kun yhden skannauksen pitää vahvistaa arvo. Kutsu preventDefault()-metodia tapahtumassa submit, kun sivun pitää pysyä paikallaan.

TAB siirtää kohdistuksen seuraavaan kontrolliin. Lue arvo tapahtumassa keydown, kun kentällä on vielä kohdistus. Jätä oletustoiminto voimaan, kun seuraavan kentän pitää saada kohdistus. Ohita Shift+Tab, jotta näppäimistön käyttäjä voi liikkua taaksepäin.

Ei päätettä jättää tietosisällön kenttään. Esimerkin Accept-painike on valmistumispolku. Toimettomuusaika voi arvata, että tauko tarkoittaa skannauksen loppua. Ajastin on heuristiikka: hidas Bluetooth-purkaus ja nopeasti kirjoittava henkilö voivat molemmat ylittää saman välin. Suosi asetettua päätettä, kun työnkulku tarvitsee selvän lopun.

CR ja LF ovat tavuja. Näppäimistön Enter on event.key === "Enter". Ne eivät ole keskenään vaihdettavissa. Kuuntelija, joka vain poistaa \r-merkin syötteen arvosta, ei näe kiilan Enteriä, koska merkkiä ei koskaan lisätty. Kuuntelija, joka vain seuraa event.key-arvoa, ei jaa sarjapuskuria tavun 0x0D kohdalla. Jotkin laitteet lähettävät NumPad Enterin. event.key on yhä "Enter". Tarkista event.key, älä vain ehtoa event.code === "Enter".

Pääte voi muuttua, kun joku skannaa määrityskoodin laitteen käsikirjasta. Testaa Enter, Tab ja puuttuva pääte uudelleen jokaisen määritysmuutoksen jälkeen. Älä keksi ohjelmointiviivakoodia. Käytä kyseisen mallin käsikirjaa.

Selvitä näppäintapahtumat

Kun tallennettu teksti on väärin, tarkastele tapahtumia tässä järjestyksessä.

keydown. Laukeaa jokaisesta näppäimestä, myös Enteristä ja Tabista, ennen kuin selain lisää merkin tai siirtää kohdistusta. Lue päättäjä täältä.

input. Laukeaa, kun tulostettava merkki muuttaa kenttää. Se ei laukea Enteristä tai Tabista tekstikentässä.

event.key. Merkki tai näppäimen nimi sen jälkeen, kun käyttöjärjestelmä on soveltanut näppäimistöasettelun.

event.code. Fyysinen näppäin, kuten Digit1 tai Numpad1. Se voi pysyä samana, kun väärä asettelu muuttaa event.key-arvoa.

Kohdistus. Kirjaa document.activeElement ennen skannausta. Jos se ei ole QR-kenttä, jäljen loppu kuvaa väärää kontrollia. Iframella on oma kohdistuksensa.

Järjestys. Kiilaskannauksessa tekstikenttään tulostettavia keydown-tapahtumia seuraavat input-päivitykset ja sitten viimeinen keydown Enterille tai Tabille, kun kyseinen pääte on asetettu. change laukeaa, kun kenttä vahvistaa arvon, yleensä blur-tapahtumassa. Skannaus, joka jättää kohdistuksen samaan kenttään, ei tuota change-tapahtumaa lopussa. Älä käytä change-tapahtumaa ainoana valmistumissignaalina.

Ajoitus. Lukijat päättävät lyhyen tietosisällön usein reilusti alle sekunnissa. Syötetestaaja vertaa merkkien keskimääräistä väliä 100 ms kynnykseen ja merkitsee tuloksen ajoitukseksi, ei laitetunnistukseksi. Nopeasti kirjoittava henkilö, automaattitäyttö tai emulaattori voi osua kynnyksen lukijapuolelle. Viivästynyt Bluetooth-skannaus voi näyttää kirjoittamiselta. Tarkista tietosisältö ja pääte. Käsittele ajoitusta vihjeenä.

Käytä näppäimistötapahtumien testaajaa, niin näet jokaisen keydown- ja keyup-tapahtuman kenttineen key, code, muuntonäppäimet ja aikaleimat. Loki on selaimen tapahtumia. Se ei ole raakaa USB-liikennettä.

Testaa ilman fyysistä QR-lukijaa

Sovelluslogiikkaa voi testata ennen kuin lukija on pöydällä.

  • Kirjoita QR-INPUT-TEST-12345 kenttään ja aktivoi Accept. Se tarkistaa validoinnin ja näytön. Se ei tarkista purkua eikä päätteitä.
  • Ohjaa samaa kenttää selaimen automaatiotyökalulla, kuten seuraava osio tekee.
  • Käytä sovellusta Barcode Scanner Emulator, kun tarvitset lukijamaista kirjoitusta. Työpöytäsovellus lähettää antamasi arvon kirjoitusviiveellä ja päätteellä ei mitään, ENTER tai TAB kohdistettuun sovellukseen. Se toistaa näppäimistöpolun. Se ei kuvaa QR-kuvaa, pura symbolia eikä luo virtuaalista COM-porttia.

Laitteistoa tarvitaan yhä optiseen toimintaan ja laitteen toimintaan: osaako kyseinen lukija lukea näytetyn tai tulostetun koodin, onko QR-symbologia käytössä, näppäimistöasettelu, pääteasetus sekä sarja- tai valmistajan SDK -tilat. Emulaattori on oikea tarkistus näppäimistöpolulle. Se on väärä tarkistus, jos pitää todistaa, että laite lukee tietyn QR-koodin.

Automatisoi QR-syötteen testit

Seuraavat Playwright-testit ohjaavat esimerkkisivua. Ne kirjoittavat kenttään niin kuin kiilalukija tekisi ja tarkistavat sitten sovelluksen toiminnan. Ne eivät avaa USB-laitteita. @playwright/test on riippuvuus testin ajajalle. Tämä sivusto ei vaadi sitä.

Tallenna HTML-esimerkki nimellä qr-form.html tämän testin viereen.

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 lisää merkkejä kohdistettuun kenttään. Se ei ole USB-gadget. Odottamattomien merkkien testi käyttää fill-metodia, koska tavoite on validointiviesti ja se, ettei sivulle ilmesty lisättyä elementtiä. Laajenna tiedostoa URL-tapauksella ja JSON-tapauksella, kun nämä muodot ovat julkaistavassa koontiversiossa. URL-tarkistuksen pitää verrata kaapattua tekstiä alkuperäiseen QR-merkkijonoon.

QR-lukijan testimatriisi

Aja nämä testattavaa sovellusta vasten. Yllä oleva esimerkkisivu kattaa lipun, URL-osoitteen, JSONin, kaksoiskappaleen, tyhjän arvon ja odottamattomien merkkien rivit. Vain numeroita tai useita rivejä käyttävä sovellus tarvitsee oman odotetun tuloksen.

Skenaario Odotettu tulos
Tavallinen QR-teksti Tarkka arvo vastaanotettu
URL-osoitteen QR Koko URL kaapattu, eikä sivu siirry siihen
Numeerinen QR Numerot säilyvät
Erikoismerkit Oikeat merkit vastaanotettu
JSON-tietosisältö Data kaapattu ja validoitu
ENTER-pääte Käsittely tapahtuu kerran
TAB-pääte Kohdistuksen toiminta käsitelty
Ei päätettä Sovellus käyttää muuta valmistumistapaa
Kaksoisskannaus Sovellus soveltaa kaksoissääntöjään
Virheellinen tietosisältö Validointivirhe näytetään
Puuttuva kohdistus Sovellus käsittelee puuttuvan syötteen turvallisesti
Pitkä tietosisältö Ei tahatonta katkaisua

Skannaa myös tietosisältö, jossa on rivinvaihto, jos tuotteen pitää tallentaa sellainen. Kirjaa, vastaanottiko kenttä jokaisen rivin.

Vianmääritys

Aloita tunnetulla tietosisällöllä syötetestaajassa. Jos testaajan arvo on jo väärin, sivu ei ole ensimmäinen vika. Jos testaajan arvo on oikein ja sovellus on väärin, vika on kohdistuksessa, validoinnissa tai tapahtumien käsittelyssä. Viivakoodinlukija ei toimi on laajempi laitteen tarkistuslista. Miten viivakoodinlukijan syöte testataan kattaa kohdistuksen, asettelun ja POS-työnkulut tämän lomakkeen ulkopuolella.

Lukija piippaa, mutta syötettä ei näy

Piippaus tarkoittaa yleensä, että lukija purki symbolin. Se ei tarkoita, että sivu vastaanotti tekstin. Varmista näppäimistökiila. Sarja- ja kameratilat eivät kirjoita kenttään. Napsauta kenttää, jotta document.activeElement on tuo syöte, ja skannaa uudelleen. Poistettu käytöstä oleva, vain luku -kenttä tai piilotettu kenttä voi ohittaa näppäimet.

QR-lukija toimii Notepadissa mutta ei selaimessa

Laite kirjoittaa. Sivu ei hyväksy näitä näppäimiä. Tarkista kohdistus, keydown-kuuntelija joka kutsuu preventDefault()-metodia tulostettaville näppäimille, ja kuuntelija joka käsittelee vain paste-tapahtumaa. Kiilasyöte ei laukaise paste-tapahtumaa. Vertaa testaajan tulosta sovelluksen kenttään.

Lukija lukee viivakoodeja mutta ei QR-koodeja

Laite voi olla vain 1D, tai QR-symbologia voi olla pois käytöstä. Sivu ei voi korjata sitä. Varmista 2D-tuki ja ota QR Code käyttöön laitteen käsikirjasta oppaan QR-koodin testaus: miten QR-lukijoita testataan tarkistuksilla. Onnistunut Code 128 -skannaus todistaa vain näppäimistöpolun.

Väärät merkit

Skannaa ensin QR-INPUT-TEST-12345. Jos se täsmää eikä URL tai JSON-tietosisältö täsmää, asettelu muuttaa välimerkkejä kuten :, /, { tai ". Vertaa event.key- ja event.code-arvoja näppäimistötapahtumien testaajassa ja katso Viivakoodinlukijan väärä näppäimistöasettelu. Sovita lukijan näppäimistöasettelu käyttöjärjestelmään.

ENTER lähettää lomakkeen kahdesti

Selain lähettää lomakkeen, ja keydown-kuuntelija käsittelee myös Enterin. Pidä yksi valmistumispolku ja kutsu siinä preventDefault()-metodia. Toinen fyysinen skannaus on eri vika. Esimerkin tilateksti kertoo, että tietosisältö oli jo hyväksytty. Jos ensimmäinen skannaus itse luo kaksi tietuetta, etsi kaksi kuuntelijaa ennen lukijan muuttamista.

QR-syöte katkeaa

Vertaa syötetestaajan merkkimäärää kentän arvoon. maxlength-attribuutti, syötemaski tai preventDefault() merkkien näppäimille voi katkaista merkkijonon. Rivinvaihto QR-tietosisällön sisällä voi lähettää yksirivisen syötteen liian aikaisin. Jotkin lukijat rajoittavat myös kirjoittamiensa merkkien määrää. Nosta raja laitteen käsikirjasta, kun testaaja, ei vain sovellus, näyttää lyhyen arvon. Viivakoodinlukijalta puuttuu ENTER käsittelee läheisen tapauksen, jossa tietosisältö saapuu eikä lomake koskaan vahvistu.

Lukija ei lue näytöllä olevaa QR-koodia

Varmista, että lukija on 2D-kuvalukija. Nosta näytön kirkkautta, suurenna koodia ja pidä hiljainen alue vapaana tekstistä ja reunoista. Heijastus, himmeä puhelimen näyttö ja työskentelyetäisyydelle liian tiheä koodi ovat optisia ongelmia. Tulosta sama tietosisältö, jos näytöltä lukeminen epäonnistuu yhä. Sovellustesti käyttää silti tunnettua merkkijonoa, kun jokin skannaus tuottaa tekstiä.