Preskoči na vsebino

Barcode Scanner Emulator

Kako preizkusiti čitalnike črtnih kod v spletnih aplikacijah

Številni čitalniki črtnih kod USB in Bluetooth pošljejo dekodirane podatke kot vnos s tipkovnice, zato lahko polje v žarišču v spletni aplikaciji sprejme branje brez posebnega API-ja brskalnika za čitalnik. Serijska vrata in SDK izdelovalca so ločene integracije. Tipkovno pot lahko preverite s fizičnim čitalnikom ali s simuliranimi pritiski.

Spletna aplikacija čitalnik črtnih kod običajno vidi kot tipkovnico. Preizkus je, ali kontrolnik v žarišču prejme vsebino, ki jo aplikacija pričakuje, in ali stran obravnava zaključno tipko, ki jo je čitalnik nastavljen poslati. To je lahko Enter, Tab ali nič.

Uporabite sejo preizkuševalnika vnosa črtnih kod, ko je fizični čitalnik priključen. Uporabite Barcode Scanner Emulator, ko potrebujete isto tipkovno pot med razvojem, naprave pa ni na mizi. Širši prehod čez žarišče, postavitev in poteke POS je v vodniku Kako preizkusiti vnos čitalnika črtnih kod. Ta vodnik ostaja pri aplikaciji v brskalniku: zajem, pripone, preverjanje in dogodki, ki jih res lahko opazujete.

Kako čitalniki črtnih kod komunicirajo s spletnimi aplikacijami

Način vmesnika odloča, kaj lahko stran prejme. Potrdite ga, preden spremenite kodo obrazca. Čitalnik pogosto preklaplja načine z branjem konfiguracijske črtne kode iz priročnika izdelovalca.

Tipkovni klin HID prek USB

V načinu tipkovnice USB HID se čitalnik prijavi kot tipkovnica. Operacijski sistem naloži običajni gonilnik tipkovnice. Ko dekodira simbol, čitalnik pošlje znake kot pritiske kontrolniku, ki ima žarišče tipkovnice. Stran posluša te pritiske ali prebere besedilo, ki ga vstavijo. Povezave z napravo ne odpre.

Zato lahko polje blagajne, iskalno polje ali kateri koli drug besedilni vnos sprejme branje z običajnim HTML. Vodnik Tipkovni klin HID podrobneje opiše zaporedje pritiskov, predpone in pripone.

Bluetooth HID

Čitalnik Bluetooth, seznanjen kot tipkovnica, gre v aplikaciji po isti poti. Gostitelj ga obravnava kot tipkovnico HID, polje v žarišču pa prejme pritiske. Seznanjanje, baterija in radio so skrb naprave. Ko znaki dosežejo brskalnik, jih stran obravnava enako kot vnos s klina USB.

Serijska vrata in navidezni COM

Serijski čitalnik, vključno s številnimi načini navideznih vrat COM prek USB, pošlje dekodirano besedilo kot bajte na vrata. Žarišče ne izbere naslovnika. Izbere ga proces, ki vrata odpre. Besedilno polje, ki samo posluša pritiske, tega toka ne bo videlo.

Brskalniki na osnovi Chromium lahko odprejo serijska vrata prek Web Serial API, ko uporabnik izbere vrata in podeli dovoljenje. Firefox in Safari tega API-ja ne ponujata. Preizkus klina ne vadi serijske integracije, serijski preizkus pa ne pove, kaj bo klinasti čitalnik vtipkal.

Vmesniki določenega izdelovalca

Nekatere naprave uporabljajo SDK izdelovalca, OPOS, JPOS ali vmesnik HID, ki ni tipkovnica, na primer USB HID POS. Ti vmesniki ne tipkajo v polje v žarišču. Običajna spletna stran ne more naložiti izvornega SDK. Chromium lahko po potezi uporabnika zahteva nekatere naprave HID, ki niso tipkovnice, prek WebHID. Naprave HID razreda tipkovnice ostanejo blokirane, zato klinasti čitalnik ostane nerazločljiv od tipkovnice. Vmesnik izdelovalca obravnavajte kot lastno integracijo in ga preizkusite s programjem, ki ta vmesnik res odpre.

