Zum Inhalt springen

Barcode Scanner Emulator

So testen Sie die Eingabe eines QR-Code-Scanners in Webanwendungen

Viele externe QR-fähige Scanner nutzen den Tastatur-Wedge-Modus und tippen den dekodierten QR-Text in das fokussierte Feld. Testen Sie diesen Pfad, indem Sie eine bekannte Nutzlast scannen und sie mit dem Wert vergleichen, den die Seite empfangen hat. Nicht jeder QR-Code-Scanner tippt wie eine Tastatur. Serielle Geräte und Kamera-Decoder sind andere Integrationen, und Tastaturereignisse im Browser identifizieren den physischen Scanner nicht.

Ein QR-Code speichert Daten. Der Scanner, oder ein Kamera-Decoder, macht aus diesen Daten Text. Die Webanwendung muss diesen Text empfangen, entscheiden, wann der Scan fertig ist, und ihn validieren. Dieser Leitfaden ist dieser Anwendungstest. Etiketten erzeugen, den Kontrast prüfen und bestätigen, dass ein Gerät QR Code dekodieren kann, steht in QR-Code-Tests: So testen Sie QR-Code-Scanner. Allgemeine Barcodeformulare, einschließlich EAN-Prüfziffern, stehen in So testen Sie Barcodescanner in Webanwendungen.

QR-Code-Scanner-Eingabe in 60 Sekunden testen

Verwenden Sie eine Nutzlast, die Sie gewählt haben, damit ein falsches Zeichen auffällt. Dieser Durchgang verwendet QR-INPUT-TEST-12345.

  1. Öffnen Sie den QR-Code-Generator und erzeugen Sie einen QR-Code für QR-INPUT-TEST-12345. Der Generator läuft im Browser. Er kontaktiert den Scanner nicht.
  2. Schließen Sie einen QR-fähigen Scanner an, der auf Tastatur-Wedge-Modus gestellt ist. Ein reiner 1D-Scanner kann dieses Symbol nicht dekodieren.
  3. Öffnen Sie den Barcode-Eingabetester.
  4. Klicken Sie auf Test starten oder auf den Scanbereich, damit das Feld den Fokus hat. Der Tester nimmt den Fokus nicht von selbst, und er öffnet den Scanner nicht.
  5. Scannen Sie den QR-Code.
  6. Lesen Sie den erfassten Text und die Zeichenanzahl.
  7. Vergleichen Sie diesen Text mit QR-INPUT-TEST-12345. Der Vergleich umfasst Groß- und Kleinschreibung, Bindestriche und die Länge.
  8. Lesen Sie das Suffix. Der Tester meldet ENTER, TAB oder Keins, wenn der Scanner eine dieser Tasten sendet.

Der Tester zeichnet Tastaturereignisse auf, die der Browser sehen kann. Er identifiziert das USB-Gerät nicht, liest keinen seriellen Port und dekodiert das QR-Bild nicht.

Eingabemodi eines QR-Code-Scanners

Derselbe gedruckte QR-Code kann über drei verschiedene Integrationen ankommen. Ein Test eines Modus übt die anderen nicht.

QR-Code-Scanner im Tastatur-Wedge

Im USB-HID-Tastaturmodus oder im Bluetooth-HID-Tastaturmodus behandelt das Betriebssystem den Scanner als Tastatur. Nach einer Dekodierung tippt der Scanner die Nutzlast in das Steuerelement, das den Fokus hat. Ein normales <input> oder <textarea> kann sie empfangen. Die Seite öffnet das Gerät nicht. Der Leitfaden HID-Tastatur-Wedge beschreibt die Tastenfolge, Präfixe und Suffixe.

Der Fokus entscheidet das Ziel. Ist das fokussierte Element der Dokumentkörper, eine Schaltfläche oder ein anderer Frame, sehen die Listener dieses Feldes den Scan nicht.

Serielle QR-Code-Scanner

Ein USB-Seriell-Scanner oder ein Scanner mit virtuellem COM-Port sendet den dekodierten Text als Bytes an den Prozess, der den Port geöffnet hat. Der Fokus wählt diesen Prozess nicht. Ein Feld, das nur auf Tastenanschläge hört, bleibt leer, während ein Terminal an diesem Port die Nutzlast zeigt.

