Zum Inhalt springen

Barcode Scanner Emulator

So testen Sie Barcodescanner in Webanwendungen

Viele USB- und Bluetooth-Barcodescanner senden dekodierte Daten als Tastatureingabe, sodass ein fokussiertes Feld in einer Webanwendung einen Scan ohne scannerbezogene Browser-API empfangen kann. Serielle Ports und Hersteller-SDKs sind eigene Integrationen. Den Tastaturpfad können Sie mit einem physischen Scanner oder mit simulierten Tastenanschlägen testen.

Eine Webanwendung sieht einen Barcodescanner meist als Tastatur. Der Test prüft, ob das fokussierte Steuerelement die Nutzlast erhält, die Ihre Anwendung erwartet, und ob die Seite das Abschlusszeichen verarbeitet, das der Scanner senden soll. Dieses Abschlusszeichen kann Enter, Tab oder nichts sein.

Nutzen Sie eine Sitzung im Barcode-Eingabetester, wenn ein physischer Scanner angeschlossen ist. Nutzen Sie den Barcode Scanner Emulator, wenn Sie denselben Tastaturpfad während der Entwicklung brauchen und die Hardware nicht auf dem Tisch liegt. Ein breiterer Durchgang zu Fokus, Layout und POS-Abläufen steht in So testen Sie die Eingabe eines Barcodescanners. Dieser Leitfaden bleibt bei der Browseranwendung: Erfassung, Suffixe, Validierung und die Ereignisse, die Sie tatsächlich beobachten können.

Wie Barcodescanner mit Webanwendungen kommunizieren

Der Schnittstellenmodus entscheidet, was die Seite empfangen kann. Bestätigen Sie ihn, bevor Sie Formularcode ändern. Ein Scanner kann den Modus oft wechseln, indem Sie einen Konfigurationsbarcode aus dem Handbuch des Herstellers scannen.

USB-HID-Tastatur-Wedge

Im USB-HID-Tastaturmodus meldet sich der Scanner als Tastatur. Das Betriebssystem lädt seinen normalen Tastaturtreiber. Nachdem der Scanner ein Symbol dekodiert hat, sendet er die Zeichen als Tastenanschläge an das Steuerelement, das den Tastaturfokus hat. Die Seite hört auf diese Tastenanschläge oder liest den Text, den sie einfügen. Sie öffnet keine Verbindung zum Gerät.

Deshalb kann ein Kassenfeld, ein Suchfeld oder ein anderes Texteingabefeld einen Scan mit gewöhnlichem HTML annehmen. Der Leitfaden HID-Tastatur-Wedge beschreibt die Tastenfolge, Präfixe und Suffixe genauer.

Bluetooth-HID

Ein als Tastatur gekoppelter Bluetooth-Scanner nutzt denselben Anwendungspfad. Der Host behandelt ihn als HID-Tastatur, und das fokussierte Feld empfängt Tastenanschläge. Kopplung, Akku und Funk sind Gerätefragen. Sobald die Zeichen den Browser erreichen, verarbeitet die Seite sie genauso wie USB-Wedge-Eingaben.

Serieller Port und virtueller COM-Port

Ein serieller Scanner, einschließlich vieler USB-Modi mit virtuellem COM-Port, sendet den dekodierten Text als Bytes auf einem Port. Der Fokus wählt das Ziel nicht. Der Prozess, der den Port öffnet, tut das. Ein Textfeld, das nur auf Tastenanschläge hört, sieht diesen Strom nicht.

Chromium-basierte Browser können einen seriellen Port über die Web Serial API öffnen, nachdem die Nutzerin oder der Nutzer den Port auswählt und die Berechtigung erteilt. Firefox und Safari stellen diese API nicht bereit. Ein Wedge-Test übt keine serielle Integration, und ein serieller Test sagt nicht, was ein Wedge-Scanner tippt.

Herstellerspezifische Schnittstellen