Kaj lahko vidi brskalnik

Branje s klinom pride kot dogodka keydown in keyup, natisljivi znaki pa posodobijo polje v žarišču. Brskalnik ne dobi imena naprave, serijske številke USB niti zastavice, ki bi rekla „čitalnik”. Brskalniki z WebHID vmesnike tipkovnice še vedno zavrnejo, zato skript strani ne more prebrati niti surovih poročil HID klinastega čitalnika.

event.key je znak ali ime tipke, potem ko operacijski sistem uporabi dejavno postavitev tipkovnice. event.code poimenuje fizično tipko, na primer Digit1 ali Numpad1, in lahko ostane enak, ko neujemanje postavitev spremeni event.key. Nobena lastnost ne prepozna strojne opreme.

Kako preizkusiti fizični čitalnik črtnih kod v brskalniku

Naredite to, preden odpravljate napake v kodi aplikacije. Pokaže natančen niz in zaključno tipko, ki ju je prejel brskalnik.

  1. Priključite čitalnik in počakajte, da pokaže, da ima napajanje. Pri Bluetooth končajte seznanjanje in potrdite, da gostitelj uporablja profil tipkovnice.
  2. Potrdite način vnosa. Tipkovni klin, tipkovnica USB HID ali tipkovnica Bluetooth HID lahko tipkajo v polje. Načini Serial, SPP in SDK izdelovalca ne morejo.
  3. Odprite preizkuševalnik vnosa črtnih kod.
  4. Kliknite Začni preizkus ali kliknite območje branja. Pomodri, ko je pripravljeno. Stran sama ne prevzame žarišča.
  5. Preberite črtno kodo, katere vsebino že poznate. Začnite s kratko številsko vrednostjo, nato preberite vrednost z ločili, ki jih aplikacija shrani.
  6. Preberite zajeto vrednost in število znakov. Primerjajte oboje s pričakovano vsebino, vključno s katero koli predpono, ki jo čitalnik vstavi pred podatke.
  7. Preverite pripono. Preizkuševalnik sporoči ENTER, TAB ali Brez. Ko je Samodejni zajem vklopljen, se rezultat pokaže po Enter, Tab ali kratkem premoru, ko tipke ponehajo. Izklopite Samodejni zajem, ko želite zajem zadržati, dokler ne pritisnete Ustavi.
  8. Primerjajte ta rezultat z nizom, ki ga mora aplikacija shraniti. Predpono, zamenjan znak ali manjkajočo zaključno tipko je treba popraviti v nastavitvi čitalnika ali jih namenoma obravnavati na strani. Ne jemljite tega kot neuspeh dekodiranja, dokler ta primerjava ni opravljena.

Preizkuševalnik beleži dogodke tipkovnice, ki jih brskalnik vidi. Ne more prepoznati naprave USB niti brati serijskih vrat. Ko urejevalnik besedila prejme branje, brskalnik pa ne, nadaljujte z Čitalnik deluje v Notepadu, ne pa v POS.

Zajem vnosa čitalnika črtnih kod z JavaScriptom

Čitalnik tipka v element, ki ima žarišče. Polju dajte vidno oznako, pustite ga kot navaden besedilni vnos, da lahko kodo vtipkate s tipkovnice, in preberite vrednost, ko potek reče, da je vnos končan. Spodnja stran to naredi. Enter odda obrazec enkrat. Tab dokonča neprazno vrednost in nato pusti brskalniku, da premakne žarišče. Branje brez zaključne tipke ostane v polju, dokler nekdo ne aktivira gumba Look up.

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

Shranite datoteko in jo odprite v namiznem brskalniku. Kliknite polje, če se je žarišče premaknilo. Klinasti čitalnik ali emulator iz naslednjega razdelka nato tipka v #barcode.

