Ugrás a tartalomra

Barcode Scanner Emulator

Hogyan tesztelhető a QR-olvasó bemenete webes alkalmazásokban

Sok külső, QR-képes olvasó billentyűzet-ékelés módban a dekódolt QR-szöveget a fókuszált mezőbe gépel. Ezt az útvonalat ismert hasznos adat beolvasásával tesztelje, és hasonlítsa össze az oldal által kapott értékkel. Nem minden QR-olvasó gépel billentyűzetként. A soros eszközök és a kamerás dekódolók külön integrációk, és a böngésző billentyűzeteseményei nem azonosítják a fizikai olvasót.

A QR-kód adatot tárol. Az olvasó, vagy egy kamerás dekódoló, ezt az adatot szöveggé alakítja. A webes alkalmazásnak ezt a szöveget fogadnia kell, el kell döntenie, mikor ért véget a beolvasás, és ellenőriznie kell. Ez az útmutató ezt az alkalmazástesztet írja le. A címkék létrehozása, a kontraszt ellenőrzése és annak megerősítése, hogy egy eszköz dekódolni tudja a QR Code-ot, a QR-kód tesztelése: a QR-olvasók tesztelése útmutatóban szerepel. Az általános vonalkódűrlapok, beleértve az EAN ellenőrző számjegyeket, a Hogyan tesztelhetők a vonalkódolvasók webes alkalmazásokban útmutatóban szerepelnek.

A QR-olvasó bemenetének tesztelése 60 másodperc alatt

Olyan hasznos adatot használjon, amelyet Ön választott, hogy a hibás karakter nyilvánvaló legyen. Ez a menet a QR-INPUT-TEST-12345 értéket használja.

  1. Nyissa meg a QR-kód generátort, és hozzon létre QR-kódot a QR-INPUT-TEST-12345 értékhez. A generátor a böngészőben fut. Nem lép kapcsolatba az olvasóval.
  2. Csatlakoztasson QR-képes olvasót, amely billentyűzet-ékelés módra van állítva. A csak 1D-s olvasó ezt a szimbólumot nem tudja dekódolni.
  3. Teszteljen a vonalkódbevitel-tesztelővel.
  4. Kattintson a Teszt indítása gombra, vagy kattintson a beolvasási területre, hogy a mező fókuszban legyen. A tesztelő magától nem veszi át a fókuszt, és nem nyitja meg az olvasót.
  5. Olvassa be a QR-kódot.
  6. Olvassa el a rögzített szöveget és a karakterszámot.
  7. Hasonlítsa össze ezt a szöveget a QR-INPUT-TEST-12345 értékkel. Az egyezésbe beletartozik a kis- és nagybetű, a kötőjel és a hossz.
  8. Olvassa le az utótagot. A tesztelő ENTER, TAB vagy Nincs értéket jelez, amikor az olvasó e billentyűk egyikét küldi.

A tesztelő azokat a billentyűzeteseményeket rögzíti, amelyeket a böngésző lát. Nem azonosítja az USB-eszközt, nem olvas soros portot, és nem dekódolja a QR-képet.

A QR-olvasó bemeneti módjai

Ugyanaz a kinyomtatott QR-kód három különböző integráción keresztül érkezhet. Az egyik mód tesztje a többit nem gyakoroltatja.

Billentyűzet-ékeléses QR-olvasók

USB HID billentyűzetmódban, vagy Bluetooth HID billentyűzetmódban az operációs rendszer az olvasót billentyűzetként kezeli. Dekódolás után az olvasó a hasznos adatot abba a vezérlőbe gépel, amelynek fókusza van. Egy közönséges <input> vagy <textarea> fogadhatja. Az oldal nem nyitja meg az eszközt. A HID billentyűzet-ékelés útmutató a billentyűleütés-sorozatot, az előtagokat és az utótagokat írja le.

