Μετάβαση στο περιεχόμενο

Barcode Scanner Emulator

Πώς να δοκιμάσετε την εισαγωγή σαρωτή κωδίκων QR σε εφαρμογές ιστού

Πολλοί εξωτερικοί σαρωτές με δυνατότητα QR χρησιμοποιούν λειτουργία σφήνας πληκτρολογίου και πληκτρολογούν το αποκωδικοποιημένο κείμενο QR στο εστιασμένο πεδίο. Δοκιμάστε αυτή τη διαδρομή σαρώνοντας γνωστό φορτίο και συγκρίνοντάς το με την τιμή που έλαβε η σελίδα. Δεν πληκτρολογεί κάθε σαρωτής QR σαν πληκτρολόγιο. Οι σειριακές συσκευές και οι αποκωδικοποιητές κάμερας είναι διαφορετικές ενοποιήσεις, και τα συμβάντα πληκτρολογίου του προγράμματος περιήγησης δεν αναγνωρίζουν τον φυσικό σαρωτή.

Ένας κώδικας QR αποθηκεύει δεδομένα. Ο σαρωτής, ή ένας αποκωδικοποιητής κάμερας, μετατρέπει αυτά τα δεδομένα σε κείμενο. Η εφαρμογή ιστού πρέπει έπειτα να λάβει αυτό το κείμενο, να αποφασίσει πότε τελείωσε η σάρωση και να το επικυρώσει. Αυτός ο οδηγός είναι εκείνη η δοκιμή της εφαρμογής. Η δημιουργία ετικετών, ο έλεγχος αντίθεσης και η επιβεβαίωση ότι μια συσκευή μπορεί να αποκωδικοποιήσει QR Code καλύπτονται στο Δοκιμή κωδίκων QR: πώς να δοκιμάσετε σαρωτές κωδίκων QR. Οι γενικές φόρμες γραμμωτού κώδικα, συμπεριλαμβανομένων των ψηφίων ελέγχου EAN, καλύπτονται στο Πώς να δοκιμάσετε σαρωτές γραμμωτού κώδικα σε εφαρμογές ιστού.

Δοκιμάστε την εισαγωγή σαρωτή QR σε 60 δευτερόλεπτα

Χρησιμοποιήστε ένα φορτίο που επιλέξατε, ώστε ένας λάθος χαρακτήρας να είναι εμφανής. Αυτή η διαδρομή χρησιμοποιεί QR-INPUT-TEST-12345.

  1. Ανοίξτε τη γεννήτρια κωδικών QR και δημιουργήστε έναν κώδικα QR για QR-INPUT-TEST-12345. Η γεννήτρια εκτελείται στο πρόγραμμα περιήγησης. Δεν επικοινωνεί με τον σαρωτή.
  2. Συνδέστε έναν σαρωτή με δυνατότητα QR που είναι ρυθμισμένος σε λειτουργία σφήνας πληκτρολογίου. Ένας σαρωτής μόνο 1D δεν μπορεί να αποκωδικοποιήσει αυτό το σύμβολο.
  3. Ανοίξτε τον ελεγκτή εισαγωγής γραμμωτού κώδικα.
  4. Κάντε κλικ στο Έναρξη δοκιμής ή κάντε κλικ στην περιοχή σάρωσης, ώστε το πεδίο να έχει εστίαση. Ο ελεγκτής δεν παίρνει εστίαση μόνος του και δεν ανοίγει τον σαρωτή.
  5. Σαρώστε τον κώδικα QR.
  6. Διαβάστε το καταγεγραμμένο κείμενο και τον αριθμό χαρακτήρων.
  7. Συγκρίνετε αυτό το κείμενο με QR-INPUT-TEST-12345. Η αντιστοιχία περιλαμβάνει πεζά και κεφαλαία, παύλες και μήκος.
  8. Διαβάστε την κατάληξη. Ο ελεγκτής αναφέρει ENTER, TAB ή Καμία όταν ο σαρωτής στέλνει ένα από αυτά τα πλήκτρα.

Ο ελεγκτής καταγράφει συμβάντα πληκτρολογίου που μπορεί να δει το πρόγραμμα περιήγησης. Δεν αναγνωρίζει τη συσκευή USB, δεν διαβάζει σειριακή θύρα και δεν αποκωδικοποιεί την εικόνα QR.

Λειτουργίες εισαγωγής σαρωτή QR

