Siirry sisältöön

Barcode Scanner Emulator

Miten viivakoodinlukijoita testataan verkkosovelluksissa

Monet USB- ja Bluetooth-viivakoodinlukijat lähettävät puretun datan näppäimistösyötteenä, joten verkkosovelluksen kohdistettu kenttä voi vastaanottaa skannauksen ilman lukijakohtaista selain-API:a. Sarjaportit ja valmistajan SDK:t ovat erillisiä integraatioita. Näppäimistöpolun voi testata fyysisellä lukijalla tai simuloiduilla näppäilyillä.

Verkkosovellus näkee viivakoodinlukijan yleensä näppäimistönä. Testi on, saako kohdistettu kontrolli tietosisällön, jota sovellus odottaa, ja käsitteleekö sivu päättäjän, jonka lukija on asetettu lähettämään. Päättäjä voi olla Enter, Tab tai ei päättäjää lainkaan.

Käytä viivakoodisyötteen testaajaa, kun fyysinen lukija on kytketty. Käytä sovellusta Barcode Scanner Emulator, kun sama näppäimistöpolku tarvitaan kehityksen aikana eikä laite ole pöydällä. Laajempi läpikäynti kohdistuksesta, asettelusta ja POS-työnkuluista on oppaassa Miten viivakoodinlukijan syöte testataan. Tämä opas pysyy selainsovelluksessa: kaappaus, päätteet, validointi ja tapahtumat, jotka todella voi havaita.

Miten viivakoodinlukijat viestivät verkkosovellusten kanssa

Liitäntätila ratkaisee, mitä sivu voi vastaanottaa. Vahvista se ennen lomakekoodin muuttamista. Lukija voi usein vaihtaa tilaa skannaamalla määritysviivakoodin valmistajan ohjeesta.

USB HID -näppäimistökiila

USB HID -näppäimistötilassa lukija näkyy näppäimistönä. Käyttöjärjestelmä lataa tavallisen näppäimistöohjaimen. Kun lukija on purkanut symbolin, se lähettää merkit näppäilyinä kontrollille, jolla on näppäimistökohdistus. Sivu kuuntelee näitä näppäilyjä tai lukee tekstin, jonka ne lisäävät. Se ei avaa yhteyttä laitteeseen.

Tämä polku on syy siihen, että kassakenttä, hakuruutu tai mikä tahansa muu tekstisyöte voi ottaa skannauksen vastaan tavallisella HTML:llä. Opas HID-näppäimistökiila käy näppäilyjärjestyksen, etuliitteet ja päätteet tarkemmin läpi.

Bluetooth HID

Näppäimistönä paritettu Bluetooth-lukija käyttää samaa sovelluspolkua. Isäntä käsittelee sitä HID-näppäimistönä, ja kohdistettu kenttä vastaanottaa näppäilyt. Paritus, akku ja radio ovat laitteen asioita. Kun merkit ovat selaimessa, sivu käsittelee ne samalla tavalla kuin USB-kiilan syötteen.

Sarjaportti ja virtuaalinen COM-portti

Sarjalukija, myös monet USB:n virtuaaliset COM-porttitilat, lähettää puretun tekstin tavuina porttiin. Kohdistus ei valitse kohdetta. Sen tekee prosessi, joka avaa portin. Tekstikenttä, joka kuuntelee vain näppäilyjä, ei näe tätä virtaa.

Chromium-pohjaiset selaimet voivat avata sarjaportin Web Serial API:n kautta, kun käyttäjä on valinnut portin ja antanut luvan. Firefox ja Safari eivät tarjoa tätä API:a. Kiilatesti ei harjoita sarjaintegraatiota, eikä sarjatesti kerro, mitä kiilalukija kirjoittaa.

Valmistajakohtaiset liitännät

Jotkin laitteet käyttävät valmistajan SDK:ta, OPOS:ia, JPOS:ia tai näppäimistöön kuulumatonta HID-liitäntää, kuten USB HID POS. Nämä liitännät eivät kirjoita kohdistettuun kenttään. Tavallinen verkkosivu ei voi ladata natiivia SDK:ta. Chromium voi pyytää joitakin näppäimistöön kuulumattomia HID-laitteita WebHID:n kautta käyttäjän eleen jälkeen. Näppäimistöluokan HID-laitteet pysyvät estettyinä, joten kiilalukijaa ei voi erottaa näppäimistöstä. Käsittele valmistajan liitäntä omana integraationaan ja testaa se ohjelmistolla, joka todella avaa liitännän.