A fókusz dönti el a célt. Ha a fókuszált elem a dokumentum törzse, egy gomb vagy egy másik keret, ennek a mezőnek a figyelői nem látják a beolvasást.

Soros QR-olvasók

Az USB-soros vagy virtuális COM-portos olvasó a dekódolt szöveget bájtokként küldi annak a folyamatnak, amely megnyitotta a portot. A fókusz nem választja ki ezt a folyamatot. Az a mező, amely csak billentyűleütéseket figyel, üres marad, miközben a porton lévő terminál megjeleníti a hasznos adatot.

A Chromium-alapú böngészők felhasználó által kiválasztott portot nyithatnak a Web Serial API-val, biztonságos környezetben, felhasználói gesztus után. A Firefox és a Safari nem biztosítja ezt az API-t. Az ékeléses olvasó nem jelenik meg soros portként. A portnevek, a baud és a keretezés az eszköztől és az illesztőprogramtól függenek. Az USB HID és soros vonalkódolvasók a két interfészt hasonlítja össze. A vonalkódbevitel-tesztelő nem tud COM-portot olvasni.

Kamerás QR-beolvasás

A kamerás integráció képet rögzít, és a QR-kódot szoftverben dekódolja. Az oldal kamera-API-t és dekódolót használ. A hasznos adathoz nem kap keydown eseményeket. A telefonos kameraalkalmazások, az oldalon belüli kameragombok és a mezőbe gépelő hardveres képalkotó három különböző termék. Az ékelésteszt sikere nem jelenti, hogy a kameragomb működik, és a sikeres kamerás dekódolás nem jelenti, hogy az ékeléses olvasó ugyanazt a karakterláncot fogja begépelni.

A QR-olvasó bemenetének rögzítése JavaScripttel

Az alábbi oldal egy fókuszált mezőt olvas. Az Enter elküldi az űrlapot, és az Accept gomb ugyanazt a submit-kezelőt használja, így egy beolvasás egyszer kerül feldolgozásra. ENTER utótag nélkül a szöveg a mezőben marad, amíg valaki aktiválja az Accept gombot. A rögzített hasznos adat textContent segítségével íródik ki, ezért az olyan karakterek, mint a <, szövegként láthatók maradnak.

A példa három alkalmazásformátumot fogad el: egy jegyazonosítót, például QR-INPUT-TEST-12345, egy http vagy https URL-t, vagy egy JSON-objektumot. Rögzíti a beolvasott szöveget. Nem navigál a QR-kódban talált URL-re. Az Entert nem küldő olvasó a gombon keresztül továbbra is működik. A Tab a szokott módon halad a címkén, a mezőn és a gombon, mert a szkript nem ejti csapdába.

<!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <meta name="viewport" content="width=device-width, initial-scale=1">
  <title>QR input example</title>
