Ugrás a tartalomra

Barcode Scanner Emulator

Hogyan tesztelhetők a vonalkódolvasók webes alkalmazásokban

Sok USB- és Bluetooth-vonalkódolvasó a dekódolt adatot billentyűzetbemenetként küldi, ezért egy fókuszált mező a webes alkalmazásban fogadhatja a beolvasást olvasóspecifikus böngésző-API nélkül. A soros portok és a gyártói SDK-k külön integrációk. A billentyűzetes útvonalat fizikai olvasóval vagy szimulált billentyűleütésekkel lehet tesztelni.

A webes alkalmazás a vonalkódolvasót általában billentyűzetként látja. A teszt azt vizsgálja, hogy a fókuszált vezérlő megkapja-e a hasznos adatot, amelyet az alkalmazás vár, és hogy az oldal kezeli-e a lezárót, amelynek küldésére az olvasó be van állítva. A lezáró lehet Enter, Tab, vagy hiányozhat.

Használjon munkamenetet a vonalkódbevitel-tesztelővel, amikor fizikai olvasó van csatlakoztatva. Használja a Barcode Scanner Emulator alkalmazást, amikor fejlesztés közben ugyanerre a billentyűzetes útvonalra van szükség, és a hardver nincs az asztalon. A fókusz, az elrendezés és a POS-munkafolyamatok szélesebb áttekintése a A vonalkódolvasó bemenetének tesztelése útmutatóban található. Ez az útmutató a böngészős alkalmazásnál marad: rögzítés, utótagok, ellenőrzés és a ténylegesen megfigyelhető események.

Hogyan kommunikálnak a vonalkódolvasók a webes alkalmazásokkal

Az interfészmód dönti el, mit kaphat meg az oldal. Erősítse meg, mielőtt az űrlapkódon változtat. Az olvasó gyakran üzemmódot válthat, ha a gyártó kézikönyvéből beolvas egy beállító vonalkódot.

USB HID billentyűzet-ékelés

USB HID billentyűzetmódban az olvasó billentyűzetként jelenik meg. Az operációs rendszer a szokásos billentyűzet-illesztőprogramot tölti be. Miután az olvasó dekódolta a szimbólumot, a karaktereket billentyűleütésként küldi annak a vezérlőnek, amelynek billentyűzetfókusza van. Az oldal ezekre a leütésekre figyel, vagy a beszúrt szöveget olvassa. Nem nyit kapcsolatot az eszközzel.

Ez az útvonal az oka annak, hogy a pénztári mező, a keresőmező vagy bármely más szövegbevitel közönséges HTML-lel fogadhat beolvasást. A HID billentyűzet-ékelés útmutató részletesebben tárgyalja a leütéssorozatot, az előtagokat és az utótagokat.

Bluetooth HID

A billentyűzetként párosított Bluetooth-olvasó ugyanazt az alkalmazásútvonalat használja. A gazdagép HID-billentyűzetként kezeli, és a fókuszált mező billentyűleütéseket kap. A párosítás, az akkumulátor és a rádió az eszköz ügye. Amint a karakterek elérik a böngészőt, az oldal ugyanúgy kezeli őket, mint az USB-ékelés bemenetét.

Soros port és virtuális COM-port

A soros olvasó, beleértve az USB sok virtuális COM-port módját, a dekódolt szöveget bájtokként küldi egy porton. A fókusz nem választ célt. Az a folyamat választ, amely megnyitja a portot. Az a szövegmező, amely csak billentyűleütésekre figyel, nem látja ezt az adatfolyamot.

A Chromium-alapú böngészők a Web Serial API-n keresztül nyithatnak soros portot, miután a felhasználó kiválasztotta a portot és engedélyt adott. A Firefox és a Safari nem biztosítja ezt az API-t. Az ékelésteszt nem gyakoroltat soros integrációt, a soros teszt pedig nem árulja el, mit fog begépelni egy ékeléses olvasó.

Gyártóspecifikus interfészek