Manche Geräte nutzen ein Hersteller-SDK, OPOS, JPOS oder eine Nicht-Tastatur-HID-Schnittstelle wie USB HID POS. Diese Schnittstellen tippen nicht in das fokussierte Feld. Eine normale Webseite kann kein natives SDK laden. Chromium kann nach einer Nutzergeste einige HID-Geräte anfordern, die keine Tastaturen sind, über WebHID. HID-Geräte der Tastaturklasse bleiben gesperrt, sodass ein Wedge-Scanner von einer Tastatur nicht zu unterscheiden bleibt. Behandeln Sie eine Herstellerschnittstelle als eigene Integration und testen Sie sie mit der Software, die diese Schnittstelle tatsächlich öffnet.

Was der Browser sehen kann

Ein Wedge-Scan kommt als Ereignisse keydown und keyup an, und druckbare Zeichen aktualisieren das fokussierte Feld. Der Browser erhält keinen Gerätenamen, keine USB-Seriennummer und kein Kennzeichen, das einen Scanner meldet. Browser, die WebHID implementieren, lehnen Tastaturschnittstellen weiterhin ab, sodass Seitenskript auch die rohen HID-Reports eines Wedge-Scanners nicht lesen kann.

event.key ist das Zeichen oder der Tastenname, nachdem das Betriebssystem das aktive Tastaturlayout angewendet hat. event.code benennt die physische Taste, etwa Digit1 oder Numpad1, und kann gleich bleiben, wenn ein Layoutunterschied event.key ändert. Keine der beiden Eigenschaften identifiziert die Hardware.

So testen Sie einen physischen Barcodescanner im Browser

Führen Sie das aus, bevor Sie Anwendungscode untersuchen. Es zeigt die genaue Zeichenfolge und das Abschlusszeichen, die der Browser empfangen hat.

  1. Schließen Sie den Scanner an und warten Sie, bis er anzeigt, dass er Strom hat. Bei Bluetooth schließen Sie die Kopplung ab und bestätigen Sie, dass der Host ein Tastaturprofil verwendet.
  2. Bestätigen Sie den Eingabemodus. Keyboard-Wedge, USB-HID-Tastatur oder Bluetooth-HID-Tastatur können in ein Feld tippen. Seriell, SPP und Hersteller-SDK-Modi tun das nicht.
  3. Öffnen Sie den Barcode-Eingabetester.
  4. Klicken Sie auf Test starten oder auf den Scanbereich. Er wird blau, wenn er bereit ist. Die Seite nimmt den Fokus nicht von selbst.
  5. Scannen Sie einen Barcode, dessen Nutzlast Sie bereits kennen. Beginnen Sie mit einem kurzen Zahlenwert und scannen Sie danach einen Wert, der die Satzzeichen enthält, die Ihre Anwendung speichert.
  6. Lesen Sie den erfassten Wert und die Zeichenanzahl. Vergleichen Sie beides mit der erwarteten Nutzlast, einschließlich eines Präfixes, das der Scanner vor den Daten einfügt.
  7. Prüfen Sie das Suffix. Der Tester meldet ENTER, TAB oder Keins. Ist Automatische Erfassung eingeschaltet, erscheint das Ergebnis nach Enter, Tab oder einer kurzen Pause, sobald die Tasten aufhören. Schalten Sie Automatische Erfassung aus, wenn die Erfassung gehalten werden soll, bis Sie auf Stopp drücken.
  8. Vergleichen Sie dieses Ergebnis mit der Zeichenfolge, die Ihre Anwendung speichern soll. Ein Präfix, ein ersetztes Zeichen oder ein fehlendes Abschlusszeichen sollte in der Scannerkonfiguration behoben oder in der Seite bewusst behandelt werden. Behandeln Sie es erst als Dekodierfehler, wenn dieser Vergleich erledigt ist.

Der Tester zeichnet Tastaturereignisse auf, die der Browser sehen kann. Er kann das USB-Gerät nicht identifizieren und keinen seriellen Port lesen. Wenn ein Texteditor den Scan empfängt und der Browser nicht, fahren Sie fort mit Scanner funktioniert im Notepad, aber nicht im POS.