Ο ίδιος εκτυπωμένος κώδικας QR μπορεί να φτάσει μέσα από τρεις διαφορετικές ενοποιήσεις. Η δοκιμή μιας λειτουργίας δεν ασκεί τις άλλες.

Σαρωτές QR με σφήνα πληκτρολογίου

Στη λειτουργία πληκτρολογίου USB HID, ή στη λειτουργία πληκτρολογίου Bluetooth HID, το λειτουργικό σύστημα αντιμετωπίζει τον σαρωτή ως πληκτρολόγιο. Μετά την αποκωδικοποίηση, ο σαρωτής πληκτρολογεί το φορτίο στο στοιχείο ελέγχου που έχει εστίαση. Ένα συνηθισμένο <input> ή <textarea> μπορεί να το λάβει. Η σελίδα δεν ανοίγει τη συσκευή. Ο οδηγός HID σφήνα πληκτρολογίου περιγράφει την ακολουθία πατημάτων, τα προθέματα και τις καταλήξεις.

Η εστίαση αποφασίζει τον προορισμό. Αν το εστιασμένο στοιχείο είναι το σώμα του εγγράφου, ένα κουμπί ή άλλο πλαίσιο, οι ακροατές αυτού του πεδίου δεν βλέπουν τη σάρωση.

Σειριακοί σαρωτές QR

Ένας σειριακός σαρωτής USB ή με εικονική θύρα COM στέλνει το αποκωδικοποιημένο κείμενο ως byte στη διεργασία που άνοιξε τη θύρα. Η εστίαση δεν επιλέγει αυτή τη διεργασία. Ένα πεδίο που ακούει μόνο πατήματα μένει άδειο, ενώ ένα τερματικό σε εκείνη τη θύρα δείχνει το φορτίο.

Τα προγράμματα περιήγησης που βασίζονται στο Chromium μπορούν να ανοίξουν θύρα που επέλεξε ο χρήστης με το Web Serial API, σε ασφαλές περιβάλλον, μετά από χειρονομία του χρήστη. Τα Firefox και Safari δεν παρέχουν αυτό το API. Ένας σαρωτής σφήνας δεν εμφανίζεται ως σειριακή θύρα. Τα ονόματα θυρών, το baud και το framing εξαρτώνται από τη συσκευή και τον οδηγό. Σαρωτές γραμμωτού κώδικα USB HID και σειριακοί συγκρίνει τις δύο διασυνδέσεις. Ο ελεγκτής εισαγωγής γραμμωτού κώδικα δεν μπορεί να διαβάσει θύρα COM.

Σάρωση QR με κάμερα

Μια ενοποίηση κάμερας καταγράφει εικόνα και αποκωδικοποιεί τον κώδικα QR σε λογισμικό. Η σελίδα χρησιμοποιεί API κάμερας και αποκωδικοποιητή. Δεν λαμβάνει συμβάντα keydown για το φορτίο. Οι εφαρμογές κάμερας τηλεφώνου, τα κουμπιά κάμερας μέσα στη σελίδα και ένας υλικός imager που πληκτρολογεί σε πεδίο είναι τρία διαφορετικά προϊόντα. Η επιτυχία μιας δοκιμής σφήνας δεν σημαίνει ότι το κουμπί κάμερας λειτουργεί, και μια επιτυχής αποκωδικοποίηση κάμερας δεν σημαίνει ότι ένας σαρωτής σφήνας θα πληκτρολογήσει την ίδια συμβολοσειρά.

Καταγράψτε την εισαγωγή σαρωτή QR με JavaScript

Η σελίδα παρακάτω διαβάζει ένα εστιασμένο πεδίο. Το Enter υποβάλλει τη φόρμα, και το κουμπί Accept χρησιμοποιεί τον ίδιο χειριστή submit, ώστε μία σάρωση να επεξεργάζεται μία φορά. Χωρίς κατάληξη ENTER, το κείμενο μένει στο πεδίο μέχρι κάποιος να ενεργοποιήσει το Accept. Το καταγεγραμμένο φορτίο γράφεται με textContent, ώστε χαρακτήρες όπως το < να μένουν ορατοί ως κείμενο.