</head>
<body>
  <form id="qr-form">
    <label for="qr">QR payload</label>
    <input id="qr" name="qr" type="text" autocomplete="off" spellcheck="false">
    <button type="submit">Accept</button>
  </form>
  <p id="status" role="status"></p>
  <pre id="captured"></pre>
  <script>
    const form = document.querySelector('#qr-form')
    const field = document.querySelector('#qr')
    const status = document.querySelector('#status')
    const captured = document.querySelector('#captured')

    if (
      !(form instanceof HTMLFormElement) ||
      !(field instanceof HTMLInputElement) ||
      !(status instanceof HTMLElement) ||
      !(captured instanceof HTMLElement)
    ) {
      throw new Error('QR form markup is missing.')
    }

    const accepted = new Set()

    function classify(raw) {
      if (/[\u0000-\u001F\u007F]/.test(raw)) {
        return { status: 'invalid', message: 'Control character in the QR payload.' }
      }

      const value = raw.trim()
      if (!value) {
        return { status: 'empty' }
      }
      if (value.length > 2048) {
        return { status: 'invalid', message: 'QR payload is longer than this form accepts.' }
      }
      if (/^QR-[A-Z0-9-]{1,64}$/.test(value)) {
        return { status: 'ok', value }
      }
      if (value.startsWith('{')) {
        try {
          const data = JSON.parse(value)
          if (!data || typeof data !== 'object' || Array.isArray(data)) {
            return { status: 'invalid', message: 'QR JSON must be an object.' }
          }
          return { status: 'ok', value }
        } catch {
          return { status: 'invalid', message: 'QR text is not valid JSON.' }
        }
      }
      if (value.startsWith('http://') || value.startsWith('https://')) {
        try {
          const url = new URL(value)
          if (url.protocol !== 'http:' && url.protocol !== 'https:') {
            return { status: 'invalid', message: 'Only http and https URLs are accepted.' }
          }
          return { status: 'ok', value }
        } catch {
          return { status: 'invalid', message: 'The QR text is not a valid URL.' }
        }
      }
      return { status: 'invalid', message: 'Unexpected QR payload.' }
    }

    form.addEventListener('submit', (event) => {
      event.preventDefault()
      const outcome = classify(field.value)
      if (outcome.status === 'empty') {
        status.textContent = 'No QR payload received.'
        field.focus()
        return
      }
      if (outcome.status === 'invalid') {
        status.textContent = outcome.message
        captured.textContent = ''
        field.focus()
        return
      }
      if (accepted.has(outcome.value)) {
        status.textContent = 'Already accepted ' + outcome.value
        field.value = ''
        field.focus()
        return
      }
      accepted.add(outcome.value)
      captured.textContent = outcome.value
      status.textContent = 'Accepted ' + outcome.value
      field.value = ''
      field.focus()
    })
  </script>
</body>
</html>

Mentse a fájlt, és nyissa meg egy asztali böngészőben. Kattintson a mezőre a beolvasás előtt. Az autocomplete="off" csökkenti annak esélyét, hogy egy mentett érték helyettesítse a beolvasást. A címke és a gomb elérhető marad, ezért egy személy olvasó nélkül is begépelhet egy hasznos adatot.

Az Entert csak az űrlap submit eseményében kezelje. Egy második keydown figyelő az Enterre ugyanazt a beolvasást kétszer rögzíti. A preventDefault() ezen az oldalon tartja a böngészőt. A döntés után törölje a mezőt, hogy a következő beolvasás ne fűződjön az előző szöveghez.

A QR hasznos adat tartalmazhat sortörést. Az ékeléses olvasó ezt a törést gyakran Enterként gépel. Egysoros inputban az űrlap az első sornál elküldheti magát, és a többit eldobhatja. Használjon textarea-t, vagy olyan soros olvasót, amely megőrzi a bájtokat, ha az alkalmazásnak többsoros szöveget kell elfogadnia. Ezt a viselkedést olyan QR-kóddal erősítse meg, amelynek hasznos adata sortörést tartalmaz.

A QR hasznos adatok kezelése

A QR-szimbólum nem ígér alkalmazásformátumot. Ugyanaz a szimbológia ezek bármelyikét hordozhatja:

  • Egyszerű szöveg, például QR-INPUT-TEST-12345.
  • URL.
  • Az alkalmazás által választott azonosító.
  • Strukturált hasznos adat, például jegyszám és helykód.
  • JSON-szöveg, ha az alkalmazás ezt a kódolást határozta meg.

Az olvasó a dekódolt karaktereket továbbítja. Nem ellenőrzi, hogy jegyszabálynak, termékkatalógusnak vagy JSON-sémának megfelelnek-e. Ellenőrizze a karakterláncot az oldalon, majd újra a szerveren. A beküldött érték közönséges felhasználói bemenet. A böngésző nem tudja bizonyítani, hogy olvasó hozta létre.

A QR-bemenet ellenőrzése