Barcodescannereingabe mit JavaScript erfassen

Ein Scanner tippt in das Element, das den Fokus hat. Geben Sie dem Feld eine sichtbare Beschriftung, lassen Sie es ein normales Texteingabefeld, damit Tastaturnutzer einen Code tippen können, und lesen Sie den Wert, wenn der Ablauf sagt, dass die Eingabe vollständig ist. Die Seite unten tut das. Enter sendet das Formular einmal ab. Tab schließt einen nicht leeren Wert ab und lässt den Browser danach den Fokus verschieben. Ein Scan ohne Abschlusszeichen bleibt im Feld, bis jemand Look up auslöst.

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

Speichern Sie diese Datei und öffnen Sie sie in einem Desktop-Browser. Klicken Sie auf das Feld, wenn der Fokus gewandert ist. Ein Wedge-Scanner oder der Emulator im nächsten Abschnitt tippt dann in #barcode.

Fokus ist erforderlich. Wenn document.activeElement der Dokumentkörper, eine Schaltfläche oder ein anderes Eingabefeld ist, sehen die Listener dieses Feldes den Scan nicht. Die Zeichen landen im fokussierten Steuerelement oder gehen verloren. Rufen Sie field.focus() auf, wenn der Ablauf für einen Scan bereit ist, auch nachdem ein Dialog geschlossen wurde.

Leere Eingabe wird ignoriert. Das Formular bleibt an Ort und Stelle, und der Statustext sagt, dass nichts empfangen wurde. Nur Leerraum ist nach trim() leer.

Das Beispiel fügt Enter oder Tab nicht hinzu. Wenn der Scanner nicht so konfiguriert ist, sie zu senden, bleibt der Wert im Feld, und Look up ist der Abschlussweg. autocomplete="off" verringert die Chance, dass ein gespeicherter Wert den Scan ersetzt. Beschriftung, Schaltfläche und Shift+Tab bleiben verfügbar, sodass eine Person einen Code ohne Scanner eingeben kann.

Behandeln Sie Enter an einer Stelle. Dieses Beispiel nutzt das Formularereignis submit, das auch die Schaltfläche Look up und ein Enter von der Tastatur abdeckt. Ein zweiter keydown-Listener für Enter würde denselben Scan zweimal erfassen. Wenn die Eingabe nicht in einem Formular liegt, hören Sie auf Enter bei keydown und rufen Sie preventDefault() auf, damit ein übergeordnetes Formular nicht ebenfalls absendet:

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

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

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

Leeren Sie das Feld nach einer erfolgreichen Annahme, damit der nächste Scan nicht an die vorherige Nutzlast angehängt wird. Nach Enter fokussiert das Beispiel dasselbe Feld erneut, weil dieser Ablauf einen weiteren Scan in demselben Feld erwartet. Nach Tab lässt es den Fokus in Ruhe, damit der Browser zum nächsten Steuerelement wechseln kann.

Suffixe ENTER und TAB behandeln

Ein Suffix ist eine Taste, die der Scanner nach der Nutzlast senden kann. Es ist eine Geräteeinstellung. Enter ist üblich und optional. Der Leitfaden Suffixe ENTER und TAB bei Barcodescannern beschreibt, wie Sie die Abschlusszeichen unterscheiden. Bestätigen Sie die Einstellung an dem Scanner, den Sie testen, und richten Sie die Seite auf diesen Ablauf aus.

ENTER

Enter in einem einzeiligen Textfeld sendet in aktuellen Browsern das umgebende Formular ab. Nutzen Sie das, wenn ein Scan den Wert festschreiben soll, etwa in einem Suchfeld. preventDefault() auf dem Ereignis submit hält den Browser davon ab, die Seite zu verlassen. Lassen Sie es weg, wenn eine vollständige Seitennavigation das gewünschte Verhalten ist.