Chromium-basierte Browser können einen vom Benutzer gewählten Port mit der Web Serial API öffnen, in einem sicheren Kontext, nach einer Nutzergeste. Firefox und Safari stellen diese API nicht bereit. Ein Wedge-Scanner erscheint nicht als serieller Port. Portnamen, Baud und Rahmung hängen vom Gerät und vom Treiber ab. USB-HID- und serielle Barcodescanner vergleicht die beiden Schnittstellen. Der Barcode-Eingabetester kann keinen COM-Port lesen.

Kamerabasiertes QR-Scannen

Eine Kameraintegration nimmt ein Bild auf und dekodiert den QR-Code in Software. Die Seite nutzt eine Kamera-API und einen Decoder. Sie empfängt keine keydown-Ereignisse für die Nutzlast. Smartphone-Kamera-Apps, Kameraschaltflächen in der Seite und ein Hardware-Imager, der in ein Feld tippt, sind drei verschiedene Produkte. Ein bestandener Wedge-Test bedeutet nicht, dass die Kameraschaltfläche funktioniert, und eine erfolgreiche Kamera-Dekodierung bedeutet nicht, dass ein Wedge-Scanner dieselbe Zeichenfolge tippt.

QR-Code-Scanner-Eingabe mit JavaScript erfassen

Die Seite unten liest ein fokussiertes Feld. Enter sendet das Formular ab, und die Schaltfläche Accept nutzt denselben Submit-Handler, sodass ein Scan einmal verarbeitet wird. Ohne ENTER-Suffix bleibt der Text im Feld, bis jemand Accept auslöst. Die erfasste Nutzlast wird mit textContent geschrieben, sodass Zeichen wie < als Text sichtbar bleiben.

Das Beispiel akzeptiert drei Anwendungsformate: eine Ticketkennung wie QR-INPUT-TEST-12345, eine http- oder https-URL oder ein JSON-Objekt. Es zeichnet den gescannten Text auf. Es navigiert nicht zu einer URL, die im QR-Code steht. Ein Scanner, der kein Enter sendet, funktioniert weiterhin über die Schaltfläche. Tab wandert wie gewohnt durch die Beschriftung, das Feld und die Schaltfläche, weil das Skript ihn nicht abfängt.

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

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

    const accepted = new Set()

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

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

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

Speichern Sie die Datei und öffnen Sie sie in einem Desktop-Browser. Klicken Sie vor dem Scannen in das Feld. autocomplete="off" verringert die Chance, dass ein gespeicherter Wert den Scan ersetzt. Beschriftung und Schaltfläche bleiben verfügbar, sodass eine Person eine Nutzlast ohne Scanner tippen kann.

Behandeln Sie Enter nur im submit-Ereignis des Formulars. Ein zweiter keydown-Listener für Enter zeichnet denselben Scan zweimal auf. preventDefault() hält den Browser auf dieser Seite. Leeren Sie das Feld nach einer Entscheidung, damit der nächste Scan nicht an den vorherigen Text anhängt.

Eine QR-Nutzlast kann einen Zeilenumbruch enthalten. Ein Wedge-Scanner tippt diesen Umbruch oft als Enter. In einem einzeiligen Input kann das Formular bei der ersten Zeile abgesendet werden und den Rest verwerfen. Verwenden Sie eine Textarea oder ein serielles Leseprogramm, das die Bytes behält, wenn die Anwendung mehrzeiligen Text annehmen muss. Bestätigen Sie dieses Verhalten mit einem QR-Code, dessen Nutzlast einen Zeilenumbruch enthält.

QR-Nutzlasten behandeln

Ein QR-Symbol verspricht kein Anwendungsformat. Dieselbe Symbologie kann jedes der Folgenden tragen:

  • Klartext, etwa QR-INPUT-TEST-12345.
  • Eine URL.
  • Eine Kennung, die die Anwendung gewählt hat.
  • Eine strukturierte Nutzlast, etwa eine Ticketnummer plus einen Standortcode.
  • JSON-Text, wenn die Anwendung diese Kodierung festgelegt hat.