Žarišče je obvezno. Če je document.activeElement telo dokumenta, gumb ali drug vnos, poslušalci tega polja branja ne vidijo. Znaki pristanejo v kontrolniku v žarišču ali se izgubijo. Pokličite field.focus(), ko je potek pripravljen na branje, tudi po zaprtju pogovornega okna.

Prazen vnos se prezre. Obrazec ostane na mestu, besedilo stanja pa pove, da ni bilo nič prejeto. Sami presledki so po trim() prazni.

Primer ne doda Enter ali Tab. Če čitalnik ni nastavljen, da ju pošlje, vrednost ostane v polju, gumb Look up pa je pot dokončanja. autocomplete="off" zmanjša možnost, da shranjena vrednost zamenja branje. Oznaka, gumb in Shift+Tab ostanejo na voljo, zato lahko oseba vnese kodo brez čitalnika.

Enter obravnavajte na enem mestu. Ta primer uporablja dogodek submit obrazca, ki pokrije tudi gumb Look up in Enter s tipkovnice. Drugi poslušalec keydown za Enter bi isto branje zapisal dvakrat. Če vnos ni znotraj obrazca, poslušajte Enter na keydown in pokličite preventDefault(), da se nadrejeni obrazec ne odda tudi sam:

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

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

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

Po uspešnem sprejemu polje počistite, da se naslednje branje ne pripne prejšnji vsebini. Po Enter primer znova osredotoči isto polje, ker ta potek pričakuje še eno branje v istem polju. Po Tab žarišče pusti pri miru, da lahko brskalnik preide na naslednji kontrolnik.

Ravnanje s priponama ENTER in TAB

Pripona je tipka, ki jo čitalnik lahko pošlje za vsebino. To je nastavitev naprave. Enter je pogost in je izbiren. Vodnik Pripone ENTER in TAB v čitalnikih črtnih kod opisuje, kako ločiti zaključni tipki. Potrdite nastavitev na čitalniku, ki ga preizkušate, nato stran uskladite s tem potekom.

ENTER

Enter v enovrstičnem besedilnem polju v sedanjih brskalnikih odda obdajajoči obrazec. Uporabite to, ko mora eno branje potrditi vrednost, kot v iskalnem polju. preventDefault() na dogodku submit prepreči brskalniku, da zapusti stran. Izpustite ga, ko je prehod na drugo stran želeno vedenje.

Če se črtna koda pojavi, obrazec pa ne naredi nič, čitalnik morda ne pošilja pripone. Čitalniku črtnih kod manjka ENTER gre skozi to konfiguracijo. Nekatere naprave pošljejo NumPad Enter. event.key je še vedno "Enter". Preverjajte event.key, ne samo event.code === "Enter", sicer bo tak čitalnik videti pokvarjen.

TAB

Tab premakne žarišče na naslednji kontrolnik, ki ga lahko sprejme. To ustreza zaporedju, kot je koda izdelka, nato količina. Preseneti obrazec, ki je pričakoval, da ga bo oddal Enter.

Vrednost berite v keydown, dokler ima polje še žarišče. Brskalnik premakne žarišče po tem dogodku. Privzeto dejanje pustite, ko mora naslednji kontrolnik dobiti žarišče. preventDefault() zadrži žarišče na mestu, kar je uporabno, ko je vrednost neveljavna in jo mora upravljavec videti. Prezrite Shift+Tab, da lahko uporabnik tipkovnice gre nazaj po obrazcu. Pripona Tab čitalnika je Tab brez Shift.

Pripona Tab lahko premakne žarišče tudi preden koda prebere polje, če je poslušalec na blur ali change in nekaj drugega počisti kontrolnik. Vrednost berite iz target dogodka keydown.

Brez pripone

Brez pripone vsebina sedi v polju. Aplikacija mora odločiti, kdaj je branje končano. Izrecen gumb, poznejši Enter upravljavca ali prehod na drug korak so zanesljive točke dokončanja. Časovnik nedejavnosti lahko premor pri tipkanju vzame za konec branja. Ta časovnik je hevristika. Počasen čitalnik, zakasnitev Bluetooth ali oseba, ki hitro tipka, lahko padejo na napačno stran praga. Raje imejte nastavljeno pripono, ko potek potrebuje trd signal konca branja.