Wenn der Barcode erscheint und das Formular nichts tut, sendet der Scanner möglicherweise kein Suffix. Barcodescanner sendet kein ENTER geht diese Konfiguration durch. Manche Geräte senden NumPad Enter. event.key ist weiterhin "Enter". Prüfen Sie event.key, nicht nur event.code === "Enter", sonst wirkt dieser Scanner defekt.

TAB

Tab verschiebt den Fokus auf das nächste fokussierbare Steuerelement. Das passt zu einer Folge wie Produktcode, dann Menge. Es überrascht ein Formular, das erwartet hat, dass Enter absendet.

Lesen Sie den Wert in keydown, solange das Feld noch den Fokus hat. Der Browser verschiebt den Fokus nach diesem Ereignis. Lassen Sie die Standardaktion bestehen, wenn das nächste Steuerelement den Fokus erhalten soll. preventDefault() hält den Fokus, wo er ist. Das ist nützlich, wenn der Wert ungültig ist und die bedienende Person ihn sehen soll. Ignorieren Sie Shift+Tab, damit eine Tastaturnutzerin oder ein Tastaturnutzer im Formular rückwärts gehen kann. Ein Tab-Suffix des Scanners ist Tab ohne Shift.

Ein Tab-Suffix kann den Fokus auch verschieben, bevor Ihr Code das Feld liest, wenn der Listener auf blur oder change liegt und etwas anderes das Steuerelement leert. Lesen Sie den Wert vom target des Ereignisses keydown.

Kein Suffix

Ohne Suffix bleibt die Nutzlast im Feld. Die Anwendung muss entscheiden, wann der Scan fertig ist. Eine ausdrückliche Schaltfläche, ein späteres Enter von der bedienenden Person oder der Wechsel zu einem anderen Schritt sind zuverlässige Abschlusspunkte. Ein Inaktivitätszeitgeber kann eine Pause beim Tippen als Ende eines Scans werten. Dieser Zeitgeber ist eine Heuristik. Ein langsamer Scanner, eine Bluetooth-Verzögerung oder eine Person, die schnell tippt, kann auf der falschen Seite der Schwelle landen. Bevorzugen Sie ein konfiguriertes Suffix, wenn der Ablauf ein hartes Ende-des-Scans-Signal braucht.

Konfigurationsunterschiede

Scanner derselben Marke können mit unterschiedlichen Suffixen ausgeliefert werden, und ein Konfigurationsbarcode kann das Suffix ändern, ohne dass sich Ihr JavaScript ändert. Manche Geräte senden ein Präfix, eine Symbologiekennung wie ]C1 oder CR und LF. Testen Sie die drei Abschlusszeichen, die Ihre Nutzerinnen und Nutzer tatsächlich wählen können: Enter, Tab und keines. Halten Sie fest, welches die eingesetzten Scanner verwenden, und testen Sie die Seite gegen diese Einstellung.

Validierung der Barcodescannereingabe

Validieren Sie die Zeichenfolge, die das Feld empfangen hat. Gehen Sie nicht davon aus, dass jeder Barcode dieselbe Länge, denselben Zeichensatz oder dieselbe Prüfsumme hat. Nutzlasten von Code 128 und QR variieren. EAN-13 hat 13 Ziffern. Eine Anwendung, die beides speichert, braucht Regeln für beides.

Leere Eingabe. Lehnen Sie sie ab oder ignorieren Sie sie. Ein Suffix ohne Nutzlast oder ein Klick auf Look up in einem leeren Feld soll keinen Datensatz erzeugen.

Unerwartete Zeichen. Vergleichen Sie die empfangene Zeichenfolge mit einem bekannten Etikett. Ein Layoutunterschied zeigt sich oft als geändertes Symbol, etwa eine verschobene Ziffer oder Satzzeichen, während die Länge gleich bleibt. Steuerzeichen können von einem Präfix oder von einem GS1-Gruppentrenner stammen. Erlauben Sie die Zeichen, die Ihr Format definiert. Das Beispiel oben lehnt ASCII-Steuerzeichen ab, damit sie im Statustext sichtbar bleiben. Ein GS1-Parser, der einen Gruppentrenner erwartet, soll dieses Zeichen erlauben und den Rest ablehnen.