Mitä selain näkee

Kiilaskannaus saapuu tapahtumina keydown ja keyup, ja tulostettavat merkit päivittävät kohdistetun kentän. Selain ei saa laitteen nimeä, USB-sarjanumeroa eikä lippua, joka sanoisi lähteen olevan lukija. WebHID:n toteuttavat selaimet kieltäytyvät yhä näppäimistöliitännöistä, joten sivun skripti ei voi lukea kiilalukijan raakoja HID-raporttejakaan.

event.key on merkki tai näppäimen nimi sen jälkeen, kun käyttöjärjestelmä on soveltanut aktiivisen näppäimistöasettelun. event.code nimeää fyysisen näppäimen, esimerkiksi Digit1 tai Numpad1, ja voi pysyä samana, kun asetteluero muuttaa event.key-arvoa. Kumpikaan ominaisuus ei tunnista laitteistoa.

Miten fyysinen viivakoodinlukija testataan selaimessa

Aja tämä ennen sovelluskoodin vianmääritystä. Se näyttää tarkan merkkijonon ja päättäjän, jonka selain vastaanotti.

  1. Kytke lukija ja odota, kunnes se näyttää saaneensa virtaa. Bluetoothissa viimeistele paritus ja varmista, että isäntä käyttää näppäimistöprofiilia.
  2. Vahvista syötetila. Näppäimistökiila, USB HID -näppäimistö tai Bluetooth HID -näppäimistö voi kirjoittaa kenttään. Sarjatila, SPP ja valmistajan SDK eivät voi.
  3. Käytä viivakoodisyötteen testaajaa.
  4. Napsauta Aloita testi tai napsauta skannausaluetta. Se muuttuu siniseksi, kun se on valmis. Sivu ei ota kohdistusta itse.
  5. Skannaa viivakoodi, jonka tietosisällön jo tiedät. Aloita lyhyellä numerolla ja skannaa sitten arvo, jossa on sovelluksen tallentama välimerkistö.
  6. Lue kaapattu arvo ja merkkimäärä. Vertaa molempia odottamaasi tietosisältöön, myös etuliitteeseen, jonka lukija lisää ennen dataa.
  7. Tarkista pääte. Testaaja ilmoittaa ENTER, TAB tai Ei mitään. Kun Automaattinen kaappaus on päällä, tulos ilmestyy Enterin, Tabin tai lyhyen tauon jälkeen, kun näppäimet lakkaavat. Poista Automaattinen kaappaus käytöstä, kun haluat kaappauksen pysyvän, kunnes painat Pysäytä.
  8. Vertaa tulosta merkkijonoon, jonka sovelluksen pitäisi tallentaa. Etuliite, korvautunut merkki tai puuttuva päättäjä korjataan lukijan määrityksessä tai käsitellään tarkoituksella sivulla. Älä pidä sitä purkuvirheenä, ennen kuin tämä vertailu on tehty.

Testaaja tallentaa näppäimistötapahtumat, jotka selain näkee. Se ei tunnista USB-laitetta eikä lue sarjaporttia. Kun tekstieditori vastaanottaa skannauksen mutta selain ei, jatka oppaalla Lukija toimii Notepadissa mutta ei POS-järjestelmässä.

Viivakoodinlukijan syötteen kaappaaminen JavaScriptillä

Lukija kirjoittaa elementtiin, jolla on kohdistus. Anna kentälle näkyvä otsikko, jätä se tavalliseksi tekstikentäksi, jotta näppäimistön käyttäjä voi kirjoittaa koodin, ja lue arvo, kun työnkulku sanoo merkinnän olevan valmis. Alla oleva sivu tekee tämän. Enter lähettää lomakkeen kerran. Tab täydentää ei-tyhjän arvon ja antaa sitten selaimen siirtää kohdistuksen. Skannaus ilman päättäjää jää kenttään, kunnes joku aktivoi Look up -painikkeen.

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

Tallenna tiedosto ja avaa se työpöytäselaimessa. Napsauta kenttää, jos kohdistus on siirtynyt. Kiilalukija tai seuraavan osion emulaattori kirjoittaa sitten kenttään #barcode.