Ne feltételezze, hogy a QR hasznos adat numerikus. Az EAN-13 szabályok nem érvényesek. A szöveget megbízhatatlanként kezelje: szövegként jelenítse meg, és ne rendelje a location, az innerHTML vagy egy szkript-URL értékéhez.

Üres értékek. A puszta Enter, vagy az Accept üres mezőn, nem hozhat létre rekordot. A trim() azt a hasznos adatot is elutasítja, amely csak szóközökből áll.

Váratlan karakterek. Hasonlítsa össze a kapott karakterláncot az ismert QR-tartalommal. A billentyűzetkiosztás eltérése gyakran az írásjeleket változtatja meg, miközben a hossz ugyanaz marad. Utasítsa el a formátum által nem engedett karaktereket, és az okot a státuszszövegben mutassa.

A hasznos adat hossza. Kényszerítse ki azt a maximumot, amelyet az alkalmazás tárol. Az input maxlength attribútuma a hosszabb beolvasást hiba nélkül csonkolja. Csak akkor állítsa be, ha minden elfogadott hasznos adat belefér, és hasonlítsa össze a tesztelő karakterszámát a mezővel, ha egy érték rövidnek tűnik.

Kötelező előtagok. Az előtagellenőrzés az alkalmazáshoz tartozik. Ez a jegyszabály a QR- előtagot fogadja el, valamint nagybetűket, számjegyeket és kötőjeleket:

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

Olvasó-előtagot csak akkor vágjon le, ha az olvasó úgy van beállítva, hogy egy pontos előtagot küldjön, és az alkalmazás nem tárolja azt. Az AIM szimbológia-azonosító adat, amíg másként nem dönt.

Alkalmazásspecifikus formátumok. A szabályt a formátum mellett tartsa. A jegyűrlap, az URL-engedélylista és a JSON-objektum különböző ellenőrzéseket igényel. Egy numerikus minta az érvényes QR-szöveget elutasítja.

Ismételt beolvasások. Egy fizikai beolvasás két figyelőt is eltalálhat. Egyetlen lezárási útvonalat használjon, ahogy a példa teszi. A ravasz második meghúzása külön esemény. A példa elutasítja azt a hasznos adatot, amelyet már elfogadott. Egy raktári űrlap inkább mennyiséget növelhet. Azt a szabályt tesztelje, amelyet az alkalmazás dokumentál.

Hibás JSON. A JSON.parse hiányos szövegre kivételt dob. Sikeres elemzés után ellenőrizze az alakot. Egy tömb vagy egy puszta szám lehet érvényes JSON, és mégis rossz típus:

function readJsonObject(value) {
  try {
    const data = JSON.parse(value)
    if (!data || typeof data !== 'object' || Array.isArray(data)) {
      return { ok: false, message: 'QR JSON must be an object.' }
    }
    return { ok: true, data }
  } catch {
    return { ok: false, message: 'QR text is not valid JSON.' }
  }
}

Váratlan URL-ek. Elemezze az URL-t, hogy lássa, használható-e, majd tartsa meg a beolvasott karakterláncot, ha a tesztnek pontosan a QR hasznos adattal kell egyeznie. A URL.href perjelet adhat hozzá, vagy megváltoztathatja a kódolást. Csak azokat a sémákat fogadja el, amelyeket az alkalmazás szándékozik. Ne nyissa meg az URL-t a beolvasás mellékhatásaként:

function readWebUrl(value) {
  let url
  try {
    url = new URL(value)
  } catch {
    return { ok: false, message: 'The QR text is not a valid URL.' }
  }
  if (url.protocol !== 'http:' && url.protocol !== 'https:') {
    return { ok: false, message: 'Only http and https URLs are accepted.' }
  }
  return { ok: true, value }
}