Länge. Erzwingen Sie die Längen, die Ihre Anwendung akzeptiert. Ein globales Minimum und Maximum ist sicherer als eine einzige geforderte Länge, wenn das Formular mehr als eine Symbologie empfängt. maxlength am Eingabefeld schneidet eine längere Nutzlast stillschweigend ab. Setzen Sie es nur, wenn jeder akzeptierte Code hineinpasst.

Präfix. Entfernen Sie ein Präfix nur, wenn Sie den Scanner so konfiguriert haben, genau dieses Präfix zu senden, und die Anwendung es nicht speichert.

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

Eine AIM-Symbologiekennung ist Daten, wenn der Scanner sie übertragen soll. Lassen Sie sie stehen, bis Sie entschieden haben, ob die Anwendung sie speichert.

Suffix. Halten Sie das Abschlusszeichen aus dem gespeicherten Wert heraus. Enter und Tab sind Tasten. Sie werden nicht in ein normales Texteingabefeld eingefügt. Eine serielle Nutzlast kann weiterhin die Bytes CR oder LF enthalten. Entfernen Sie sie an der Grenze, an der Sie den seriellen Strom auswerten, und testen Sie, dass Sie sie nicht aus der Mitte einer Nutzlast entfernen, die sie zulässigerweise enthält.

Doppelte Übermittlungen. Ein Scan kann zweimal verarbeitet werden, wenn sowohl keydown als auch submit für dasselbe Enter laufen. Nutzen Sie einen einzigen Abschlussweg. Ein zweiter Scan desselben Codes ist eine andere Frage. Ein Lagerformular kann die Menge erhöhen. Ein Ticketformular kann einen Code ablehnen, der bereits eingelöst wurde. Legen Sie diese Regel in die Anwendung und testen Sie sie absichtlich. Der Browser kann einen zweiten Auslöserzug nicht von einem zweiten Listener unterscheiden.

Anwendungsregeln. Prüfsummen gehören zu bestimmten Symbologien. EAN-13 nutzt die letzte Ziffer als Prüfziffer. Diese Funktion akzeptiert nur dieses Format:

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 und QR nutzen diese Berechnung nicht. Der Scanner kann seine eigene Symbologie bereits geprüft und die menschenlesbaren Daten übertragen haben. Validieren Sie die Formate, die Sie speichern, und wiederholen Sie die Prüfung auf dem Server. Die gesendete Zeichenfolge ist gewöhnliche Nutzereingabe. Der Browser kann nicht beweisen, dass ein Scanner sie erzeugt hat.

Barcodescannereingabe ohne physische Hardware testen

Der Barcode Scanner Emulator ist eine Desktop-App für Windows, macOS und Linux. Sie geben den zu sendenden Text ein, wählen eine Tippverzögerung und ein Suffix von keinem, ENTER oder TAB. Ein globales Kürzel tippt diesen Text in die fokussierte Anwendung. Er bildet den Tastaturpfad nach, den ein Wedge-Scanner nutzt. Er beleuchtet kein Etikett, liest kein Symbol und dekodiert keine Symbologie.

Nutzen Sie die Beispielseite oben oder die Seite, die Sie bauen:

  1. Öffnen Sie die Seite in einem Desktop-Browser und klicken Sie auf das Barcodefeld.
  2. Geben Sie im Emulator einen bekannten Wert ein, etwa 123456789012.
  3. Setzen Sie das Suffix auf ENTER. Setzen Sie die Tippverzögerung, wenn der Stoß einem Scanner ähneln soll, den Sie bereits gemessen haben.
  4. Drücken Sie das globale Scan-Kürzel des Emulators, während das Browserfeld noch den Fokus hat.
  5. Bestätigen Sie den Statustext und dass der Wert einmal angenommen wurde.
  6. Wiederholen Sie es mit TAB. Der Fokus soll wandern, und der Wert soll einmal angenommen werden.
  7. Wiederholen Sie es ohne Suffix. Der Text soll im Feld bleiben, bis Sie Look up auslösen.
  8. Fokussieren Sie den Barcode-Eingabetester und senden Sie denselben Wert erneut. Vergleichen Sie die erfasste Zeichenfolge, das Präfix und das Suffix mit dem, was die Anwendung gespeichert hat.