Razlike v konfiguraciji

Čitalniki iste znamke lahko pridejo z različnimi priponami, konfiguracijska črtna koda pa lahko pripono spremeni brez kakršne koli spremembe v JavaScript. Nekatere naprave pošljejo predpono, identifikator simbologije, kot je ]C1, ali CR in LF. Preizkusite tri zaključne nastavitve, ki jih uporabniki res lahko izberejo: Enter, Tab in nobene pripone. Zapišite, katero uporabljajo nameščeni čitalniki, in stran preizkusite glede na to nastavitev.

Preverjanje vnosa čitalnika črtnih kod

Preverite niz, ki ga je prejelo polje. Ne predpostavljajte, da ima vsaka črtna koda enako dolžino, nabor znakov in kontrolno vsoto. Vsebini Code 128 in QR se razlikujeta. EAN-13 ima 13 števk. Aplikacija, ki shrani oboje, potrebuje pravila za oboje.

Prazen vnos. Zavrnite ga ali ga prezrite. Pripona brez vsebine ali klik na Look up v praznem polju ne sme ustvariti zapisa.

Nepričakovani znaki. Primerjajte prejeti niz z znano nalepko. Neujemanje postavitev se pogosto pokaže kot spremenjen simbol, na primer premaknjena števka ali ločilo, medtem ko dolžina ostane enaka. Kontrolni znaki lahko pridejo iz predpone ali iz ločila skupin GS1. Dovolite znake, ki jih določa vaš zapis. Zgornji primer zavrne kontrolne znake ASCII, da ostanejo vidni v besedilu stanja. Razčlenjevalnik GS1, ki pričakuje ločilo skupin, mora ta znak dovoliti, ostale pa zavrniti.

Dolžina. Uveljavite dolžine, ki jih aplikacija sprejme. Skupni minimum in maksimum sta varnejša od ene obvezne dolžine, ko obrazec prejme več kot eno simbologijo. maxlength na vnosu tiho odreže daljšo vsebino, zato ga nastavite samo, ko se vsaka sprejeta koda prilega.

Predpona. Predpono odstranite samo, ko ste čitalnik nastavili, da pošlje natanko to predpono, aplikacija pa je ne shrani.

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

Identifikator simbologije AIM so podatki, če je čitalnik nastavljen, da ga oddaja. Pustite ga, dokler ne odločite, ali ga aplikacija shrani.

Pripona. Zaključne tipke ne vključite v shranjeno vrednost. Enter in Tab sta tipki. V navaden besedilni vnos se ne vstavita. Serijska vsebina lahko še vedno vsebuje bajte CR ali LF. Odstranite ju na meji, kjer razčlenjujete serijski tok, in preverite, da ju ne odstranite iz sredine vsebine, ki ju legitimno vsebuje.

Podvojene oddaje. Eno branje je mogoče obravnavati dvakrat, če za isti Enter tečeta keydown in submit. Uporabite eno pot dokončanja. Drugo branje iste kode je drugo vprašanje. Skladiščni obrazec lahko poveča količino. Obrazec vstopnice lahko zavrne kodo, ki je bila že unovčena. To pravilo dajte v aplikacijo in ga preizkusite namenoma. Brskalnik ne more ločiti drugega potega sprožilca od drugega poslušalca.

Pravila aplikacije. Kontrolne vsote pripadajo določenim simbologijam. EAN-13 uporablja zadnjo števko kot kontrolno števko. Ta funkcija sprejme samo ta zapis:

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

Code 128, Code 39 in QR tega izračuna ne uporabljajo. Čitalnik je morda že preveril lastno simbologijo in oddal podatke, berljive človeku. Preverjajte zapise, ki jih shranjujete, in preverjanje ponovite na strežniku. Poslani niz je običajen uporabniški vnos. Brskalnik ne more dokazati, da ga je ustvaril čitalnik.