Egyes eszközök gyártói SDK-t, OPOS-t, JPOS-t vagy nem billentyűzetes HID-interfészt használnak, például USB HID POS-t. Ezek az interfészek nem gépelnek a fókuszált mezőbe. Egy közönséges weblap nem tölthet be natív SDK-t. A Chromium felhasználói gesztus után a WebHID-en keresztül kérhet egyes nem billentyűzetes HID-eszközöket. A billentyűzetosztályú HID-eszközök tiltva maradnak, ezért az ékeléses olvasó nem különböztethető meg a billentyűzettől. A gyártói interfészt külön integrációként kezelje, és azzal a szoftverrel tesztelje, amely ténylegesen megnyitja az interfészt.

Amit a böngésző lát

Az ékeléses beolvasás keydown és keyup eseményként érkezik, a nyomtatható karakterek pedig frissítik a fókuszált mezőt. A böngésző nem kap eszköznevet, USB-sorozatszámot, sem olyan jelzőt, amely szerint a forrás olvasó. A WebHID-et megvalósító böngészők a billentyűzetinterfészeket továbbra is elutasítják, ezért az oldalszkript az ékeléses olvasó nyers HID-jelentéseit sem olvashatja.

Az event.key a karakter vagy a billentyű neve azután, hogy az operációs rendszer alkalmazta az aktív billentyűzetkiosztást. Az event.code a fizikai billentyűt nevezi meg, például Digit1 vagy Numpad1, és változatlan maradhat, amikor a kiosztáseltérés megváltoztatja az event.key értékét. Egyik tulajdonság sem azonosítja a hardvert.

Fizikai vonalkódolvasó tesztelése böngészőben

Futtassa ezt az alkalmazáskód hibakeresése előtt. A pontos karakterláncot és lezárót mutatja, amelyet a böngésző megkapott.

  1. Csatlakoztassa az olvasót, és várjon, amíg jelzi, hogy van tápellátása. Bluetoothnál fejezze be a párosítást, és erősítse meg, hogy a gazdagép billentyűzetprofilt használ.
  2. Erősítse meg a bemeneti módot. A billentyűzet-ékelés, az USB HID billentyűzet vagy a Bluetooth HID billentyűzet tud mezőbe gépelni. A soros mód, az SPP és a gyártói SDK nem.
  3. Teszteljen a vonalkódbevitel-tesztelővel.
  4. Kattintson a Teszt indítása gombra, vagy kattintson a beolvasási területre. Kékre vált, amikor kész. Az oldal magától nem veszi át a fókuszt.
  5. Olvasson be egy vonalkódot, amelynek hasznos adatát már ismeri. Kezdje rövid számértékkel, majd olvasson be olyan értéket, amely tartalmazza az alkalmazás által tárolt írásjeleket.
  6. Olvassa el a rögzített értéket és a karakterszámot. Hasonlítsa össze mindkettőt a várt hasznos adattal, beleértve az előtagot, amelyet az olvasó az adat elé illeszt.
  7. Ellenőrizze az utótagot. A tesztelő ENTER, TAB vagy Nincs értéket jelez. Bekapcsolt Automatikus rögzítés mellett az eredmény Enter, Tab vagy egy rövid szünet után jelenik meg, amint a billentyűk megállnak. Kapcsolja ki az Automatikus rögzítést, ha a rögzítést addig szeretné tartani, amíg a Leállítás gombra nem nyom.
  8. Hasonlítsa össze az eredményt azzal a karakterlánccal, amelyet az alkalmazásnak tárolnia kell. Az előtagot, a kicserélt karaktert vagy a hiányzó lezárót az olvasó beállításában kell javítani, vagy szándékosan az oldalon kell kezelni. Ne tekintse dekódolási hibának, amíg ez az összehasonlítás meg nem történt.

A tesztelő azokat a billentyűzeteseményeket rögzíti, amelyeket a böngésző lát. Nem tudja azonosítani az USB-eszközt, és nem olvas soros portot. Ha a szövegszerkesztő megkapja a beolvasást, a böngésző viszont nem, folytassa az Az olvasó Notepadben működik, POS-ban nem oldallal.

Vonalkódolvasó bemenetének rögzítése JavaScripttel

Az olvasó abba az elembe gépel, amelynek fókusza van. Adjon a mezőnek látható címkét, hagyja közönséges szövegbevitelnek, hogy a billentyűzetet használók begépelhessenek egy kódot, és olvassa az értéket, amikor a munkafolyamat szerint a bejegyzés kész. Az alábbi oldal ezt teszi. Az Enter egyszer elküldi az űrlapot. A Tab egy nem üres értéket lezár, majd engedi, hogy a böngésző áthelyezze a fókuszt. A lezáró nélküli beolvasás a mezőben marad, amíg valaki aktiválja a Look up gombot.