Το παράδειγμα δέχεται τρεις μορφές εφαρμογής: ένα αναγνωριστικό εισιτηρίου όπως QR-INPUT-TEST-12345, ένα URL http ή https, ή ένα αντικείμενο JSON. Καταγράφει το σαρωμένο κείμενο. Δεν μεταβαίνει σε URL που βρίσκεται στον κώδικα QR. Ένας σαρωτής που δεν στέλνει Enter εξακολουθεί να λειτουργεί μέσω του κουμπιού. Το Tab κινείται στην ετικέτα, το πεδίο και το κουμπί ως συνήθως, γιατί το σενάριο δεν το παγιδεύει.

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

Αποθηκεύστε το αρχείο και ανοίξτε το σε πρόγραμμα περιήγησης υπολογιστή. Κάντε κλικ στο πεδίο πριν από τη σάρωση. Το autocomplete="off" μειώνει την πιθανότητα μια αποθηκευμένη τιμή να αντικαταστήσει τη σάρωση. Η ετικέτα και το κουμπί μένουν διαθέσιμα, ώστε ένα άτομο να μπορεί να πληκτρολογήσει φορτίο χωρίς σαρωτή.

Χειριστείτε το Enter μόνο στο συμβάν submit της φόρμας. Ένας δεύτερος ακροατής keydown για το Enter καταγράφει την ίδια σάρωση δύο φορές. Το preventDefault() κρατά το πρόγραμμα περιήγησης σε αυτή τη σελίδα. Καθαρίστε το πεδίο μετά από μια απόφαση, ώστε η επόμενη σάρωση να μην προστεθεί στο προηγούμενο κείμενο.

Ένα φορτίο QR μπορεί να περιέχει αλλαγή γραμμής. Ένας σαρωτής σφήνας πληκτρολογεί συχνά αυτή τη διακοπή ως Enter. Σε input μίας γραμμής, η φόρμα μπορεί να υποβληθεί στην πρώτη γραμμή και να απορρίψει τα υπόλοιπα. Χρησιμοποιήστε textarea, ή σειριακή ανάγνωση που κρατά τα byte, όταν η εφαρμογή πρέπει να δέχεται κείμενο πολλών γραμμών. Επιβεβαιώστε αυτή τη συμπεριφορά με έναν κώδικα QR του οποίου το φορτίο περιλαμβάνει νέα γραμμή.

Χειρισμός φορτίων QR

Ένα σύμβολο QR δεν υπόσχεται μορφή εφαρμογής. Η ίδια συμβολολογία μπορεί να μεταφέρει οποιοδήποτε από αυτά:

  • Απλό κείμενο, όπως QR-INPUT-TEST-12345.
  • Ένα URL.
  • Ένα αναγνωριστικό που επέλεξε η εφαρμογή.
  • Ένα δομημένο φορτίο, όπως αριθμός εισιτηρίου μαζί με κωδικό τοποθεσίας.
  • Κείμενο JSON, όταν η εφαρμογή όρισε αυτή την κωδικοποίηση.

Ο σαρωτής μεταδίδει τους αποκωδικοποιημένους χαρακτήρες. Δεν ελέγχει αν ταιριάζουν με κανόνα εισιτηρίου, κατάλογο προϊόντων ή σχήμα JSON. Επικυρώστε τη συμβολοσειρά στη σελίδα και επικυρώστε την ξανά στον διακομιστή. Η τιμή που υποβάλλεται είναι συνηθισμένη εισαγωγή χρήστη. Το πρόγραμμα περιήγησης δεν μπορεί να αποδείξει ότι την παρήγαγε σαρωτής.

Επικυρώστε την εισαγωγή QR

Μην υποθέτετε ότι ένα φορτίο QR είναι αριθμητικό. Οι κανόνες EAN-13 δεν ισχύουν. Αντιμετωπίστε το κείμενο ως μη έμπιστο: εμφανίστε το ως κείμενο και μην το αναθέτετε σε location, innerHTML ή URL σεναρίου.

Κενές τιμές. Ένα σκέτο Enter, ή το Accept σε κενό πεδίο, δεν πρέπει να δημιουργεί εγγραφή. Το trim() απορρίπτει και ένα φορτίο που είναι μόνο κενά.

Απροσδόκητοι χαρακτήρες. Συγκρίνετε τη συμβολοσειρά που λάβατε με το γνωστό περιεχόμενο QR. Μια ασυμφωνία διάταξης πληκτρολογίου αλλάζει συχνά τη στίξη, ενώ το μήκος μένει το ίδιο. Απορρίψτε χαρακτήρες που η μορφή δεν επιτρέπει και δείξτε τον λόγο στο κείμενο κατάστασης.