Preizkušanje vnosa čitalnika črtnih kod brez fizične strojne opreme

Barcode Scanner Emulator je namizna aplikacija za Windows, macOS in Linux. Vnesete besedilo za pošiljanje, izberete zakasnitev tipkanja in pripono: brez, ENTER ali TAB. Globalna bližnjica to besedilo vtipka v aplikacijo v žarišču. Posnema tipkovno pot, ki jo uporablja klinasti čitalnik. Ne osvetli nalepke, ne prebere simbola in ne dekodira simbologije.

Uporabite zgornjo vzorčno stran ali stran, ki jo gradite:

  1. Odprite stran v namiznem brskalniku in kliknite polje črtne kode.
  2. V emulatorju vnesite znano vrednost, na primer 123456789012.
  3. Nastavite pripono na ENTER. Nastavite zakasnitev tipkanja, če želite, da rafal spominja na čitalnik, ki ste ga že izmerili.
  4. Pritisnite globalno bližnjico branja emulatorja, dokler ima polje v brskalniku še žarišče.
  5. Potrdite besedilo stanja in da je bila vrednost sprejeta enkrat.
  6. Ponovite s TAB. Žarišče se mora premakniti, vrednost pa mora biti sprejeta enkrat.
  7. Ponovite brez pripone. Besedilo mora ostati v polju, dokler ne aktivirate Look up.
  8. Osredotočite preizkuševalnik vnosa črtnih kod in pošljite isto vrednost še enkrat. Primerjajte zajeti niz, predpono in pripono s tem, kar je aplikacija shranila.

Namestitev in prvo bližnjico pokriva Začetek. Po spremembi nastavitev pošljite eno branje v preizkuševalnik vnosa, preden zaupate rezultatu v aplikaciji.

Strojna oprema je še vedno potrebna za optični del preizkusa in za del, ki je vezan na napravo:

  • Ali ta čitalnik lahko dekodira natisnjen ali prikazan simbol, vključno s poškodovanimi nalepkami, velikostjo, kontrastom in razdaljo.
  • Podpora simbologij. Laserski čitalnik 1D ne more prebrati kode QR. Glejte Preizkušanje kod QR: kako preizkusiti čitalnike kod QR.
  • Naštevanje USB, seznanjanje Bluetooth ter lastna konfiguracija postavitve tipkovnice in pripone čitalnika.
  • Integracije Serial, HID POS in SDK izdelovalca.

Emulator je pravo orodje za logiko aplikacije vzdolž tipkovne poti. Ni orodje, s katerim dokažete, da določen čitalnik bere določeno nalepko.

Odpravljanje napak v dogodkih tipkovnice čitalnika črtnih kod

Spremljajte dogodke v tem vrstnem redu, ko je shranjena vrednost napačna.

keydown. Sproži se za vsako tipko, vključno z Enter in Tab, preden brskalnik vstavi znak ali premakne žarišče. Zaključno tipko berite tukaj. event.repeat je resničen, ko je tipka pridržana. Klinasti čitalnik običajno pošlje ločen pritisk za vsak znak.

input. Sproži se na polju, potem ko natisljiv znak spremeni njegovo vrednost. To je pravi dogodek, če potrebujete besedilo, ko raste. Za Enter ali Tab se ne sproži, ker ti tipki ne vstavita znaka v besedilni vnos.

change. Sproži se po potrditvi vrednosti, običajno ko polje izgubi žarišče. Čitalnik, ki pusti žarišče v istem polju, ob koncu branja ne bo ustvaril change. Ne uporabljajte change kot edinega signala dokončanja.

event.key in event.code. Zapišite oba, ko je znak napačen. Neujemanje med postavitvijo čitalnika in postavitvijo operacijskega sistema spremeni event.key in pusti event.code, da je videti kot tipka, ki jo je čitalnik nameraval. Števke s številčne tipkovnice uporabljajo Numpad1 in podobne kode. Nekatere vnosne maske jih obravnavajo drugače kot Digit1. Napačna postavitev tipkovnice čitalnika črtnih kod razloži neujemanje postavitev.