Vezérlőkarakterek. Utasítsa el az ASCII vezérlőkaraktereket a billentyűzetes hasznos adatban, hogy a rejtett előtag a státuszszövegben látható maradjon. A CR és az LF vezérlőkarakterek. Ékeléses olvasón az Enter és a Tab billentyűk. Nem karakterek egy közönséges szöveges inputon belül. A soros hasznos adat továbbra is tartalmazhat 0x0D vagy 0x0A bájtokat. Ezeket a soros keretezés határán vágja le, és ne távolítson el olyan CR-t, amely egy többsoros hasznos adat közepéhez tartozik.

ENTER és TAB utótagok

Az utótag opcionális olvasóbeállítás. Nem része a QR-szimbólumnak. Az ENTER és TAB utótagok a vonalkódolvasókban azt mutatja, hogyan lehet a billentyűket megkülönböztetni. Olvassa le az utótagot a vonalkódbevitel-tesztelőben, majd igazítsa az oldalt a telepített olvasókhoz.

ENTER egysoros szövegmező űrlapját küldi el a jelenlegi böngészőkben. Akkor használja, amikor egy beolvasásnak véglegesítenie kell az értéket. Hívja a preventDefault() függvényt a submit eseményen, ha az oldalnak a helyén kell maradnia.

TAB a fókuszt a következő vezérlőre viszi. Olvassa az értéket keydown közben, amíg a mezőnek még fókusza van. Hagyja meg az alapértelmezett műveletet, ha a következő mezőnek kell megkapnia a fókuszt. Hagyja figyelmen kívül a Shift+Tab kombinációt, hogy a billentyűzetet használó visszafelé is mozoghasson.

Nincs utótag a hasznos adatot a mezőben hagyja. A példa Accept gombja a lezárási útvonal. Egy inaktivitási időzítő találgathatja, hogy a szünet a beolvasás végét jelenti. Ez az időzítő heurisztika: egy lassú Bluetooth-sorozat és egy gyors gépíró ugyanazt a rést átlépheti. Részesítse előnyben a beállított utótagot, ha a munkafolyamatnak határozott végre van szüksége.

CR és LF bájtok. A billentyűzetes Enter az event.key === "Enter". Ezek nem cserélhetők fel. Az a figyelő, amely csak a \r karaktert vágja le egy input értékéből, nem látja az ékeléses Entert, mert a karakter soha nem került beillesztésre. Az a figyelő, amely csak az event.key értékét figyeli, nem választja szét a soros puffert a 0x0D mentén. Egyes eszközök NumPad Entert küldenek. Az event.key továbbra is "Enter". Az event.key értékét ellenőrizze, ne csak az event.code === "Enter" feltételt.

Billentyűzetesemények hibakeresése

Ha a tárolt szöveg hibás, az eseményeket ebben a sorrendben vizsgálja.

keydown. Minden billentyűre lefut, beleértve az Entert és a Tabot, mielőtt a böngésző karaktert szúrna be vagy fókuszt helyezne át. A lezárót itt olvassa.

input. Azután fut le, hogy egy nyomtatható karakter megváltoztatta a mezőt. Szöveges inputon Enterre vagy Tabra nem fut le.

event.key. A karakter vagy a billentyű neve azután, hogy az operációs rendszer alkalmazta a billentyűzetkiosztást.

event.code. A fizikai billentyű, például Digit1 vagy Numpad1. Ugyanaz maradhat, amikor a kiosztáseltérés megváltoztatja az event.key értékét.

Fókusz. Naplózza a document.activeElement értékét a beolvasás előtt. Ha nem a QR-mező, a nyomkövetés többi része a rossz vezérlőt írja le. Az iframe-nek saját fókusza van.

Sorrend. Ékeléses beolvasásnál szövegmezőbe a nyomtatható keydown eseményeket input frissítések követik, majd egy utolsó keydown Enterre vagy Tabra, ha ez az utótag be van állítva. A change akkor fut le, amikor a mező véglegesít, általában blur esetén. Az a beolvasás, amely a fókuszt ugyanabban a mezőben hagyja, a végén nem hoz létre change eseményt. Ne a change legyen az egyetlen lezárási jel.