Der Scanner überträgt die dekodierten Zeichen. Er prüft nicht, ob sie einer Ticketregel, einem Produktkatalog oder einem JSON-Schema entsprechen. Validieren Sie die Zeichenfolge in der Seite und validieren Sie sie erneut auf dem Server. Der gesendete Wert ist gewöhnliche Benutzereingabe. Der Browser kann nicht beweisen, dass ein Scanner ihn erzeugt hat.

QR-Eingabe validieren

Nehmen Sie nicht an, eine QR-Nutzlast sei numerisch. EAN-13-Regeln gelten nicht. Behandeln Sie den Text als nicht vertrauenswürdig: zeigen Sie ihn als Text an und weisen Sie ihn nicht location, innerHTML oder einer Skript-URL zu.

Leere Werte. Ein bloßes Enter oder Accept auf einem leeren Feld sollte keinen Datensatz erzeugen. trim() weist auch eine Nutzlast zurück, die nur aus Leerzeichen besteht.

Unerwartete Zeichen. Vergleichen Sie die empfangene Zeichenfolge mit dem bekannten QR-Inhalt. Ein abweichendes Tastaturlayout ändert oft die Satzzeichen, während die Länge gleich bleibt. Weisen Sie Zeichen zurück, die das Format nicht erlaubt, und zeigen Sie den Grund im Statustext.

Nutzlastlänge. Erzwingen Sie das Maximum, das Ihre Anwendung speichert. maxlength am Input kürzt einen längeren Scan ohne Fehler. Setzen Sie es nur, wenn jede angenommene Nutzlast hineinpasst, und vergleichen Sie die Zeichenanzahl des Testers mit dem Feld, wenn ein Wert kurz wirkt.

Erforderliche Präfixe. Eine Präfixprüfung gehört zur Anwendung. Diese Ticketregel akzeptiert QR- plus Großbuchstaben, Ziffern und Bindestriche:

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

Entfernen Sie ein Scannerpräfix nur, wenn dieser Scanner so konfiguriert ist, dass er genau ein Präfix sendet, und die Anwendung es nicht speichert. Eine AIM-Symbologiekennung ist Daten, bis Sie anders entscheiden.

Anwendungsspezifische Formate. Halten Sie die Regel neben dem Format. Ein Ticketformular, eine URL-Freigabeliste und ein JSON-Objekt brauchen verschiedene Prüfungen. Ein einziges numerisches Muster weist gültigen QR-Text zurück.

Doppelte Scans. Ein physischer Scan kann zwei Listener treffen. Verwenden Sie einen einzigen Abschlussweg, wie das Beispiel. Ein zweiter Zug am Auslöser ist ein separates Ereignis. Das Beispiel weist eine Nutzlast zurück, die es schon angenommen hat. Ein Lagerformular könnte stattdessen eine Menge erhöhen. Testen Sie die Regel, die Ihre Anwendung dokumentiert.

Fehlerhaftes JSON. JSON.parse wirft bei unvollständigem Text. Prüfen Sie die Form nach einem erfolgreichen Parse. Ein Array oder eine nackte Zahl kann gültiges JSON sein und trotzdem der falsche Typ:

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

Unerwartete URLs. Parsen Sie die URL, um zu sehen, ob sie verwendbar ist, und behalten Sie die gescannte Zeichenfolge, wenn der Test exakt zur QR-Nutzlast passen muss. URL.href kann einen Schrägstrich anfügen oder die Kodierung ändern. Akzeptieren Sie nur die Schemata, die die Anwendung vorsieht. Öffnen Sie die URL nicht als Nebenwirkung des Scans:

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

Steuerzeichen. Weisen Sie ASCII-Steuerzeichen in einer Tastaturnutzlast zurück, damit ein verstecktes Präfix im Statustext sichtbar bleibt. CR und LF sind Steuerzeichen. An einem Wedge-Scanner sind Enter und Tab Tasten. Sie sind keine Zeichen in einem normalen Texteingabefeld. Eine serielle Nutzlast kann weiterhin 0x0D- oder 0x0A-Bytes enthalten. Entfernen Sie diese an der seriellen Rahmungsgrenze und entfernen Sie kein CR, das in die Mitte einer mehrzeiligen Nutzlast gehört.

Suffixe ENTER und TAB