Μήκος φορτίου. Επιβάλετε το μέγιστο που αποθηκεύει η εφαρμογή. Το maxlength στο input περικόπτει μια μεγαλύτερη σάρωση χωρίς σφάλμα. Ορίστε το μόνο όταν κάθε αποδεκτό φορτίο χωρά, και συγκρίνετε τον αριθμό χαρακτήρων του ελεγκτή με το πεδίο όταν μια τιμή φαίνεται σύντομη.

Απαιτούμενα προθέματα. Ένας έλεγχος προθέματος ανήκει στην εφαρμογή. Αυτός ο κανόνας εισιτηρίου δέχεται QR- συν κεφαλαία γράμματα, ψηφία και παύλες:

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

Αφαιρέστε ένα πρόθεμα σαρωτή μόνο όταν αυτός ο σαρωτής είναι ρυθμισμένος να στέλνει ένα ακριβές πρόθεμα και η εφαρμογή δεν το αποθηκεύει. Ένα αναγνωριστικό συμβολολογίας AIM είναι δεδομένα μέχρι να αποφασίσετε διαφορετικά.

Μορφές ειδικές για την εφαρμογή. Κρατήστε τον κανόνα δίπλα στη μορφή. Μια φόρμα εισιτηρίου, μια λίστα επιτρεπόμενων URL και ένα αντικείμενο JSON χρειάζονται διαφορετικούς ελέγχους. Ένα αριθμητικό μοτίβο θα απορρίψει έγκυρο κείμενο QR.

Διπλές σαρώσεις. Μία φυσική σάρωση μπορεί να χτυπήσει δύο ακροατές. Χρησιμοποιήστε μία διαδρομή ολοκλήρωσης, όπως κάνει το παράδειγμα. Ένα δεύτερο τράβηγμα της σκανδάλης είναι ξεχωριστό συμβάν. Το παράδειγμα απορρίπτει ένα φορτίο που έχει ήδη αποδεχτεί. Μια φόρμα αποθήκης μπορεί αντί γι' αυτό να αυξήσει μια ποσότητα. Δοκιμάστε τον κανόνα που τεκμηριώνει η εφαρμογή.

Κακοσχηματισμένο JSON. Το JSON.parse εγείρει εξαίρεση σε ημιτελές κείμενο. Ελέγξτε το σχήμα μετά από επιτυχή ανάλυση. Ένας πίνακας ή ένας σκέτος αριθμός μπορεί να είναι έγκυρο JSON και παρ' όλα αυτά λάθος τύπος:

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.' }
  }
}

Απροσδόκητα URL. Αναλύστε το URL για να δείτε αν είναι χρησιμοποιήσιμο, έπειτα κρατήστε τη σαρωμένη συμβολοσειρά αν η δοκιμή πρέπει να ταιριάζει ακριβώς με το φορτίο QR. Το URL.href μπορεί να προσθέσει κάθετο ή να αλλάξει την κωδικοποίηση. Δεχτείτε μόνο τα σχήματα που προορίζει η εφαρμογή. Μην ανοίγετε το URL ως παρενέργεια της σάρωσης:

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

Χαρακτήρες ελέγχου. Απορρίψτε τους χαρακτήρες ελέγχου ASCII σε φορτίο πληκτρολογίου, ώστε ένα κρυφό πρόθεμα να μένει ορατό στο κείμενο κατάστασης. Τα CR και LF είναι χαρακτήρες ελέγχου. Σε σαρωτή σφήνας, τα Enter και Tab είναι πλήκτρα. Δεν είναι χαρακτήρες μέσα σε συνηθισμένο input κειμένου. Ένα σειριακό φορτίο μπορεί ακόμη να περιέχει byte 0x0D ή 0x0A. Αφαιρέστε τα στο όριο πλαισίωσης της σειριακής ροής και μην αφαιρείτε CR που ανήκει στη μέση ενός φορτίου πολλών γραμμών.

Καταλήξεις ENTER και TAB