Kohdistus on välttämätön. Jos document.activeElement on asiakirjan runko, painike tai toinen kenttä, tämän kentän kuuntelijat eivät näe skannausta. Merkit päätyvät kohdistettuun kontrolliin tai katoavat. Kutsu field.focus(), kun työnkulku on valmis skannaukseen, myös valintaikkunan sulkeuduttua.

Tyhjä syöte ohitetaan. Lomake pysyy paikallaan, ja tilateksti kertoo, ettei mitään vastaanotettu. Pelkkä väli on tyhjä trim()-kutsun jälkeen.

Esimerkki ei lisää Enteriä eikä Tabia. Jos lukijaa ei ole asetettu lähettämään niitä, arvo jää kenttään ja Look up on valmistumispolku. autocomplete="off" vähentää mahdollisuutta, että tallennettu arvo korvaa skannauksen. Otsikko, painike ja Shift+Tab pysyvät käytössä, joten henkilö voi syöttää koodin ilman lukijaa.

Käsittele Enter yhdessä paikassa. Esimerkki käyttää lomakkeen submit-tapahtumaa, joka kattaa myös Look up -painikkeen ja näppäimistön Enterin. Toinen keydown-kuuntelija Enterille kirjaisi saman skannauksen kahdesti. Jos kenttä ei ole lomakkeen sisällä, kuuntele Enteriä tapahtumassa keydown ja kutsu preventDefault(), jotta ylempi lomake ei lähde myös:

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

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

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

Tyhjennä kenttä onnistuneen hyväksynnän jälkeen, jotta seuraava skannaus ei liity edelliseen tietosisältöön. Enterin jälkeen esimerkki kohdistaa saman kentän uudelleen, koska työnkulku odottaa uutta skannausta samaan ruutuun. Tabin jälkeen se jättää kohdistuksen rauhaan, jotta selain voi siirtyä seuraavaan kontrolliin.

ENTER- ja TAB-päätteiden käsittely

Pääte on näppäin, jonka lukija voi lähettää tietosisällön jälkeen. Se on laitteen asetus. Enter on yleinen ja valinnainen. Opas ENTER- ja TAB-päätteet viivakoodinlukijoissa kuvaa, miten päättäjät erotetaan. Vahvista asetus testattavassa lukijassa ja sovita sivu siihen työnkulkuun.

ENTER

Enter yksirivisessä tekstikentässä lähettää ympäröivän lomakkeen nykyisissä selaimissa. Käytä sitä, kun yhden skannauksen pitää vahvistaa arvo, kuten hakuruudussa. preventDefault() tapahtumassa submit estää selainta siirtymästä pois. Jätä se pois, kun koko sivun navigointi on haluttu toiminta.

Jos viivakoodi ilmestyy eikä lomake tee mitään, lukija ei ehkä lähetä päätettä. Viivakoodinlukijalta puuttuu ENTER käy tämän määrityksen läpi. Jotkin laitteet lähettävät NumPad Enterin. event.key on silti "Enter". Tarkista event.key, älä vain ehtoa event.code === "Enter", muuten lukija näyttää rikkoutuneelta.

TAB

Tab siirtää kohdistuksen seuraavaan kohdistettavaan kontrolliin. Se sopii järjestykseen, kuten tuotekoodi ja sitten määrä. Se yllättää lomakkeen, joka odotti Enterin lähettävän sen.

Lue arvo tapahtumassa keydown, kun kentällä on vielä kohdistus. Selain siirtää kohdistuksen tapahtuman jälkeen. Jätä oletustoiminto voimaan, kun seuraavan kontrollin pitää saada kohdistus. preventDefault() pitää kohdistuksen paikallaan, mikä on hyödyllistä, kun arvo on virheellinen ja käyttäjän pitää nähdä se. Ohita Shift+Tab, jotta näppäimistön käyttäjä voi liikkua lomakkeessa taaksepäin. Lukijan Tab-pääte on Tab ilman Shift-näppäintä.

Tab-pääte voi myös siirtää kohdistuksen ennen kuin koodi lukee kentän, jos kuuntelija on tapahtumassa blur tai change ja jokin muu tyhjentää kontrollin. Lue arvo keydown-tapahtuman kohteesta.

Ei päätettä