Időzítés. Az olvasók egy rövid hasznos adatot gyakran jóval egy másodperc alatt befejeznek. A vonalkódbevitel-tesztelő a karakterek közötti átlagos rést egy 100 ms küszöbhöz hasonlítja, és az eredményt időzítésként címkézi, nem hardverazonosításként. Egy gyors gépíró, az automatikus kitöltés vagy az emulátor a küszöb olvasói oldalára kerülhet. A késleltetett Bluetooth-beolvasás gépelésnek tűnhet. A hasznos adatot és az utótagot ellenőrizze. Az időzítést nyomnak tekintse.

A billentyűzetesemény-tesztelőt minden keydown és keyup felsorolására használja, a key, a code, a módosítók és az időbélyegek mellett. A napló böngészőesemény. Nem nyers USB-forgalom.

Tesztelés fizikai QR-olvasó nélkül

Az alkalmazáslogika tesztelhető, mielőtt olvasó kerülne az asztalra.

  • Gépelje a QR-INPUT-TEST-12345 értéket a mezőbe, és aktiválja az Accept gombot. Ez az ellenőrzést és a megjelenítést vizsgálja. A dekódolást vagy az utótagokat nem.
  • Ugyanazt a mezőt böngészőautomatizálási eszközzel vezérelje, ahogy a következő szakasz teszi.
  • Használja a Barcode Scanner Emulator alkalmazást, amikor olvasószerű gépelésre van szükség. Az asztali alkalmazás az Ön által megadott értéket küldi, gépelési késleltetéssel és nincs, ENTER vagy TAB utótaggal, a fókuszált alkalmazásba. A billentyűzetes útvonalat adja vissza. Nem fényképez QR-képet, nem dekódol szimbólumot, és nem hoz létre virtuális COM-portot.

A hardver továbbra is szükséges az optikai és az eszközviselkedéshez: hogy az olvasó el tudja-e olvasni a megjelenített vagy nyomtatott kódot, hogy a QR szimbológia engedélyezve van-e, a billentyűzetkiosztáshoz, az utótagbeállításhoz, valamint a soros vagy gyártói SDK módokhoz. Az emulátor a billentyűzetes útvonal megfelelő vizsgálata. Nem alkalmas annak bizonyítására, hogy egy eszköz egy adott QR-kódot olvas.

A QR-bemenet tesztjeinek automatizálása

Az alábbi Playwright-tesztek a példoldalt vezérlik. Úgy gépelnek a mezőbe, ahogy az ékeléses olvasó tenné, majd az alkalmazás viselkedését ellenőrzik. Nem nyitnak USB-eszközöket. Az @playwright/test annak a függősége, aki a példát futtatja. Ez a webhely nem igényli.

Mentse a HTML-példát qr-form.html néven e teszt mellé.

import { readFileSync } from 'node:fs'
import { expect, test } from '@playwright/test'

const html = readFileSync(new URL('./qr-form.html', import.meta.url), 'utf8')

async function openForm(page) {
  await page.setContent(html)
}

test('accepts a known QR payload once', async ({ page }) => {
  await openForm(page)
  const field = page.getByLabel('QR payload')
  await field.pressSequentially('QR-INPUT-TEST-12345')
  await field.press('Enter')
  await expect(page.getByRole('status')).toHaveText('Accepted QR-INPUT-TEST-12345')
  await expect(page.locator('#captured')).toHaveText('QR-INPUT-TEST-12345')
})

test('rejects an unexpected payload', async ({ page }) => {
  await openForm(page)
  const field = page.getByLabel('QR payload')
  await field.pressSequentially('not-a-ticket')
  await field.press('Enter')
  await expect(page.getByRole('status')).toHaveText('Unexpected QR payload.')
  await expect(page.locator('#captured')).toBeEmpty()
})