Ein Suffix ist optionale Scannerkonfiguration. Es gehört nicht zum QR-Symbol. Suffixe ENTER und TAB bei Barcodescannern zeigt, wie Sie die Tasten auseinanderhalten. Lesen Sie das Suffix im Eingabetester und richten Sie die Seite dann auf die Scanner aus, die Sie einsetzen.

ENTER sendet das Formular eines einzeiligen Textfelds in aktuellen Browsern ab. Nutzen Sie das, wenn ein Scan den Wert übernehmen soll. Rufen Sie preventDefault() auf submit auf, wenn die Seite an Ort und Stelle bleiben soll.

TAB verschiebt den Fokus zum nächsten Steuerelement. Lesen Sie den Wert in keydown, solange das Feld noch den Fokus hat. Lassen Sie die Standardaktion in Kraft, wenn das nächste Feld den Fokus erhalten soll. Ignorieren Sie Shift+Tab, damit jemand mit der Tastatur rückwärts gehen kann.

Kein Suffix lässt die Nutzlast im Feld. Die Schaltfläche Accept im Beispiel ist der Abschlussweg. Ein Inaktivitätstimer kann vermuten, dass eine Pause das Ende des Scans bedeutet. Dieser Timer ist eine Heuristik: ein langsamer Bluetooth-Stoß und schnelles Tippen können dieselbe Lücke überschreiten. Bevorzugen Sie ein konfiguriertes Suffix, wenn der Ablauf ein hartes Ende braucht.

CR und LF sind Bytes. Ein Tastatur-Enter ist event.key === "Enter". Das ist nicht austauschbar. Ein Listener, der nur \r aus einem Input-Wert entfernt, sieht ein Wedge-Enter nicht, weil das Zeichen nie eingefügt wurde. Ein Listener, der nur event.key beobachtet, teilt einen seriellen Puffer nicht an 0x0D. Manche Geräte senden NumPad Enter. event.key ist weiterhin "Enter". Prüfen Sie event.key, nicht nur event.code === "Enter".

Das Suffix kann sich ändern, wenn jemand einen Konfigurationsbarcode aus dem Gerätehandbuch scannt. Testen Sie Enter, Tab und kein Suffix nach jeder Konfigurationsänderung erneut. Erfinden Sie keinen Programmierbarcode. Verwenden Sie das Handbuch für dieses Modell.

Tastaturereignisse untersuchen

Wenn der gespeicherte Text falsch ist, untersuchen Sie die Ereignisse in dieser Reihenfolge.

keydown. Feuert für jede Taste, einschließlich Enter und Tab, bevor der Browser ein Zeichen einfügt oder den Fokus verschiebt. Lesen Sie den Terminator hier.

input. Feuert, nachdem ein druckbares Zeichen das Feld ändert. Es feuert bei einem Texteingabefeld nicht für Enter oder Tab.

event.key. Das Zeichen oder der Tastenname, nachdem das Betriebssystem das Tastaturlayout angewendet hat.

event.code. Die physische Taste, etwa Digit1 oder Numpad1. Sie kann gleich bleiben, wenn ein Layoutunterschied event.key ändert.

Fokus. Protokollieren Sie document.activeElement vor dem Scan. Ist es nicht das QR-Feld, beschreibt der Rest der Spur das falsche Steuerelement. Ein iframe hat seinen eigenen Fokus.

Reihenfolge. Bei einem Wedge-Scan in ein Textfeld folgen auf druckbare keydown-Ereignisse input-Aktualisierungen, dann ein abschließendes keydown für Enter oder Tab, wenn dieses Suffix konfiguriert ist. change feuert, wenn das Feld den Wert übernimmt, meist beim Verlassen. Ein Scan, der den Fokus im selben Feld lässt, erzeugt am Ende kein change. Verwenden Sie change nicht als einziges Abschlusssignal.

Timing. Scanner beenden eine kurze Nutzlast oft deutlich unter einer Sekunde. Der Eingabetester vergleicht die durchschnittliche Lücke zwischen Zeichen mit einer Schwelle von 100 ms und beschriftet das Ergebnis als Timing, nicht als Hardware-Identifikation. Schnelles Tippen, Autofill oder der Emulator können auf der Scannerseite dieser Schwelle landen. Ein verzögerter Bluetooth-Scan kann wie Tippen aussehen. Prüfen Sie die Nutzlast und das Suffix. Behandeln Sie das Timing als Hinweis.