Μια κατάληξη είναι προαιρετική ρύθμιση του σαρωτή. Δεν είναι μέρος του συμβόλου QR. Το Καταλήξεις ENTER και TAB σε σαρωτές γραμμωτού κώδικα δείχνει πώς να ξεχωρίζετε τα πλήκτρα. Διαβάστε την κατάληξη στον ελεγκτή εισαγωγής και έπειτα κάντε τη σελίδα να ταιριάζει με τους σαρωτές που αναπτύσσετε.

ENTER υποβάλλει τη φόρμα ενός πεδίου κειμένου μίας γραμμής στα τρέχοντα προγράμματα περιήγησης. Χρησιμοποιήστε το όταν μία σάρωση πρέπει να οριστικοποιήσει την τιμή. Καλέστε preventDefault() στο submit όταν η σελίδα πρέπει να μείνει στη θέση της.

TAB μετακινεί την εστίαση στο επόμενο στοιχείο ελέγχου. Διαβάστε την τιμή στο keydown ενώ το πεδίο έχει ακόμη εστίαση. Αφήστε την προεπιλεγμένη ενέργεια όταν το επόμενο πεδίο πρέπει να λάβει την εστίαση. Αγνοήστε το Shift+Tab, ώστε ένας χρήστης πληκτρολογίου να μπορεί να κινηθεί προς τα πίσω.

Χωρίς κατάληξη αφήνει το φορτίο στο πεδίο. Το κουμπί Accept στο παράδειγμα είναι η διαδρομή ολοκλήρωσης. Ένας χρονοδιακόπτης αδράνειας μπορεί να μαντέψει ότι μια παύση σημαίνει το τέλος της σάρωσης. Αυτός ο χρονοδιακόπτης είναι ευρετικός: μια αργή ριπή Bluetooth και κάποιος που πληκτρολογεί γρήγορα μπορούν και οι δύο να περάσουν το ίδιο κενό. Προτιμήστε ρυθμισμένη κατάληξη όταν η ροή χρειάζεται σταθερό τέλος.

CR και LF είναι byte. Ένα Enter πληκτρολογίου είναι event.key === "Enter". Δεν είναι εναλλάξιμα. Ένας ακροατής που αφαιρεί μόνο το \r από μια τιμή input δεν θα δει Enter σφήνας, γιατί ο χαρακτήρας δεν εισήχθη ποτέ. Ένας ακροατής που παρακολουθεί μόνο το event.key δεν θα χωρίσει έναν σειριακό ενδιάμεσο χώρο στο 0x0D. Ορισμένες συσκευές στέλνουν NumPad Enter. Το event.key είναι ακόμη "Enter". Ελέγξτε το event.key, όχι μόνο το event.code === "Enter".

Αποσφαλμάτωση συμβάντων πληκτρολογίου

Όταν το αποθηκευμένο κείμενο είναι λάθος, εξετάστε τα συμβάντα με αυτή τη σειρά.

keydown. Πυροδοτείται για κάθε πλήκτρο, συμπεριλαμβανομένων των Enter και Tab, πριν το πρόγραμμα περιήγησης εισαγάγει χαρακτήρα ή μετακινήσει την εστίαση. Διαβάστε τον τερματιστή εδώ.

input. Πυροδοτείται αφού ένας εκτυπώσιμος χαρακτήρας αλλάξει το πεδίο. Δεν πυροδοτείται για Enter ή Tab σε input κειμένου.

event.key. Ο χαρακτήρας ή το όνομα πλήκτρου αφού το λειτουργικό σύστημα εφαρμόσει τη διάταξη πληκτρολογίου.

event.code. Το φυσικό πλήκτρο, όπως Digit1 ή Numpad1. Μπορεί να μείνει το ίδιο όταν μια ασυμφωνία διάταξης αλλάζει το event.key.

Εστίαση. Καταγράψτε το document.activeElement πριν από τη σάρωση. Αν δεν είναι το πεδίο QR, το υπόλοιπο ίχνος περιγράφει το λάθος στοιχείο ελέγχου. Ένα iframe έχει δική του εστίαση.

Σειρά. Για σάρωση σφήνας σε πεδίο κειμένου, τα εκτυπώσιμα συμβάντα keydown ακολουθούνται από ενημερώσεις input, έπειτα από ένα τελικό keydown για Enter ή Tab όταν αυτή η κατάληξη είναι ρυθμισμένη. Το change πυροδοτείται όταν το πεδίο οριστικοποιεί την τιμή, συνήθως στο blur. Μια σάρωση που αφήνει την εστίαση στο ίδιο πεδίο δεν παράγει change στο τέλος. Μην χρησιμοποιείτε το change ως μοναδικό σήμα ολοκλήρωσης.