Installation und das erste Kürzel stehen in Erste Schritte. Senden Sie nach einer Einstellungsänderung einen Scan in den Eingabetester, bevor Sie dem Ergebnis in der Anwendung vertrauen.

Für die optischen und gerätespezifischen Teile des Tests bleibt Hardware erforderlich:

  • Ob dieser Scanner das gedruckte oder angezeigte Symbol dekodieren kann, einschließlich beschädigter Etiketten, Größe, Kontrast und Abstand.
  • Symbologieunterstützung. Ein 1D-Laserscanner kann keinen QR-Code lesen. Siehe QR-Code-Tests: So testen Sie QR-Code-Scanner.
  • USB-Anmeldung, Bluetooth-Kopplung sowie die eigene Tastaturlayout- und Suffixkonfiguration des Scanners.
  • Integrationen über seriell, HID POS und Hersteller-SDK.

Der Emulator ist das richtige Werkzeug für Anwendungslogik entlang des Tastaturpfads. Er ist das falsche Werkzeug, um zu beweisen, dass ein bestimmter Scanner ein bestimmtes Etikett liest.

Tastaturereignisse eines Barcodescanners untersuchen

Beobachten Sie die Ereignisse in dieser Reihenfolge, wenn der gespeicherte Wert falsch ist.

keydown. Feuert für jede Taste, einschließlich Enter und Tab, bevor der Browser ein Zeichen einfügt oder den Fokus verschiebt. Lesen Sie das Abschlusszeichen hier. event.repeat ist wahr, wenn eine Taste gehalten wird. Ein Wedge-Scanner sendet normalerweise für jedes Zeichen einen eigenen Druck.

input. Feuert auf dem Feld, nachdem ein druckbares Zeichen seinen Wert geändert hat. Es ist das richtige Ereignis, wenn Sie den Text beim Wachsen beobachten müssen. Es feuert nicht für Enter oder Tab, weil diese Tasten kein Zeichen in ein Texteingabefeld einfügen.

change. Feuert, nachdem der Wert festgeschrieben wird, typischerweise wenn das Feld den Fokus verliert. Ein Scanner, der den Fokus im selben Feld lässt, erzeugt am Ende des Scans kein change. Nutzen Sie change nicht als einziges Abschlusssignal.

event.key und event.code. Protokollieren Sie beide, wenn ein Zeichen falsch ist. Ein Unterschied zwischen Scannerlayout und Betriebssystemlayout ändert event.key und lässt event.code wie die Taste aussehen, die der Scanner meinte. Ziffern vom Ziffernblock nutzen Numpad1 und ähnliche Codes. Manche Eingabemasken behandeln diese anders als Digit1. Falsches Tastaturlayout am Barcodescanner erklärt den Layoutunterschied.

Fokus. Protokollieren Sie document.activeElement unmittelbar vor einem Scan. Wenn es nicht das Barcodefeld ist, erklärt der Rest der Spur das falsche Steuerelement. Iframes haben ihren eigenen Fokus. Ein Scan in einen eingebetteten Frame ist für Skript in diesem Frame sichtbar.

Timing. Scanner beenden eine kurze Nutzlast oft deutlich unter einer Sekunde. Der Eingabetester vergleicht den mittleren Abstand zwischen Zeichen mit einer Schwelle von 100 ms und kennzeichnet das Ergebnis als Timing, nicht als Hardware-Erkennung. Eine Abstandsschwelle kann eine schnell tippende Person, Autofill oder den Emulator als Scanner behandeln. Ein Scanner mit Zeichenverzögerung, eine Bluetooth-Verbindung oder eine lange Nutzlast kann wie Tippen aussehen. Nutzen Sie den erfassten Wert und das Suffix. Nutzen Sie das Timing als Hinweis.