<!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <meta name="viewport" content="width=device-width, initial-scale=1">
  <title>Barcode input example</title>
</head>
<body>
  <form id="barcode-form">
    <label for="barcode">Barcode</label>
    <input id="barcode" name="barcode" type="text" autocomplete="off" spellcheck="false">
    <button type="submit">Look up</button>
  </form>
  <p id="message" role="status"></p>
  <ul id="accepted"></ul>
  <script>
    const form = document.querySelector('#barcode-form')
    const field = document.querySelector('#barcode')
    const message = document.querySelector('#message')
    const list = document.querySelector('#accepted')

    if (
      !(form instanceof HTMLFormElement) ||
      !(field instanceof HTMLInputElement) ||
      !(message instanceof HTMLElement) ||
      !(list instanceof HTMLUListElement)
    ) {
      throw new Error('Barcode form markup is missing.')
    }

    function payload(raw) {
      return raw.replace(/[\r\n]/g, '').trim()
    }

    function classify(raw) {
      const value = payload(raw)
      if (!value) {
        return { status: 'empty' }
      }
      if (/[\u0000-\u001F\u007F]/.test(value)) {
        return {
          status: 'invalid',
          message: 'Control character in the barcode. Check the prefix, suffix, and symbology identifier.',
        }
      }
      return { status: 'ok', value }
    }

    function accept(value) {
      const item = document.createElement('li')
      item.textContent = value
      list.append(item)
      message.textContent = 'Accepted ' + value
      field.value = ''
    }

    function reject(text) {
      message.textContent = text
    }

    form.addEventListener('submit', (event) => {
      event.preventDefault()
      const outcome = classify(field.value)
      if (outcome.status === 'empty') {
        reject('No barcode received.')
        field.focus()
        return
      }
      if (outcome.status === 'invalid') {
        reject(outcome.message)
        field.focus()
        return
      }
      accept(outcome.value)
      field.focus()
    })

    field.addEventListener('keydown', (event) => {
      if (event.key !== 'Tab' || event.shiftKey) {
        return
      }
      const outcome = classify(field.value)
      if (outcome.status === 'empty') {
        return
      }
      if (outcome.status === 'invalid') {
        event.preventDefault()
        reject(outcome.message)
        return
      }
      accept(outcome.value)
    })

    field.focus()
  </script>
</body>
</html>

Mentse a fájlt, és nyissa meg asztali böngészőben. Kattintson a mezőre, ha a fókusz elmozdult. Az ékeléses olvasó, vagy a következő szakasz emulátora ezután a #barcode mezőbe gépel.

A fókusz szükséges. Ha a document.activeElement a dokumentum törzse, egy gomb vagy egy másik bevitel, ennek a mezőnek a figyelői nem látják a beolvasást. A karakterek a fókuszált vezérlőbe kerülnek, vagy elvesznek. Hívja a field.focus() függvényt, amikor a munkafolyamat készen áll a beolvasásra, akkor is, ha egy párbeszédablak bezárult.

Az üres bemenetet figyelmen kívül hagyja. Az űrlap a helyén marad, az állapot szövege pedig azt mondja, hogy semmi sem érkezett. A csupa szóköz a trim() után üres.

A példa nem ad hozzá Entert vagy Tabot. Ha az olvasó nincs beállítva a küldésükre, az érték a mezőben marad, és a Look up a befejezés útja. Az autocomplete="off" csökkenti annak esélyét, hogy egy mentett érték felülírja a beolvasást. A címke, a gomb és a Shift+Tab elérhető marad, így egy személy olvasó nélkül is megadhat kódot.

Az Entert egy helyen kezelje. A példa az űrlap submit eseményét használja, amely a Look up gombot és a billentyűzet Enterjét is lefedi. Egy második keydown figyelő az Enterre ugyanazt a beolvasást kétszer jegyezné fel. Ha a bevitel nincs űrlapon belül, figyeljen az Enterre a keydown eseményen, és hívja a preventDefault() függvényt, hogy egy szülő űrlap se küldődjön el:

field.addEventListener('keydown', (event) => {
  if (event.key !== 'Enter') {
    return
  }

  event.preventDefault()
  const value = field.value.trim()
  if (!value) {
    return
  }

  console.log(value)
  field.value = ''
})

Sikeres elfogadás után ürítse a mezőt, hogy a következő beolvasás ne tapadjon az előző hasznos adathoz. Enter után a példa újra ugyanarra a mezőre teszi a fókuszt, mert ez a munkafolyamat újabb beolvasást vár ugyanabban a dobozban. Tab után békén hagyja a fókuszt, hogy a böngésző a következő vezérlőre léphessen.

Az ENTER és TAB utótagok kezelése

Az utótag olyan billentyű, amelyet az olvasó a hasznos adat után küldhet. Eszközbeállítás. Az Enter gyakori, és nem kötelező. Az ENTER és TAB utótagok a vonalkódolvasókban útmutató leírja, hogyan különböztethetők meg a lezárók. Erősítse meg a beállítást a tesztelt olvasón, majd igazítsa az oldalt ehhez a munkafolyamathoz.

ENTER

Az Enter egy egysoros szövegmezőben az aktuális böngészőkben elküldi a befoglaló űrlapot. Akkor használja, amikor egy beolvasásnak rögzítenie kell az értéket, például egy keresőmezőben. A preventDefault() a submit eseményen megakadályozza, hogy a böngésző elnavigáljon. Hagyja el, ha a teljes oldalnavigáció a kívánt viselkedés.

Ha a vonalkód megjelenik, és az űrlap nem tesz semmit, az olvasó talán nem küld utótagot. A A vonalkódolvasóról hiányzik az ENTER végigveszi ezt a beállítást. 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, különben az olvasó hibásnak tűnik.

TAB

A Tab a fókuszt a következő fókuszálható vezérlőre viszi. Ez olyan sorrendhez illik, mint a termékkód, majd a mennyiség. Meglepi azt az űrlapot, amely azt várta, hogy az Enter küldi el.

Olvassa az értéket a keydown eseményben, amíg a mezőnek még van fókusza. A böngésző az esemény után helyezi át a fókuszt. Hagyja meg az alapértelmezett műveletet, amikor a következő vezérlőnek kell megkapnia a fókuszt. A preventDefault() helyben tartja a fókuszt, ami akkor hasznos, ha az érték érvénytelen, és a kezelőnek látnia kell. Hagyja figyelmen kívül a Shift+Tab kombinációt, hogy a billentyűzetet használó visszafelé haladhasson az űrlapon. Az olvasó Tab utótagja Shift nélküli Tab.

A Tab utótag a fókuszt azelőtt is áthelyezheti, hogy a kód beolvasná a mezőt, ha a figyelő a blur vagy a change eseményen van, és valami más törli a vezérlőt. Az értéket a keydown esemény céljából olvassa.

Nincs utótag

Utótag nélkül a hasznos adat a mezőben marad. Az alkalmazásnak el kell döntenie, mikor ért véget a beolvasás. Egy egyértelmű gomb, a kezelő későbbi Enterje vagy egy másik lépésre lépés megbízható befejezési pont. Egy tétlenségi időzítő a gépelés szünetét a beolvasás végének veheti. Az időzítő heurisztika. A lassú olvasó, a Bluetooth-késleltetés vagy a gyorsan gépelő személy a küszöb rossz oldalára eshet. Részesítse előnyben a beállított utótagot, ha a munkafolyamatnak határozott beolvasásvégi jelre van szüksége.

Beállítási különbségek

Ugyanazon márka olvasói eltérő utótaggal érkezhetnek, és egy beállító vonalkód a JavaScript módosítása nélkül megváltoztathatja az utótagot. Egyes eszközök előtagot, szimbólumazonosítót, például ]C1 értéket, vagy CR és LF karaktert küldenek. Tesztelje azt a három lezáróbeállítást, amelyet a felhasználók ténylegesen választhatnak: Enter, Tab és nincs. Jegyezze fel, melyiket használják a telepített olvasók, és az oldalt ezzel a beállítással tesztelje.

A vonalkódolvasó bemenetének ellenőrzése

Ellenőrizze a mező által kapott karakterláncot. Ne feltételezze, hogy minden vonalkód azonos hosszúságú, karakterkészletű vagy ellenőrző számjegyű. A Code 128 és a QR hasznos adatai változnak. Az EAN-13 13 számjegy. Az alkalmazásnak, amely mindkettőt tárolja, mindkettőhöz szabály kell.