Χρονισμός. Οι σαρωτές συχνά τελειώνουν ένα σύντομο φορτίο αρκετά κάτω από ένα δευτερόλεπτο. Ο ελεγκτής εισαγωγής συγκρίνει το μέσο κενό ανάμεσα στους χαρακτήρες με όριο 100 ms και επισημαίνει το αποτέλεσμα ως χρονισμό, όχι ως αναγνώριση υλικού. Κάποιος που πληκτρολογεί γρήγορα, η αυτόματη συμπλήρωση ή ο εξομοιωτής μπορούν να πέσουν στην πλευρά του σαρωτή αυτού του ορίου. Μια καθυστερημένη σάρωση Bluetooth μπορεί να μοιάζει με πληκτρολόγηση. Ελέγξτε το φορτίο και την κατάληξη. Αντιμετωπίστε τον χρονισμό ως ένδειξη.

Χρησιμοποιήστε τον ελεγκτή συμβάντων πληκτρολογίου, που παραθέτει κάθε keydown και keyup με key, code, τροποποιητές και χρονικές σημάνσεις. Το αρχείο καταγραφής είναι συμβάντα προγράμματος περιήγησης. Δεν είναι ακατέργαστη κίνηση USB.

Δοκιμάστε χωρίς φυσικό σαρωτή QR

Η λογική της εφαρμογής μπορεί να δοκιμαστεί πριν ένας σαρωτής βρεθεί στο γραφείο.

  • Πληκτρολογήστε QR-INPUT-TEST-12345 στο πεδίο και ενεργοποιήστε το Accept. Αυτό ελέγχει την επικύρωση και την εμφάνιση. Δεν ελέγχει την αποκωδικοποίηση ή τις καταλήξεις.
  • Οδηγήστε το ίδιο πεδίο από ένα εργαλείο αυτοματοποίησης προγράμματος περιήγησης, όπως κάνει η επόμενη ενότητα.
  • Χρησιμοποιήστε το Barcode Scanner Emulator όταν χρειάζεστε πληκτρολόγηση σε στυλ σαρωτή. Η εφαρμογή επιτραπέζιου υπολογιστή στέλνει μια τιμή που εισάγετε, με καθυστέρηση πληκτρολόγησης και κατάληξη καμία, ENTER ή TAB, στην εστιασμένη εφαρμογή. Αναπαράγει τη διαδρομή πληκτρολογίου. Δεν φωτογραφίζει εικόνα QR, δεν αποκωδικοποιεί σύμβολο και δεν δημιουργεί εικονική θύρα COM.

Το υλικό εξακολουθεί να απαιτείται για την οπτική συμπεριφορά και τη συμπεριφορά της συσκευής: αν αυτός ο σαρωτής μπορεί να διαβάσει τον εμφανιζόμενο ή εκτυπωμένο κώδικα, αν η συμβολολογία QR είναι ενεργή, τη διάταξη πληκτρολογίου, τη ρύθμιση κατάληξης και τις σειριακές λειτουργίες ή τις λειτουργίες SDK κατασκευαστή. Ο εξομοιωτής είναι ο σωστός έλεγχος για τη διαδρομή πληκτρολογίου. Είναι ο λάθος έλεγχος για να αποδειχθεί ότι μια συσκευή διαβάζει έναν συγκεκριμένο κώδικα QR.

Αυτοματοποιήστε τις δοκιμές εισαγωγής QR

Οι ακόλουθες δοκιμές Playwright οδηγούν τη σελίδα παραδείγματος. Πληκτρολογούν στο πεδίο όπως θα έκανε ένας σαρωτής σφήνας και έπειτα ελέγχουν τη συμπεριφορά της εφαρμογής. Δεν ανοίγουν συσκευές USB. Το @playwright/test είναι εξάρτηση για όποιον εκτελεί το παράδειγμα. Αυτός ο ιστότοπος δεν την απαιτεί.