Der Tastaturereignis-Tester listet jedes keydown und keyup mit key, code, Modifikatoren und Zeitstempeln. Nutzen Sie ihn, wenn die zusammengesetzte Zeichenfolge eine Präfixtaste oder einen Numpad-Code verbirgt. Das Protokoll sind Browserereignisse. Es ist kein roher USB-Verkehr.

Häufige Probleme in Webanwendungen

Der Scan geht ins falsche Feld. Wedge-Eingabe folgt dem Fokus. Klicken Sie nach jeder Navigation, jedem Dialog oder jeder Validierungsmeldung, die den Fokus verschiebt, auf das Zielfeld. Ein Modal ohne Textfeld kann den Scan als Tastenkürzel verschlucken.

Der Scanner funktioniert in einem Texteditor und nicht im Browser. Das Gerät tippt. Die Seite nimmt diese Tasten nicht an. Prüfen Sie den Fokus, ein deaktiviertes oder schreibgeschütztes Eingabefeld und einen keydown-Listener, der bei druckbaren Tasten preventDefault() aufruft. Ein Listener, der nur paste behandelt, sieht Wedge-Eingabe nie. Beginnen Sie mit Barcodescanner funktioniert nicht, wenn keine Anwendung Zeichen empfängt.

Enter sendet das Formular zweimal ab oder navigiert weg. Der Browser sendet das Formular ab, und Ihr Listener behandelt ebenfalls Enter. Rufen Sie preventDefault() auf einem dieser Wege auf und verarbeiten Sie den Wert einmal. Ein Formular mit mehreren Feldern kann absenden, bevor spätere Felder gefüllt sind, wenn der Scanner Enter sendet. Nutzen Sie Tab für diesen Ablauf oder verhindern Sie das Absenden, bis das Formular vollständig ist.

Tab ändert den Fokus. Das ist die Taste Tab. Konfigurieren Sie entweder Enter am Scanner oder lesen Sie den Wert in keydown und erlauben Sie die Fokusverschiebung. Siehe den Suffixabschnitt oben.

Das Tastaturlayout ist falsch. Ziffern können einen Unterschied überstehen, der Satzzeichen ändert. Scannen Sie einen bekannten Wert, der die Symbole enthält, die Sie speichern, auf dem Layout, das der Arbeitsplatz tatsächlich nutzt.

Derselbe Scan erzeugt zwei Datensätze. Suchen Sie zwei Listener auf einem Enter, bevor Sie nach zwei physischen Scans suchen. Testen Sie danach einen absichtlichen zweiten Scan und bestätigen Sie die Mengen- oder Duplikatregel, die Ihre Anwendung dokumentiert.

Der Wert fehlt oder ist abgeschnitten. Ein Attribut maxlength, eine Eingabemaske oder preventDefault() auf Zeichentasten kann die Nutzlast verwerfen oder kürzen. Vergleichen Sie die Zeichenanzahl im Eingabetester mit dem Wert in Ihrem Feld. Ein Präfix kann eine korrekte Nutzlast auch zu lang aussehen lassen.

QR-Codes erscheinen nie. Der Scanner ist möglicherweise nur 1D, oder die QR-Symbologie ist deaktiviert. Die Anwendung kann das nicht beheben. Bestätigen Sie die Hardware mit QR-Code-Tests: So testen Sie QR-Code-Scanner und kehren Sie dann zum Feldtest zurück.

Checkliste für Tests der Webanwendung