Üres bemenet. Utasítsa el vagy hagyja figyelmen kívül. Hasznos adat nélküli utótag, vagy Look up kattintás üres mezőn, nem hozhat létre rekordot.

Váratlan karakterek. Hasonlítsa össze a kapott karakterláncot egy ismert címkével. A kiosztáseltérés gyakran megváltozott szimbólumként jelenik meg, például eltolt számjegyként vagy írásjelként, miközben a hossz ugyanaz marad. A vezérlőkarakterek előtagból vagy GS1 csoportelválasztóból származhatnak. Engedje azokat a karaktereket, amelyeket a formátuma meghatároz. A fenti példa elutasítja az ASCII vezérlőkaraktereket, hogy az állapotszövegben láthatók maradjanak. Az a GS1-elemző, amely csoportelválasztót vár, engedje ezt a karaktert, és utasítsa el a többit.

Hossz. Érvényesítse azokat a hosszakat, amelyeket az alkalmazás elfogad. Egy globális minimum és maximum biztonságosabb, mint egyetlen kötelező hossz, ha az űrlap egynél több szimbólumrendszert kap. A bevitel maxlength attribútuma csendben levágja a hosszabb hasznos adatot, ezért csak akkor állítsa be, ha minden elfogadott kód belefér.

Előtag. Csak akkor vegye le az előtagot, ha az olvasót pontosan ennek az előtagnak a küldésére állította be, és az alkalmazás nem tárolja.

function withoutConfiguredPrefix(value, prefix) {
  if (prefix && value.startsWith(prefix)) {
    return value.slice(prefix.length)
  }
  return value
}

Az AIM szimbólumazonosító adat, ha az olvasó a küldésére van állítva. Hagyja a helyén, amíg el nem dönti, hogy az alkalmazás tárolja-e.

Utótag. A lezárót tartsa a tárolt értéken kívül. Az Enter és a Tab billentyűk. Közönséges szövegbevitelbe nem kerülnek be. A soros hasznos adat még tartalmazhat CR vagy LF bájtot. Ezeket azon a határon vegye le, ahol a soros adatfolyamot elemzi, és tesztelje, hogy nem veszi le őket egy olyan hasznos adat közepéről, amely jogszerűen tartalmazza őket.

Kettős beküldés. Egy beolvasás kétszer is kezelhető, ha a keydown és a submit is lefut ugyanarra az Enterre. Egyetlen befejezési utat használjon. Ugyanannak a kódnak a második beolvasása más kérdés. A raktári űrlap növelheti a mennyiséget. A jegyűrlap elutasíthat egy már beváltott kódot. Tegye a szabályt az alkalmazásba, és tesztelje szándékosan. A böngésző nem tudja megkülönböztetni a második ravaszhúzást egy második figyelőtől.

Alkalmazásszabályok. Az ellenőrző számjegyek meghatározott szimbólumrendszerekhez tartoznak. Az EAN-13 az utolsó számjegyet használja ellenőrző számjegyként. Ez a függvény csak ezt a formátumot fogadja el:

function isEan13(value) {
  if (!/^\d{13}$/.test(value)) {
    return false
  }

  let sum = 0
  for (let index = 0; index < 12; index += 1) {
    const digit = Number(value[index])
    sum += index % 2 === 0 ? digit : digit * 3
  }

  const check = (10 - (sum % 10)) % 10
  return check === Number(value[12])
}

A Code 128, a Code 39 és a QR nem ezt a számítást használja. Az olvasó már ellenőrizhette a saját szimbólumrendszerét, és elküldhette az ember által olvasható adatot. Ellenőrizze a tárolt formátumokat, és ismételje meg az ellenőrzést a kiszolgálón. A beküldött karakterlánc közönséges felhasználói bemenet. A böngésző nem tudja bizonyítani, hogy olvasó állította elő.

Vonalkódolvasó bemenetének tesztelése fizikai hardver nélkül