Žarišče. Zapišite document.activeElement tik pred branjem. Če to ni polje črtne kode, preostanek sledi razlaga napačen kontrolnik. Iframe ima lastno žarišče. Branje v vdelan okvir vidi skript znotraj tega okvira.

Čas. Čitalniki pogosto končajo kratko vsebino precej pod sekundo. Preizkuševalnik vnosa primerja povprečno vrzel med znaki s pragom 100 ms in rezultat označi kot čas, ne kot prepoznavo strojne opreme. Prag vrzeli lahko hitrega tipkarja, samodejno izpolnjevanje ali emulator vzame za čitalnik. Čitalnik z zakasnitvijo med znaki, povezavo Bluetooth ali dolgo vsebino je lahko videti kot tipkanje. Uporabite zajeto vrednost in pripono. Čas uporabite kot namig.

Preizkuševalnik dogodkov tipkovnice našteje vsak keydown in keyup s key, code, modifikatorji in časovnimi žigi. Uporabite ga, ko sestavljeni niz skrije tipko predpone ali kodo številčne tipkovnice. Dnevnik so dogodki brskalnika. To ni surov promet USB.

Pogoste težave v spletnih aplikacijah

Branje gre v napačno polje. Vnos s klinom sledi žarišču. Kliknite ciljno polje po vsaki navigaciji, pogovornem oknu ali sporočilu preverjanja, ki premakne žarišče. Modalno okno brez besedilnega polja lahko pogoltne branje kot bližnjice tipkovnice.

Čitalnik deluje v urejevalniku besedila, ne pa v brskalniku. Naprava tipka. Stran teh tipk ne sprejme. Preverite žarišče, onemogočen vnos ali vnos samo za branje in poslušalca keydown, ki kliče preventDefault() na natisljivih tipkah. Poslušalec, ki obravnava samo paste, vnosa s klinom nikoli ne vidi. Začnite z Čitalnik črtnih kod ne deluje, če nobena aplikacija ne prejme znakov.

Enter odda obrazec dvakrat ali zapusti stran. Brskalnik odda obrazec, vaš poslušalec pa tudi obravnava Enter. Pokličite preventDefault() na eni od teh poti in vrednost obdelajte enkrat. Obrazec z več polji se lahko odda, preden so poznejša polja izpolnjena, ko čitalnik pošlje Enter. Za ta potek uporabite Tab ali preprečite oddajo, dokler obrazec ni popoln.

Tab spremeni žarišče. To je tipka Tab. Ali na čitalniku nastavite Enter, ali vrednost berite v keydown in dovolite premik žarišča. Glejte razdelek o priponah zgoraj.

Postavitev tipkovnice je napačna. Števke lahko preživijo neujemanje, ki spremeni ločila. Preberite znano vrednost s simboli, ki jih shranjujete, na postavitvi, ki jo delovna postaja res uporablja.

Isto branje ustvari dva zapisa. Iščite dva poslušalca na enem Enter, preden iščete dve fizični branji. Nato preizkusite namerno drugo branje in potrdite pravilo količine ali dvojnika, ki ga opisuje aplikacija.

Vrednost manjka ali je odrezana. Atribut maxlength, vnosna maska ali preventDefault() na znakovnih tipkah lahko izpustijo ali odrežejo vsebino. Primerjajte število znakov v preizkuševalniku vnosa z vrednostjo v vašem polju. Predpona lahko tudi pravilno vsebino prikaže kot predolgo.

Kode QR se nikoli ne pojavijo. Čitalnik je lahko samo 1D ali pa je simbologija QR izklopljena. Aplikacija tega ne more popraviti. Strojno opremo potrdite z Preizkušanje kod QR: kako preizkusiti čitalnike kod QR, nato se vrnite k preizkusu polja.

Kontrolni seznam preizkušanja spletne aplikacije