Αποθηκεύστε το παράδειγμα HTML ως qr-form.html δίπλα σε αυτή τη δοκιμή.

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 εισάγει χαρακτήρες στο εστιασμένο πεδίο. Δεν είναι συσκευή USB. Η δοκιμή απροσδόκητων χαρακτήρων χρησιμοποιεί fill, γιατί ο στόχος είναι το μήνυμα επικύρωσης και η απουσία εισαγόμενου στοιχείου. Επεκτείνετε το αρχείο με μια περίπτωση URL και μια περίπτωση JSON όταν αυτές οι μορφές υπάρχουν στην έκδοση που διαθέτετε. Ένας έλεγχος URL πρέπει να συγκρίνει το καταγεγραμμένο κείμενο με την αρχική συμβολοσειρά QR.

Μήτρα δοκιμών σαρωτή QR

Εκτελέστε τις στην εφαρμογή υπό δοκιμή. Η σελίδα παραδείγματος παραπάνω καλύπτει τις γραμμές εισιτηρίου, URL, JSON, διπλότυπου, κενού και απροσδόκητων χαρακτήρων. Μια εφαρμογή μόνο αριθμών ή πολλών γραμμών χρειάζεται το δικό της αναμενόμενο αποτέλεσμα.

Σενάριο Αναμενόμενο αποτέλεσμα
QR απλού κειμένου Ελήφθη η ακριβής τιμή
QR με URL Καταγράφηκε το πλήρες URL και η σελίδα δεν μεταβαίνει σε αυτό
Αριθμητικό QR Τα ψηφία διατηρήθηκαν
Ειδικοί χαρακτήρες Ελήφθησαν οι σωστοί χαρακτήρες
Φορτίο JSON Τα δεδομένα καταγράφηκαν και επικυρώθηκαν
Κατάληξη ENTER Η επεξεργασία γίνεται μία φορά
Κατάληξη TAB Η συμπεριφορά εστίασης αντιμετωπίστηκε
Χωρίς κατάληξη Η εφαρμογή χρησιμοποιεί εναλλακτικό μηχανισμό ολοκλήρωσης
Διπλή σάρωση Η εφαρμογή εφαρμόζει τους κανόνες διπλότυπων
Άκυρο φορτίο Εμφανίστηκε σφάλμα επικύρωσης
Εστίαση που λείπει Η εφαρμογή χειρίζεται με ασφάλεια την απούσα εισαγωγή
Μακρύ φορτίο Χωρίς ακούσια περικοπή

Σαρώστε και ένα φορτίο που περιέχει νέα γραμμή, αν το προϊόν πρέπει να αποθηκεύσει μία. Σημειώστε αν το πεδίο έλαβε κάθε γραμμή.

Αντιμετώπιση προβλημάτων

Ξεκινήστε με γνωστό φορτίο στον ελεγκτή εισαγωγής. Αν η τιμή του ελεγκτή είναι ήδη λάθος, η σελίδα δεν είναι το πρώτο σφάλμα. Αν η τιμή του ελεγκτή είναι σωστή και η εφαρμογή είναι λάθος, το σφάλμα είναι η εστίαση, η επικύρωση ή ο χειρισμός συμβάντων. Ο σαρωτής γραμμωτού κώδικα δεν λειτουργεί είναι η ευρύτερη λίστα ελέγχου της συσκευής. Το Πώς να δοκιμάσετε την εισαγωγή σαρωτή γραμμωτού κώδικα καλύπτει την εστίαση, τη διάταξη και τις ροές POS πέρα από αυτή τη φόρμα.

Ο σαρωτής ηχεί αλλά δεν εμφανίζεται εισαγωγή

Ένας ήχος συνήθως σημαίνει ότι ο σαρωτής αποκωδικοποίησε ένα σύμβολο. Δεν σημαίνει ότι η σελίδα έλαβε το κείμενο. Επιβεβαιώστε τη λειτουργία σφήνας πληκτρολογίου. Οι λειτουργίες σειριακή και κάμερας δεν θα πληκτρολογήσουν στο πεδίο. Κάντε κλικ στο πεδίο ώστε το document.activeElement να είναι αυτό το input, έπειτα σαρώστε ξανά. Ένα απενεργοποιημένο, μόνο για ανάγνωση ή κρυφό πεδίο μπορεί να αγνοήσει τα πλήκτρα.

Ο σαρωτής QR λειτουργεί στο Notepad αλλά όχι στο πρόγραμμα περιήγησης