Der Tastaturereignis-Tester listet jedes keydown und keyup mit key, code, Modifikatoren und Zeitstempeln. Das Protokoll sind Browserereignisse. Es ist kein roher USB-Verkehr.

Test ohne physischen QR-Code-Scanner

Anwendungslogik lässt sich testen, bevor ein Scanner auf dem Tisch liegt.

  • Tippen Sie QR-INPUT-TEST-12345 in das Feld und lösen Sie Accept aus. Das prüft Validierung und Anzeige. Es prüft nicht Dekodierung oder Suffixe.
  • Steuern Sie dasselbe Feld aus einem Browser-Automatisierungswerkzeug, wie es der nächste Abschnitt tut.
  • Nutzen Sie den Barcode Scanner Emulator, wenn Sie scannerartiges Tippen brauchen. Die Desktop-App sendet einen Wert, den Sie eingeben, mit einer Tippverzögerung und einem Suffix von keinem, ENTER oder TAB, in die fokussierte Anwendung. Sie bildet den Tastaturpfad nach. Sie fotografiert kein QR-Bild, dekodiert kein Symbol und erzeugt keinen virtuellen COM-Port.

Hardware bleibt für optisches und Geräteverhalten nötig: ob dieser Scanner den angezeigten oder gedruckten Code lesen kann, ob die QR-Symbologie aktiviert ist, das Tastaturlayout, die Suffixkonfiguration und serielle oder Hersteller-SDK-Modi. Der Emulator ist die richtige Prüfung für den Tastaturpfad. Er ist die falsche Prüfung, um zu belegen, dass ein Gerät einen bestimmten QR-Code liest.

QR-Eingabetests automatisieren

Die folgenden Playwright-Tests steuern die Beispielseite. Sie tippen in das Feld, wie es ein Wedge-Scanner täte, und prüfen dann das Anwendungsverhalten. Sie öffnen keine USB-Geräte. @playwright/test ist eine Abhängigkeit für die Person, die den Test ausführt. Diese Website verlangt sie nicht.

Speichern Sie das HTML-Beispiel als qr-form.html neben diesem Test.

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

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

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

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

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

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

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

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

pressSequentially fügt Zeichen in das fokussierte Feld ein. Es ist kein USB-Gerät. Der Test für unerwartete Zeichen verwendet fill, weil das Ziel die Validierungsmeldung und das Fehlen eines eingeschleusten Elements ist. Erweitern Sie die Datei um einen URL-Fall und einen JSON-Fall, wenn diese Formate in dem Build sind, den Sie ausliefern. Eine URL-Prüfung sollte den erfassten Text mit der ursprünglichen QR-Zeichenfolge vergleichen.

Testmatrix für QR-Code-Scanner

Führen Sie diese gegen die zu testende Anwendung aus. Die Beispielseite oben deckt die Zeilen Ticket, URL, JSON, Duplikat, leer und unerwartete Zeichen ab. Eine nur numerische oder mehrzeilige Anwendung braucht ihr eigenes erwartetes Ergebnis.

Szenario Erwartetes Ergebnis
Klartext-QR Genauer Wert empfangen
URL-QR Vollständige URL erfasst, und die Seite navigiert nicht dorthin
Numerisches QR Ziffern erhalten
Sonderzeichen Richtige Zeichen empfangen
JSON-Nutzlast Daten erfasst und validiert
Suffix ENTER Verarbeitung erfolgt einmal
Suffix TAB Fokusverhalten behandelt
Kein Suffix Die Anwendung nutzt einen alternativen Abschlussweg
Doppelter Scan Die Anwendung wendet Regeln für Duplikate an
Ungültige Nutzlast Validierungsfehler angezeigt
Fehlender Fokus Die Anwendung behandelt fehlende Eingabe sicher
Lange Nutzlast Keine unbeabsichtigte Kürzung

Scannen Sie auch eine Nutzlast, die einen Zeilenumbruch enthält, wenn das Produkt einen speichern muss. Notieren Sie, ob das Feld jede Zeile empfangen hat.

Fehlersuche