Ilman päätettä tietosisältö jää kenttään. Sovelluksen on päätettävä, milloin skannaus on valmis. Selkeä painike, käyttäjän myöhempi Enter tai siirtyminen seuraavaan vaiheeseen ovat luotettavia valmistumispisteitä. Toimettomuusaika voi tulkita kirjoitustauon skannauksen lopuksi. Ajastin on heuristiikka. Hidas lukija, Bluetooth-viive tai nopeasti kirjoittava henkilö voi osua kynnyksen väärälle puolelle. Suosi määritettyä päätettä, kun työnkulku tarvitsee selvän loppusignaalin.

Määrityserot

Saman merkin lukijat voivat tulla eri päätteillä, ja määritysviivakoodi voi vaihtaa päätteen ilman muutosta JavaScriptiin. Jotkin laitteet lähettävät etuliitteen, symbologiatunnisteen kuten ]C1 tai merkit CR ja LF. Testaa kolme päättäjäasetusta, jotka käyttäjät voivat todella valita: Enter, Tab ja ei mitään. Kirjaa, kumpaa käyttöön otetut lukijat käyttävät, ja testaa sivu sitä asetusta vasten.

Viivakoodinlukijan syötteen validointi

Validoi merkkijono, jonka kenttä vastaanotti. Älä oleta, että jokaisella viivakoodilla on sama pituus, merkistö tai tarkistusmerkki. Code 128- ja QR-tietosisällöt vaihtelevat. EAN-13 on 13 numeroa. Sovellus, joka tallentaa molemmat, tarvitsee säännöt molemmille.

Tyhjä syöte. Hylkää tai ohita se. Pääte ilman tietosisältöä tai Look up -napsautus tyhjässä kentässä ei saa luoda tietuetta.

Odottamattomat merkit. Vertaa vastaanotettua merkkijonoa tunnettuun etikettiin. Asetteluvirhe näkyy usein muuttuneena symbolina, kuten siirtyneenä numerona tai välimerkkinä, vaikka pituus pysyy samana. Ohjausmerkit voivat tulla etuliitteestä tai GS1-ryhmäerottimesta. Salli merkit, jotka muotosi määrittää. Yllä oleva esimerkki hylkää ASCII-ohjausmerkit, jotta ne jäävät näkyviin tilatekstiin. GS1-jäsennin, joka odottaa ryhmäerotinta, sallii sen merkin ja hylkää loput.

Pituus. Valvo pituuksia, jotka sovellus hyväksyy. Yleinen minimi ja maksimi on turvallisempi kuin yksi pakollinen pituus, kun lomake vastaanottaa useamman kuin yhden symbologian. Kentän maxlength katkaisee pidemmän tietosisällön äänettä, joten aseta se vain, kun jokainen hyväksytty koodi mahtuu.

Etuliite. Poista etuliite vain, kun lukija on asetettu lähettämään juuri se etuliite eikä sovellus tallenna sitä.

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

AIM-symbologiatunniste on dataa, jos lukija on asetettu lähettämään se. Jätä se paikalleen, kunnes olet päättänyt, tallentaako sovellus sen.

Pääte. Pidä päättäjä tallennetun arvon ulkopuolella. Enter ja Tab ovat näppäimiä. Niitä ei lisätä tavalliseen tekstikenttään. Sarjasisältö voi silti sisältää CR- tai LF-tavuja. Poista ne rajalla, jossa jäsennät sarjavirran, ja testaa, ettet poista niitä tietosisällön keskeltä, jos ne kuuluvat siihen.

Kaksoislähetykset. Yksi skannaus voidaan käsitellä kahdesti, jos sekä keydown että submit suoritetaan samalle Enterille. Käytä yhtä valmistumispolkua. Saman koodin toinen skannaus on eri kysymys. Varastolomake voi kasvattaa määrää. Lippulomake voi hylätä jo lunastetun koodin. Laita sääntö sovellukseen ja testaa se tarkoituksella. Selain ei erota toista liipaisinvetoa toisesta kuuntelijasta.

Sovellussäännöt. Tarkistusmerkit kuuluvat tiettyihin symbologioihin. EAN-13 käyttää viimeistä numeroa tarkistusnumerona. Tämä funktio hyväksyy vain sen muodon:

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 ja QR eivät käytä tätä laskentaa. Lukija on voinut jo tarkistaa oman symbologiansa ja lähettää ihmisen luettavan datan. Validoi tallentamasi muodot ja toista tarkistus palvelimella. Lähetetty merkkijono on tavallista käyttäjän syötettä. Selain ei voi todistaa, että lukija tuotti sen.