Η συσκευή πληκτρολογεί. Η σελίδα δεν δέχεται αυτά τα πλήκτρα. Ελέγξτε την εστίαση, έναν ακροατή keydown που καλεί preventDefault() σε εκτυπώσιμα πλήκτρα και έναν ακροατή που χειρίζεται μόνο το paste. Η εισαγωγή σφήνας δεν πυροδοτεί συμβάν paste. Συγκρίνετε το αποτέλεσμα του ελεγκτή με το πεδίο της εφαρμογής.

Ο σαρωτής διαβάζει γραμμωτούς κώδικες αλλά όχι κώδικες QR

Η συσκευή μπορεί να είναι μόνο 1D, ή η συμβολολογία QR μπορεί να είναι απενεργοποιημένη. Η σελίδα δεν μπορεί να το διορθώσει. Επιβεβαιώστε την υποστήριξη 2D και ενεργοποιήστε το QR Code από το εγχειρίδιο της συσκευής, χρησιμοποιώντας τους ελέγχους στο Δοκιμή κωδίκων QR: πώς να δοκιμάσετε σαρωτές κωδίκων QR. Μια επιτυχής σάρωση Code 128 αποδεικνύει μόνο τη διαδρομή πληκτρολογίου.

Λανθασμένοι χαρακτήρες

Σαρώστε πρώτα QR-INPUT-TEST-12345. Αν αυτό ταιριάζει και ένα φορτίο URL ή JSON όχι, η διάταξη αλλάζει στίξη όπως :, /, { ή ". Συγκρίνετε το event.key με το event.code στον ελεγκτή συμβάντων πληκτρολογίου και δείτε το Λανθασμένη διάταξη πληκτρολογίου στον σαρωτή γραμμωτού κώδικα. Ταιριάξτε τη διάταξη πληκτρολογίου του σαρωτή με το λειτουργικό σύστημα.

Το ENTER υποβάλλει τη φόρμα δύο φορές

Το πρόγραμμα περιήγησης υποβάλλει τη φόρμα, και ένας ακροατής keydown χειρίζεται επίσης το Enter. Κρατήστε μία διαδρομή ολοκλήρωσης και καλέστε εκεί το preventDefault(). Μια δεύτερη φυσική σάρωση είναι διαφορετική αποτυχία. Το κείμενο κατάστασης στο παράδειγμα λέει ότι το φορτίο είχε ήδη γίνει αποδεκτό. Αν η ίδια η πρώτη σάρωση δημιουργεί δύο εγγραφές, αναζητήστε δύο ακροατές πριν αλλάξετε τον σαρωτή.

Η εισαγωγή QR περικόπτεται

Συγκρίνετε τον αριθμό χαρακτήρων στον ελεγκτή εισαγωγής με την τιμή στο πεδίο. Ένα χαρακτηριστικό maxlength, μια μάσκα input ή το preventDefault() σε πλήκτρα χαρακτήρων μπορούν να κόψουν τη συμβολοσειρά. Μια νέα γραμμή μέσα στο φορτίο QR μπορεί να υποβάλει νωρίς ένα input μίας γραμμής. Ορισμένοι σαρωτές περιορίζουν επίσης πόσοι χαρακτήρες πληκτρολογούν. Ανεβάστε αυτό το όριο από το εγχειρίδιο της συσκευής όταν ο ελεγκτής, όχι μόνο η εφαρμογή, δείχνει σύντομη τιμή. Το Λείπει το ENTER από τον σαρωτή γραμμωτού κώδικα καλύπτει τη σχετική περίπτωση όπου το φορτίο φτάνει και η φόρμα δεν οριστικοποιείται ποτέ.

Ο σαρωτής δεν μπορεί να διαβάσει κώδικα QR στην οθόνη

Επιβεβαιώστε ότι ο σαρωτής είναι 2D imager. Αυξήστε τη φωτεινότητα της οθόνης, μεγαλώστε το μέγεθος του κώδικα και κρατήστε την ήσυχη ζώνη καθαρή από κείμενο και περιγράμματα. Η αντανάκλαση, μια αχνή οθόνη τηλεφώνου και ένας κώδικας πολύ πυκνός για την απόσταση εργασίας είναι οπτικά προβλήματα. Εκτυπώστε το ίδιο φορτίο αν η ανάγνωση από την οθόνη συνεχίζει να αποτυγχάνει. Η δοκιμή της εφαρμογής εξακολουθεί να χρησιμοποιεί τη γνωστή συμβολοσειρά μόλις οποιαδήποτε σάρωση παράγει κείμενο.