A Barcode Scanner Emulator asztali alkalmazás Windowsra, macOS-re és Linuxra. Megadja a küldendő szöveget, választ egy gépelési késleltetést, és utótagként a nincs, az ENTER vagy a TAB egyikét választja. Egy globális billentyűparancs ezt a szöveget a fókuszált alkalmazásba gépeli. Azt a billentyűzetes útvonalat adja vissza, amelyet az ékeléses olvasó használ. Nem világít meg címkét, nem olvas szimbólumot, és nem dekódol szimbólumrendszert.

Használja a fenti példát, vagy az épülő oldalt:

  1. Nyissa meg az oldalt asztali böngészőben, és kattintson a vonalkódmezőre.
  2. Az emulátorban adjon meg egy ismert értéket, például 123456789012.
  3. Állítsa az utótagot ENTER értékre. Állítsa be a gépelési késleltetést, ha azt szeretné, hogy a sorozat egy már mért olvasóra hasonlítson.
  4. Nyomja meg az emulátor globális beolvasási billentyűparancsát, amíg a böngésző mezőjének még van fókusza.
  5. Erősítse meg az állapotszöveget, és hogy az érték egyszer lett elfogadva.
  6. Ismételje meg TAB utótaggal. A fókusznak át kell helyeződnie, és az értéknek egyszer kell elfogadódnia.
  7. Ismételje meg utótag nélkül. A szövegnek a mezőben kell maradnia, amíg aktiválja a Look up gombot.
  8. Ugyanazt az értéket küldje el újra a vonalkódbevitel-tesztelővel. Hasonlítsa össze a rögzített karakterláncot, az előtagot és az utótagot azzal, amit az alkalmazás tárolt.

A telepítést és az első billentyűparancsot az Első lépések ismerteti. Beállításváltozás után küldjön egy beolvasást a bemenettesztelőbe, mielőtt megbízna az alkalmazásbeli eredményben.

A hardver továbbra is kell a teszt optikai és eszközspecifikus részeihez:

  • Hogy az adott olvasó dekódolni tudja-e a nyomtatott vagy megjelenített szimbólumot, beleértve a sérült címkéket, a méretet, a kontrasztot és a távolságot.
  • Szimbólumrendszer-támogatás. Az 1D lézerolvasó nem tud QR-kódot olvasni. Lásd a QR-kód tesztelése: a QR-olvasók tesztelése útmutatót.
  • USB-felsorolás, Bluetooth-párosítás, valamint az olvasó saját billentyűzetkiosztása és utótagbeállítása.
  • Soros, HID POS és gyártói SDK integrációk.

Az emulátor a megfelelő eszköz az alkalmazáslogikához a billentyűzetes útvonalon. Nem alkalmas annak bizonyítására, hogy egy adott olvasó egy adott címkét olvas.

A vonalkódolvasó billentyűzeteseményeinek hibakeresése

Ebben a sorrendben figyelje az eseményeket, ha a tárolt érték hibás.

keydown. Minden billentyűre lefut, beleértve az Entert és a Tabot, mielőtt a böngésző karaktert szúr be vagy áthelyezi a fókuszt. Itt olvassa a lezárót. Az event.repeat igaz, ha egy billentyűt lenyomva tartanak. Az ékeléses olvasó általában külön lenyomást küld minden karakterhez.

input. A mezőn fut le, miután egy nyomtatható karakter megváltoztatta az értékét. Ez a megfelelő esemény, ha a szöveget növekedés közben kell látnia. Enterre vagy Tabra nem fut le, mert ezek a billentyűk nem szúrnak karaktert a szövegbevitelbe.

change. Az érték rögzítése után fut le, jellemzően amikor a mező elveszíti a fókuszt. Az az olvasó, amely a fókuszt ugyanabban a mezőben hagyja, a beolvasás végén nem hoz létre change eseményt. Ne a change legyen az egyetlen befejezési jel.

event.key és event.code. Naplózza mindkettőt, ha egy karakter hibás. Az olvasó kiosztása és az operációs rendszer kiosztása közötti eltérés megváltoztatja az event.key értékét, az event.code pedig az olvasó által szándékolt billentyűre hasonlít. A számbillentyűzet számjegyei a Numpad1 és hasonló kódokat használják. Egyes beviteli maszkok másként kezelik őket, mint a Digit1 kódot. A A vonalkódolvasó billentyűzetkiosztása hibás oldal magyarázza a kiosztáseltérést.