Viivakoodisyötteen testaaminen ilman fyysistä laitteistoa

Barcode Scanner Emulator on työpöytäsovellus Windowsille, macOS:lle ja Linuxille. Syötät lähetettävän tekstin, valitset kirjoitusviiveen ja valitset päätteeksi ei mitään, ENTER tai TAB. Yleinen pikanäppäin kirjoittaa tekstin kohdistettuun sovellukseen. Se toistaa näppäimistöpolun, jota kiilalukija käyttää. Se ei valaise etikettiä, lue symbolia eikä pura symbologiaa.

Käytä yllä olevaa esimerkkisivua tai sivua, jota rakennat:

  1. Avaa sivu työpöytäselaimessa ja napsauta viivakoodikenttää.
  2. Kirjoita emulaattoriin tunnettu arvo, esimerkiksi 123456789012.
  3. Aseta päätteeksi ENTER. Aseta kirjoitusviive, jos haluat purskeen muistuttavan lukijaa, jonka olet jo mitannut.
  4. Paina emulaattorin yleistä skannauspikanäppäintä, kun selainkentällä on yhä kohdistus.
  5. Vahvista tilateksti ja että arvo hyväksyttiin kerran.
  6. Toista TAB-päätteellä. Kohdistuksen pitää siirtyä, ja arvo pitää hyväksyä kerran.
  7. Toista ilman päätettä. Tekstin pitää jäädä kenttään, kunnes aktivoit Look up -painikkeen.
  8. Käytä viivakoodisyötteen testaajaa ja lähetä sama arvo uudelleen. Vertaa kaapattua merkkijonoa, etuliitettä ja päätettä siihen, mitä sovellus tallensi.

Asennus ja ensimmäinen pikanäppäin ovat oppaassa Aloitus. Asetusmuutoksen jälkeen lähetä yksi skannaus syötteen testaajaan, ennen kuin luotat tulokseen sovelluksessa.

Laitteistoa tarvitaan yhä testin optisiin ja laitekohtaisiin osiin:

  • Pystyykö juuri tämä lukija purkamaan painetun tai näytetyn symbolin, mukaan lukien vaurioituneet etiketit, koko, kontrasti ja etäisyys.
  • Symbologian tuki. 1D-laserlukija ei voi lukea QR-koodia. Katso QR-koodin testaus: miten QR-lukijoita testataan.
  • USB-luettelointi, Bluetooth-paritus sekä lukijan oma näppäimistöasettelu ja päätemääritys.
  • Sarja-, HID POS- ja valmistajan SDK -integraatiot.

Emulaattori on oikea työkalu sovelluslogiikkaan näppäimistöpolulla. Se on väärä työkalu todistamaan, että tietty lukija lukee tietyn etiketin.

Viivakoodinlukijan näppäimistötapahtumien vianmääritys

Katso tapahtumia tässä järjestyksessä, kun tallennettu arvo on väärä.

keydown. Laukeaa jokaiselle näppäimelle, myös Enterille ja Tabille, ennen kuin selain lisää merkin tai siirtää kohdistuksen. Lue päättäjä tässä. event.repeat on true, kun näppäintä pidetään pohjassa. Kiilalukija lähettää tavallisesti erillisen painalluksen kullekin merkille.

input. Laukeaa kentässä, kun tulostettava merkki on muuttanut sen arvoa. Se on oikea tapahtuma seurattavaksi, jos tarvitset tekstin sen kasvaessa. Se ei laukea Enterille tai Tabille, koska nämä näppäimet eivät lisää merkkiä tekstikenttään.

change. Laukeaa arvon vahvistuttua, tyypillisesti kun kenttä menettää kohdistuksen. Lukija, joka jättää kohdistuksen samaan kenttään, ei tuota change-tapahtumaa skannauksen lopussa. Älä käytä change-tapahtumaa ainoana valmistumissignaalina.