test('commits on ENTER and rejects a duplicate scan', async ({ page }) => {
  await openForm(page)
  const field = page.getByLabel('QR payload')
  await field.pressSequentially('QR-INPUT-TEST-12345')
  await field.press('Enter')
  await field.pressSequentially('QR-INPUT-TEST-12345')
  await field.press('Enter')
  await expect(page.getByRole('status')).toHaveText('Already accepted QR-INPUT-TEST-12345')
  await expect(page.locator('#captured')).toHaveText('QR-INPUT-TEST-12345')
})

test('does not capture keys while the field is unfocused', async ({ page }) => {
  await openForm(page)
  await page.getByRole('button', { name: 'Accept' }).focus()
  await page.keyboard.type('QR-INPUT-TEST-12345')
  await expect(page.getByLabel('QR payload')).toHaveValue('')
  await expect(page.locator('#captured')).toBeEmpty()
  await expect(page.getByRole('status')).toHaveText('')
})

test('shows unexpected characters as text', async ({ page }) => {
  await openForm(page)
  const payload = '<img src=x onerror=alert(1)>'
  const field = page.getByLabel('QR payload')
  await field.fill(payload)
  await page.getByRole('button', { name: 'Accept' }).click()
  await expect(page.getByRole('status')).toHaveText('Unexpected QR payload.')
  await expect(page.locator('#captured img')).toHaveCount(0)
  await expect(page.locator('img')).toHaveCount(0)
})

A pressSequentially karaktereket szúr a fókuszált mezőbe. Nem USB-eszköz. A váratlan karakter tesztje a fill metódust használja, mert a cél az ellenőrző üzenet és a beinjektált elem hiánya. Egészítse ki a fájlt egy URL-esettel és egy JSON-esettel, ha ezek a formátumok a szállított változatban szerepelnek. Az URL-ellenőrzésnek a rögzített szöveget az eredeti QR-karakterlánccal kell összehasonlítania.

A QR-olvasó tesztmátrixa

Ezeket a tesztelt alkalmazáson futtassa. A fenti mintaoldal a jegy, az URL, a JSON, az ismétlés, az üres és a váratlan karakter sorait lefedi. A csak numerikus vagy többsoros alkalmazásnak saját várt eredményre van szüksége.

Forgatókönyv Várt eredmény
Sima szöveges QR Pontos érték érkezett
URL-es QR A teljes URL rögzítve, és az oldal nem navigál rá
Numerikus QR A számjegyek megmaradnak
Speciális karakterek A helyes karakterek érkeztek
JSON hasznos adat Az adat rögzítve és ellenőrizve
ENTER utótag A feldolgozás egyszer történik
TAB utótag A fókusz viselkedése kezelve
Nincs utótag Az alkalmazás alternatív lezárási módot használ
Ismételt beolvasás Az alkalmazás az ismétléskezelési szabályokat alkalmazza
Érvénytelen hasznos adat Ellenőrzési hiba jelenik meg
Hiányzó fókusz Az alkalmazás a hiányzó bemenetet biztonságosan kezeli
Hosszú hasznos adat Nincs nem szándékolt csonkolás

Akkor is olvasson be olyan hasznos adatot, amely sortörést tartalmaz, ha a terméknek egyet tárolnia kell. Jegyezze fel, hogy a mező minden sort megkapott-e.

Hibaelhárítás

Ismert hasznos adattal kezdjen a vonalkódbevitel-tesztelőben. Ha a tesztelő értéke már hibás, az oldal nem az első hiba. Ha a tesztelő értéke helyes, és az alkalmazás hibás, a hiba a fókusz, az ellenőrzés vagy az eseménykezelés. A vonalkódolvasó nem működik a tágabb eszköz-ellenőrzőlista. A vonalkódolvasó bemenetének tesztelése a fókuszt, a kiosztást és a POS-munkafolyamatokat fedi le ezen az űrlapon túl.

Az olvasó sípol, de nem jelenik meg bemenet