Fókusz. Naplózza a document.activeElement értékét közvetlenül a beolvasás előtt. Ha nem a vonalkódmező, a nyom többi része a rossz vezérlőt magyarázza. Az iframe-eknek saját fókuszuk van. A beágyazott keretbe érkező beolvasás a kereten belüli szkript számára látható.

Időzítés. Az olvasók a rövid hasznos adatot gyakran jóval egy másodperc alatt befejezik. A bemenettesztelő a karakterek közötti átlagos rést egy 100 ms-os küszöbhöz hasonlítja, és az eredményt időzítésnek címkézi, nem hardverazonosításnak. A résküszöb a gyors gépírót, az automatikus kitöltést vagy az emulátort olvasónak veheti. A karakterközi késleltetésű olvasó, a Bluetooth-kapcsolat vagy a hosszú hasznos adat gépelésnek tűnhet. Használja a rögzített értéket és az utótagot. Az időzítést nyomnak vegye.

A billentyűzetesemény-tesztelőt minden keydown és keyup esemény felsorolására használja, a key, a code, a módosítók és az időbélyegek mellett. Akkor használja, ha az összeállított karakterlánc elrejt egy előtagbillentyűt vagy egy számbillentyű-kódot. A napló böngészőesemény. Nem nyers USB-forgalom.

Gyakori problémák a webes alkalmazásokban

A beolvasás rossz mezőbe megy. Az ékeléses bemenet a fókuszt követi. Kattintson a célmezőre minden navigáció, párbeszédablak vagy érvényesítési üzenet után, amely áthelyezi a fókuszt. A szövegmező nélküli modális ablak gyorsbillentyűként nyelheti el a beolvasást.

Az olvasó a szövegszerkesztőben 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, a letiltott vagy csak olvasható bevitelt, és azt a keydown figyelőt, amely a nyomtatható billentyűkön preventDefault() függvényt hív. A csak paste eseményt kezelő figyelő soha nem lát ékeléses bemenetet. Kezdje a A vonalkódolvasó nem működik oldallal, ha egyetlen alkalmazás sem kap karaktereket.

Az Enter kétszer küldi el az űrlapot, vagy elnavigál. A böngésző elküldi az űrlapot, és a figyelője is kezeli az Entert. Hívja a preventDefault() függvényt az egyik úton, és az értéket egyszer dolgozza fel. A többmezős űrlap elküldődhet, mielőtt a későbbi mezők kitöltődnének, ha az olvasó Entert küld. Ehhez a munkafolyamathoz használjon Tabot, vagy akadályozza meg a küldést, amíg az űrlap kész.

A Tab megváltoztatja a fókuszt. Ez a Tab billentyű. Állítson be Entert az olvasón, vagy olvassa az értéket a keydown eseményben, és engedje a fókusz áthelyezését. Lásd a fenti utótagszakaszt.

A billentyűzetkiosztás hibás. A számjegyek túlélhetnek egy olyan eltérést, amely az írásjeleket megváltoztatja. Olvasson be egy ismert értéket, amely a tárolt szimbólumokat tartalmazza, azon a kiosztáson, amelyet a munkaállomás ténylegesen használ.

Ugyanaz a beolvasás két rekordot hoz létre. Keressen két figyelőt egy Enteren, mielőtt két fizikai beolvasást keresne. Ezután teszteljen egy szándékos második beolvasást, és erősítse meg a mennyiségi vagy ismétlési szabályt, amelyet az alkalmazás dokumentál.

Az érték hiányzik vagy csonka. A maxlength attribútum, egy beviteli maszk vagy a preventDefault() a karakterbillentyűkön elejtheti vagy levághatja a hasznos adatot. Hasonlítsa össze a karakterszámot a bemenettesztelőben a mező értékével. Egy előtag a helyes hasznos adatot túl hosszúnak is mutathatja.

A QR-kódok soha nem jelennek meg. Az olvasó lehet csak 1D, vagy a QR szimbólumrendszer ki lehet kapcsolva. Az alkalmazás ezt nem tudja javítani. Erősítse meg a hardvert a QR-kód tesztelése: a QR-olvasók tesztelése útmutatóval, majd térjen vissza a mezőteszthez.

Ellenőrzőlista a webes alkalmazás teszteléséhez