event.key ja event.code. Kirjaa molemmat, kun merkki on väärä. Lukijan asettelun ja käyttöjärjestelmän asettelun ero muuttaa event.key-arvoa ja jättää event.code-arvon lukijan tarkoittaman näppäimen näköiseksi. Numeronäppäimistön numerot käyttävät koodeja kuten Numpad1. Jotkin syötemaskit käsittelevät niitä eri tavalla kuin Digit1. Viivakoodinlukijan väärä näppäimistöasettelu selittää asetteluvirheen.

Kohdistus. Kirjaa document.activeElement heti ennen skannausta. Jos se ei ole viivakoodikenttä, jäljen loppu selittää väärää kontrollia. Iframeilla on oma kohdistus. Skannaus upotettuun kehykseen näkyy kehyksen sisäiselle skriptille.

Ajoitus. Lukijat päättävät lyhyen tietosisällön usein reilusti alle sekunnissa. Syötteen testaaja vertaa merkkien keskimääräistä väliä 100 ms:n kynnykseen ja merkitsee tuloksen ajoitukseksi, ei laitteiston tunnistukseksi. Välikynnys voi pitää nopeaa kirjoittajaa, automaattitäyttöä tai emulaattoria lukijana. Lukija, jolla on merkkien välinen viive, Bluetooth-yhteys tai pitkä tietosisältö, voi näyttää kirjoitukselta. Käytä kaapattua arvoa ja päätettä. Käytä 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. Käytä sitä, kun koottu merkkijono kätkee etuliitenäppäimen tai numeronäppäinkoodin. Loki on selaimen tapahtumia. Se ei ole raakaa USB-liikennettä.

Yleisiä ongelmia verkkosovelluksissa

Skannaus menee väärään kenttään. Kiilasyöte seuraa kohdistusta. Napsauta kohdekenttää jokaisen siirtymän, valintaikkunan tai validointiviestin jälkeen, joka siirtää kohdistusta. Tekstikentätön modaali voi niellä skannauksen pikanäppäiminä.

Lukija toimii tekstieditorissa mutta ei selaimessa. Laite kirjoittaa. Sivu ei hyväksy näitä näppäimiä. Tarkista kohdistus, poistettu käytöstä tai vain luku -kenttä ja keydown-kuuntelija, joka kutsuu preventDefault()-metodia tulostettaville näppäimille. Kuuntelija, joka käsittelee vain paste-tapahtumaa, ei näe kiilasyötettä. Aloita oppaasta Viivakoodinlukija ei toimi, jos mikään sovellus ei vastaanota merkkejä.

Enter lähettää lomakkeen kahdesti tai siirtyy pois. Selain lähettää lomakkeen, ja kuuntelijasi käsittelee myös Enterin. Kutsu preventDefault() toisella poluista ja käsittele arvo kerran. Monikenttäinen lomake voi lähteä ennen myöhempien kenttien täyttöä, kun lukija lähettää Enterin. Käytä Tabia tässä työnkulussa tai estä lähetys, kunnes lomake on valmis.

Tab vaihtaa kohdistusta. Se on Tab-näppäin. Joko aseta Enter lukijaan tai lue arvo tapahtumassa keydown ja salli kohdistuksen siirto. Katso yllä oleva pääteosio.

Näppäimistöasettelu on väärä. Numerot voivat säilyä virheessä, joka muuttaa välimerkkejä. Skannaa tunnettu arvo, joka sisältää tallentamasi symbolit, työaseman todellisella asettelulla.

Sama skannaus luo kaksi tietuetta. Etsi kaksi kuuntelijaa yhdelle Enterille ennen kuin etsit kahta fyysistä skannausta. Testaa sitten tarkoituksellinen toinen skannaus ja vahvista määrä- tai kaksoissääntö, jonka sovellus dokumentoi.

Arvo puuttuu tai on katkennut. Attribuutti maxlength, syötemaski tai preventDefault() merkkinäppäimille voi pudottaa tai katkaista tietosisällön. Vertaa merkkimäärää syötteen testaajassa kenttäsi arvoon. Etuliite voi myös saada oikean tietosisällön näyttämään liian pitkältä.

QR-koodeja ei koskaan tule. Lukija voi olla vain 1D, tai QR-symbologia voi olla pois käytöstä. Sovellus ei voi korjata sitä. Vahvista laitteisto oppaalla QR-koodin testaus: miten QR-lukijoita testataan ja palaa sitten kenttätestiin.

Verkkosovelluksen testauksen tarkistuslista