A sípolás általában azt jelenti, hogy az olvasó dekódolt egy szimbólumot. Nem jelenti azt, hogy az oldal megkapta a szöveget. Erősítse meg a billentyűzet-ékelés módot. A soros és a kamerás mód nem gépel a mezőbe. Kattintson a mezőre, hogy a document.activeElement az az input legyen, majd olvasson be újra. A letiltott, csak olvasható vagy rejtett mező figyelmen kívül hagyhatja a billentyűket.

A QR-olvasó Notepadben működik, a böngészőben nem

Az eszköz gépel. Az oldal nem fogadja ezeket a billentyűket. Ellenőrizze a fókuszt, azt a keydown figyelőt, amely nyomtatható billentyűkön preventDefault()-ot hív, és azt a figyelőt, amely csak a paste eseményt kezeli. Az ékeléses bemenet nem vált ki paste eseményt. Hasonlítsa össze a tesztelő eredményét az alkalmazás mezőjével.

Az olvasó vonalkódot olvas, QR-kódot nem

Az eszköz lehet csak 1D-s, vagy a QR szimbológia le lehet tiltva. Az oldal ezt nem tudja javítani. Erősítse meg a 2D támogatást, és engedélyezze a QR Code-ot az eszköz kézikönyvéből, a QR-kód tesztelése: a QR-olvasók tesztelése ellenőrzéseivel. A sikeres Code 128 beolvasás csak a billentyűzetes útvonalat bizonyítja.

Hibás karakterek

Először a QR-INPUT-TEST-12345 értéket olvassa be. Ha az egyezik, egy URL vagy JSON hasznos adat pedig nem, a kiosztás az írásjeleket változtatja, például a :, /, { vagy " jeleket. Hasonlítsa össze az event.key és az event.code értékét a billentyűzetesemény-tesztelőben, és lásd a A vonalkódolvasó billentyűzetkiosztása hibás oldalt. Igazítsa az olvasó billentyűzetkiosztását az operációs rendszeréhez.

Az ENTER kétszer küldi el az űrlapot

A böngésző elküldi az űrlapot, és egy keydown figyelő is kezeli az Entert. Egy lezárási útvonalat tartson meg, és ott hívja a preventDefault() függvényt. A második fizikai beolvasás más hiba. A példa státuszszövege azt mondja, hogy a hasznos adatot már elfogadták. Ha maga az első beolvasás két rekordot hoz létre, két figyelőt keressen, mielőtt az olvasón változtatna.

A QR-bemenet csonkolva van

Hasonlítsa össze a vonalkódbevitel-tesztelő karakterszámát a mezőben lévő értékkel. A maxlength attribútum, egy inputmaszk vagy a preventDefault() a karakterbillentyűkön elvághatja a karakterláncot. A QR hasznos adatban lévő sortörés az egysoros inputot korán elküldheti. Egyes olvasók azt is korlátozzák, hány karaktert gépelnek. Emelje meg ezt a korlátot az eszköz kézikönyvéből, ha a tesztelő, nemcsak az alkalmazás, rövid értéket mutat. A vonalkódolvasóról hiányzik az ENTER azt a kapcsolódó esetet fedi le, amikor a hasznos adat megérkezik, és az űrlap soha nem véglegesít.

Az olvasó nem tudja elolvasni a képernyőn lévő QR-kódot

Erősítse meg, hogy az olvasó 2D képalkotó. Növelje a kijelző fényerejét, növelje a kód méretét, és tartsa a csendes zónát szövegtől és szegélyektől tisztán. A tükröződés, a halvány telefonképernyő és a munkatávolsághoz képest túl sűrű kód optikai problémák. Nyomtassa ki ugyanazt a hasznos adatot, ha a képernyőről olvasás továbbra is sikertelen. Az alkalmazásteszt továbbra is az ismert karakterláncot használja, amint bármely beolvasás szöveget ad.