Nutzen Sie sie auf dem Build, den Sie ausliefern wollen, in jedem Browser, den Sie unterstützen. Prüfen Sie ein frisches Profil und ein Profil mit Passwortmanager- und Autofill-Erweiterungen, weil diese Erweiterungen den Fokus verschieben.

  • Der Scanner ist verbunden oder gekoppelt, und der Host zeigt ihn als bereit.
  • Der Scanner ist im Keyboard-Wedge-Modus, nicht seriell und nicht in einem Hersteller-SDK-Modus.
  • Das Barcodefeld ist unmittelbar vor dem Scan fokussiert. document.activeElement ist dieses Feld.
  • Ein bekannter Barcode kommt Zeichen für Zeichen an, einschließlich der Länge.
  • Ein Suffix ENTER sendet den Wert einmal ab oder nimmt ihn einmal an und lässt das Abschlusszeichen nicht in der gespeicherten Zeichenfolge.
  • Ein Suffix TAB verschiebt den Fokus auf das vorgesehene Steuerelement, und der Wert wird vor der Verschiebung gelesen.
  • Eine Konfiguration ohne Suffix lässt den Wert verfügbar, bis die Anwendung ihn abschließt.
  • Eine leere Übermittlung wird abgelehnt oder ignoriert.
  • Ein Scan erzeugt nicht zwei Datensätze. Ein zweiter echter Scan folgt der Duplikatregel der Anwendung.
  • Satzzeichen, Symbole und jeder GS1-Trenner, den Ihre Formate nutzen, überstehen den Hin- und Rückweg.
  • Das Tastaturlayout des Scanners und das Layout des Betriebssystems erzeugen die Zeichen, die auf dem Etikett gedruckt sind.
  • Nach dem Abziehen und Wiederanschließen oder nachdem die Bluetooth-Verbindung abbricht, erreicht der nächste Scan weiterhin das Feld.
  • Mehrere Scans hintereinander bleiben getrennte Werte. Das Feld hängt sie nicht aneinander.
  • Dieselben Prüfungen bestehen in den Browsern, die Sie unterstützen, mit und ohne übliche Autofill-Erweiterungen.

Für Dialoge, die Tabulatorreihenfolge über einen ganzen Kassiervorgang und POS-Mengenabläufe fahren Sie fort mit So testen Sie die Eingabe eines Barcodescanners.

Testfallmatrix

Die Spalte Scanner ist das, was Gerät und Browser tun. Die Spalte erwartetes Verhalten ist das, was die Anwendung daraufhin tun soll. Geschäftsregeln, etwa ob ein wiederholter Produktcode die Menge erhöht, gehören zur Anwendung. Nennen Sie sie im Test, statt eine Regel für jedes Produkt anzunehmen.

Szenario Erwartetes Verhalten
Gültiger Barcode Die Anwendung nimmt den Wert an und speichert die Nutzlast ohne das Abschlusszeichen.
Leere Eingabe Die Anwendung lehnt sie ab oder ignoriert sie und erzeugt keinen Datensatz.
Suffix ENTER Die Anwendung sendet den Wert einmal ab oder nimmt ihn einmal an.
Suffix TAB Der Fokus wandert zum vorgesehenen nächsten Steuerelement, und der Wert bleibt erhalten.
Kein Suffix Die Eingabe bleibt verfügbar, bis die Anwendung sie verarbeitet.
Schnelle aufeinanderfolgende Scans Jeder Wert wird getrennt verarbeitet und nicht mit dem vorherigen verkettet.
Falsches Tastaturlayout Unerwartete Zeichen sind im erfassten Wert sichtbar und bestehen die Validierung nicht.
Doppelter Scan Die Anwendung folgt ihrer eigenen Duplikatregel, etwa Menge erhöhen oder eine Wiederholung ablehnen.
Ungültiges Barcodeformat Die Anwendung zeigt den Validierungsfehler für dieses Format und speichert den Wert nicht.
Verlorener Eingabefokus Die Anwendung erfindet keinen Barcode. Der Scan fehlt oder landet im fokussierten Steuerelement, und die Seite bleibt in einem sicheren Zustand.

Führen Sie die Zeilen gültig, leer, ENTER, TAB und kein Suffix mit dem physischen Scanner und erneut mit dem Emulator aus. Führen Sie die Zeilen Tastaturlayout, QR und erneutes Verbinden auf der Hardware aus. Diese Zeilen hängen vom Gerät, vom Etikett oder vom Layout des Betriebssystems ab, was simulierte Tastenanschläge nicht nachbilden.