Käytä tätä julkaistavaksi aiotussa koontiversiossa jokaisessa tukemassasi selaimessa. Tarkista sekä uusi profiili että profiili, jossa on salasananhallinta- ja automaattitäyttölaajennuksia, koska ne siirtävät kohdistusta.

  • Lukija on kytketty tai paritettu, ja isäntä näyttää sen valmiiksi.
  • Lukija on näppäimistökiilatilassa, ei sarjatilassa eikä valmistajan SDK -tilassa.
  • Viivakoodikenttä on kohdistettuna heti ennen skannausta. document.activeElement on tuo kenttä.
  • Tunnettu viivakoodi saapuu merkki merkiltä, pituus mukaan lukien.
  • ENTER-pääte lähettää tai hyväksyy arvon kerran eikä jätä päättäjää tallennettuun merkkijonoon.
  • TAB-pääte siirtää kohdistuksen tarkoitettuun kontrolliin, ja arvo luetaan ennen siirtoa.
  • Määritys ilman päätettä jättää arvon saataville, kunnes sovellus täydentää sen.
  • Tyhjä lähetys hylätään tai ohitetaan.
  • Yksi skannaus ei luo kahta tietuetta. Toinen oikea skannaus noudattaa sovelluksen kaksoissääntöä.
  • Välimerkit, symbolit ja muotojesi käyttämä GS1-erotin säilyvät edestakaisella matkalla.
  • Lukijan näppäimistöasettelu ja käyttöjärjestelmän asettelu tuottavat etikettiin painetut merkit.
  • Irrotuksen ja uudelleenkytkennän jälkeen tai Bluetooth-yhteyden katkettua seuraava skannaus yhä tavoittaa kentän.
  • Useat peräkkäiset skannaukset pysyvät erillisinä arvoina. Kenttä ei liitä niitä yhteen.
  • Samat tarkistukset onnistuvat tukemissasi selaimissa, yleisten automaattitäyttölaajennusten kanssa ja ilman niitä.

Valintaikkunoita, sarkainjärjestystä koko kassalla ja POS-määrävirtoja varten jatka oppaalla Miten viivakoodinlukijan syöte testataan.

Testitapausten matriisi

Lukijasarake on se, mitä laite ja selain tekevät. Odotetun toiminnan sarake on se, mitä sovelluksen pitää tehdä vastauksena. Liiketoimintasäännöt, kuten kasvattaako toistettu tuotekoodi määrää, kuuluvat sovellukselle. Kirjaa ne testiin sen sijaan, että oletat yhden säännön jokaiselle tuotteelle.

Skenaario Odotettu toiminta
Kelvollinen viivakoodi Sovellus hyväksyy arvon ja tallentaa tietosisällön ilman päättäjää.
Tyhjä syöte Sovellus hylkää tai ohittaa sen eikä luo tietuetta.
ENTER-pääte Sovellus lähettää tai hyväksyy arvon kerran.
TAB-pääte Kohdistus siirtyy tarkoitettuun seuraavaan kontrolliin, ja arvo säilytetään.
Ei päätettä Syöte pysyy saatavilla, kunnes sovellus käsittelee sen.
Nopeat peräkkäiset skannaukset Jokainen arvo käsitellään erikseen eikä liitetä edelliseen.
Väärä näppäimistöasettelu Odottamattomat merkit näkyvät kaapatussa arvossa, ja validointi epäonnistuu.
Kaksoisskannaus Sovellus noudattaa omaa kaksoissääntöään, kuten määrän kasvattamista tai uusinnan hylkäämistä.
Virheellinen viivakoodimuoto Sovellus näyttää kyseisen muodon validointivirheen eikä tallenna arvoa.
Kadonnut syötekohdistus Sovellus ei keksi viivakoodia. Skannaus puuttuu tai päätyy kohdistettuun kontrolliin, ja sivu pysyy turvallisessa tilassa.

Aja kelvollisen, tyhjän, ENTER-, TAB- ja päätettömän rivit fyysisellä lukijalla ja uudelleen emulaattorilla. Aja näppäimistöasettelun, QR:n ja uudelleenkytkennän rivit laitteistolla. Nämä rivit riippuvat laitteesta, etiketistä tai käyttöjärjestelmän asettelusta, eikä simuloidut näppäilyt toista niitä.