Ezt azon a builden használja, amelyet ki szándékozik adni, minden támogatott böngészőben. Ellenőrizze a friss profilt és a jelszókezelő- valamint automatikus kitöltés bővítményekkel rendelkező profilt is, mert ezek a bővítmények áthelyezik a fókuszt.

  • Az olvasó csatlakoztatva vagy párosítva van, és a gazdagép készenlétet mutat.
  • Az olvasó billentyűzet-ékelés módban van, nem soros vagy gyártói SDK módban.
  • A vonalkódmező közvetlenül a beolvasás előtt fókuszban van. A document.activeElement ez a mező.
  • Egy ismert vonalkód karakterről karakterre megérkezik, a hosszúsággal együtt.
  • Az ENTER utótag egyszer elküldi vagy elfogadja az értéket, és nem hagyja a lezárót a tárolt karakterláncban.
  • A TAB utótag a szándékolt vezérlőre viszi a fókuszt, és az érték az áthelyezés előtt beolvasódik.
  • Az utótag nélküli beállítás az értéket addig elérhetővé teszi, amíg az alkalmazás be nem fejezi.
  • Az üres beküldés elutasításra kerül, vagy figyelmen kívül marad.
  • Egy beolvasás nem hoz létre két rekordot. A második valódi beolvasás az alkalmazás ismétlési szabályát követi.
  • Az írásjelek, a szimbólumok és a formátumok által használt GS1-elválasztó túléli az oda-vissza utat.
  • Az olvasó billentyűzetkiosztása és az operációs rendszer kiosztása a címkére nyomtatott karaktereket adja.
  • Kihúzás és újracsatlakoztatás után, vagy a Bluetooth-kapcsolat megszakadása után a következő beolvasás továbbra is eléri a mezőt.
  • Több egymás utáni beolvasás külön érték marad. A mező nem fűzi össze őket.
  • Ugyanezek az ellenőrzések a támogatott böngészőkben is sikerülnek, a gyakori automatikus kitöltő bővítményekkel és nélkülük.

Párbeszédablakokhoz, a teljes pénztár tabulátorsorrendjéhez és a POS mennyiségi folyamataihoz folytassa a A vonalkódolvasó bemenetének tesztelése útmutatóval.

Tesztesetmátrix

Az olvasó oszlopa az, amit az eszköz és a böngésző tesz. A várt viselkedés oszlopa az, amit az alkalmazásnak válaszul tennie kell. Az üzleti szabályok, például hogy az ismételt termékkód növeli-e a mennyiséget, az alkalmazáshoz tartoznak. Írja bele őket a tesztbe, ahelyett hogy minden termékre egy szabályt feltételezne.

Forgatókönyv Várt viselkedés
Érvényes vonalkód Az alkalmazás elfogadja az értéket, és a hasznos adatot lezáró nélkül tárolja.
Üres bemenet Az alkalmazás elutasítja vagy figyelmen kívül hagyja, és nem hoz létre rekordot.
ENTER utótag Az alkalmazás egyszer elküldi vagy elfogadja az értéket.
TAB utótag A fókusz a szándékolt következő vezérlőre kerül, és az érték megmarad.
Nincs utótag A bemenet elérhető marad, amíg az alkalmazás fel nem dolgozza.
Gyors, egymás utáni beolvasások Minden érték külön kerül feldolgozásra, és nem fűződik az előzőhöz.
Hibás billentyűzetkiosztás A váratlan karakterek láthatók a rögzített értékben, és az ellenőrzés meghiúsul.
Ismételt beolvasás Az alkalmazás a saját ismétlési szabályát követi, például növeli a mennyiséget, vagy elutasítja az újrajátszást.
Érvénytelen vonalkódformátum Az alkalmazás megjeleníti az adott formátum ellenőrzési hibáját, és nem tárolja az értéket.
Elveszett bemeneti fókusz Az alkalmazás nem talál ki vonalkódot. A beolvasás hiányzik, vagy a fókuszált vezérlőbe kerül, és az oldal biztonságos állapotban marad.

Az érvényes, az üres, az ENTER, a TAB és az utótag nélküli sorokat futtassa a fizikai olvasóval, majd újra az emulátorral. A billentyűzetkiosztás, a QR és az újracsatlakoztatás sorait a hardveren futtassa. Ezek a sorok az eszköztől, a címkétől vagy az operációs rendszer kiosztásától függenek, amelyet a szimulált billentyűleütések nem adnak vissza.