Beginnen Sie mit einer bekannten Nutzlast im Eingabetester. Ist der Wert des Testers schon falsch, ist die Seite nicht der erste Fehler. Ist der Wert des Testers richtig und die Anwendung falsch, liegt der Fehler bei Fokus, Validierung oder Ereignisbehandlung. Barcodescanner funktioniert nicht ist die breitere Geräte-Checkliste. So testen Sie die Eingabe eines Barcodescanners behandelt Fokus, Layout und POS-Abläufe über dieses Formular hinaus.

Der Scanner piept, aber es erscheint keine Eingabe

Ein Piep bedeutet meist, dass der Scanner ein Symbol dekodiert hat. Er bedeutet nicht, dass die Seite den Text empfangen hat. Bestätigen Sie den Tastatur-Wedge-Modus. Serielle und Kameramodi tippen nicht in das Feld. Klicken Sie in das Feld, sodass document.activeElement dieses Input ist, und scannen Sie erneut. Ein deaktiviertes, schreibgeschütztes oder verborgenes Feld kann die Tasten ignorieren.

Der QR-Code-Scanner funktioniert in Notepad, aber nicht im Browser

Das Gerät tippt. Die Seite nimmt diese Tasten nicht an. Prüfen Sie den Fokus, einen keydown-Listener, der preventDefault() für druckbare Tasten aufruft, und einen Listener, der nur paste behandelt. Wedge-Eingabe löst kein Paste-Ereignis aus. Vergleichen Sie das Testergebnis mit dem Anwendungsfeld.

Der Scanner liest Barcodes, aber keine QR-Codes

Das Gerät kann nur 1D sein, oder die QR-Symbologie kann deaktiviert sein. Die Seite kann das nicht beheben. Bestätigen Sie 2D-Unterstützung und aktivieren Sie QR Code aus dem Gerätehandbuch, mit den Prüfungen in QR-Code-Tests: So testen Sie QR-Code-Scanner. Ein erfolgreicher Scan von Code 128 beweist nur den Tastaturpfad.

Falsche Zeichen

Scannen Sie zuerst QR-INPUT-TEST-12345. Wenn das passt und eine URL- oder JSON-Nutzlast nicht, ändert das Layout Satzzeichen wie :, /, { oder ". Vergleichen Sie event.key mit event.code im Tastaturereignis-Tester und sehen Sie Falsches Tastaturlayout am Barcodescanner. Gleichen Sie das Tastaturlayout des Scanners mit dem Betriebssystem ab.

ENTER sendet das Formular zweimal ab

Der Browser sendet das Formular ab, und ein keydown-Listener behandelt ebenfalls Enter. Behalten Sie einen Abschlussweg und rufen Sie preventDefault() dort auf. Ein zweiter physischer Scan ist ein anderer Fehler. Der Statustext im Beispiel sagt, dass die Nutzlast schon angenommen wurde. Wenn der erste Scan selbst zwei Datensätze erzeugt, suchen Sie nach zwei Listenern, bevor Sie den Scanner ändern.

Die QR-Eingabe wird abgeschnitten

Vergleichen Sie die Zeichenanzahl im Eingabetester mit dem Wert im Feld. Ein maxlength-Attribut, eine Eingabemaske oder preventDefault() auf Zeichentasten kann die Zeichenfolge kürzen. Ein Zeilenumbruch in der QR-Nutzlast kann ein einzeiliges Input früh absenden. Manche Scanner begrenzen auch, wie viele Zeichen sie tippen. Heben Sie diese Grenze aus dem Gerätehandbuch an, wenn der Tester, nicht nur die Anwendung, einen kurzen Wert zeigt. Barcodescanner sendet kein ENTER behandelt den verwandten Fall, in dem die Nutzlast ankommt und das Formular nie übernimmt.

Der Scanner kann einen QR-Code auf dem Bildschirm nicht lesen

Bestätigen Sie, dass der Scanner ein 2D-Imager ist. Erhöhen Sie die Helligkeit der Anzeige, vergrößern Sie den Code und halten Sie die Ruhezone frei von Text und Rändern. Spiegelung, ein dunkler Smartphone-Bildschirm und ein Code, der für den Arbeitsabstand zu dicht ist, sind optische Probleme. Drucken Sie dieselbe Nutzlast, wenn das Lesen vom Bildschirm weiter scheitert. Der Anwendungstest verwendet weiterhin die bekannte Zeichenfolge, sobald irgendein Scan Text erzeugt.