Uporabite ga na gradnji, ki jo nameravate izdati, v vsakem brskalniku, ki ga podpirate. Preverite svež profil in profil z razširitvami upravitelja gesel ter samodejnega izpolnjevanja, ker te razširitve premikajo žarišče.

  • Čitalnik je priključen ali seznanjen, gostitelj pa kaže, da je pripravljen.
  • Čitalnik je v načinu tipkovnega klina, ne v serijskem načinu ali načinu SDK izdelovalca.
  • Polje črtne kode je v žarišču tik pred branjem. document.activeElement je to polje.
  • Znana črtna koda pride znak za znakom, vključno z dolžino.
  • Pripona ENTER odda ali sprejme vrednost enkrat in ne pusti zaključne tipke v shranjenem nizu.
  • Pripona TAB premakne žarišče na predvideni kontrolnik, vrednost pa je prebrana pred premikom.
  • Konfiguracija brez pripone pusti vrednost na voljo, dokler je aplikacija ne dokonča.
  • Prazna oddaja je zavrnjena ali prezrta.
  • Eno branje ne ustvari dveh zapisov. Drugo pravo branje sledi pravilu dvojnikov aplikacije.
  • Ločila, simboli in vsako ločilo GS1, ki ga uporabljajo vaši zapisi, preživijo pot v obe smeri.
  • Postavitev tipkovnice čitalnika in postavitev operacijskega sistema data znake, natisnjene na nalepki.
  • Po izključitvi in ponovni priključitvi ali po prekinitvi povezave Bluetooth naslednje branje še vedno doseže polje.
  • Več branj zapored ostane ločenih vrednosti. Polje jih ne zlepi.
  • Isti pregledi uspejo v brskalnikih, ki jih podpirate, z običajnimi razširitvami samodejnega izpolnjevanja in brez njih.

Za pogovorna okna, vrstni red tabulatorja čez celotno blagajno in poteke količine v POS nadaljujte z vodnikom Kako preizkusiti vnos čitalnika črtnih kod.

Matrika preizkusnih primerov

Stolpec čitalnika je tisto, kar naredita naprava in brskalnik. Stolpec pričakovanega vedenja je tisto, kar mora aplikacija storiti v odgovor. Poslovna pravila, na primer ali ponovljena koda izdelka poveča količino, pripadajo aplikaciji. Navedite jih v preizkusu, namesto da predpostavite eno pravilo za vsak izdelek.

Scenarij Pričakovano vedenje
Veljavna črtna koda Aplikacija sprejme vrednost in shrani vsebino brez zaključne tipke.
Prazen vnos Aplikacija ga zavrne ali prezre in ne ustvari zapisa.
Pripona ENTER Aplikacija odda ali sprejme vrednost enkrat.
Pripona TAB Žarišče preide na predvideni naslednji kontrolnik, vrednost pa se ohrani.
Brez pripone Vnos ostane na voljo, dokler ga aplikacija ne obdela.
Hitra zaporedna branja Vsaka vrednost se obdela ločeno in se ne zlepi s prejšnjo.
Napačna postavitev tipkovnice Nepričakovani znaki so vidni v zajeti vrednosti in ne prestanejo preverjanja.
Podvojeno branje Aplikacija sledi lastnemu pravilu dvojnika, na primer poveča količino ali zavrne ponovitev.
Neveljaven zapis črtne kode Aplikacija pokaže napako preverjanja za ta zapis in vrednosti ne shrani.
Izgubljeno žarišče vnosa Aplikacija si črtne kode ne izmisli. Branje manjka ali pristane v kontrolniku v žarišču, stran pa ostane v varnem stanju.

Vrstice veljavne vrednosti, praznega vnosa, ENTER, TAB in brez pripone zaženite s fizičnim čitalnikom in še enkrat z emulatorjem. Vrstice postavitve tipkovnice, QR in ponovne priključitve zaženite na strojni opremi. Te vrstice so odvisne od naprave, nalepke ali postavitve operacijskega sistema, česar simulirani pritiski ne poustvarijo.