Passer au contenu

Barcode Scanner Emulator

Comment mettre à l'essai les scanneurs de codes à barres dans les applications web

Bien des scanneurs de codes à barres USB et Bluetooth envoient les données décodées comme une saisie clavier. Un champ qui a le focus dans une application web peut donc recevoir une lecture sans API de navigateur propre au scanneur. Les ports série et les kits SDK du fabricant sont des intégrations à part. Vous pouvez mettre à l'essai le chemin clavier avec un scanneur physique ou avec des frappes simulées.

Une application web voit d'ordinaire un scanneur de codes à barres comme un clavier. L'essai vérifie si la zone qui a le focus reçoit le contenu que votre application attend, et si la page traite le terminateur que le scanneur est réglé pour envoyer. Ce terminateur peut être Enter, Tab ou rien du tout.

Servez-vous d'une session de l'outil d'essai de saisie de codes à barres lorsqu'un scanneur physique est branché. Servez-vous du Barcode Scanner Emulator lorsque vous avez besoin du même chemin clavier pendant le développement et que le matériel n'est pas sur le bureau. Un tour plus large du focus, de la disposition et des processus de POS se trouve dans Comment mettre à l'essai la saisie d'un scanneur de codes à barres. Ce guide reste sur l'application dans le navigateur : la capture, les suffixes, la validation et les événements que vous pouvez vraiment observer.

Comment les scanneurs de codes à barres communiquent avec les applications web

Le mode d'interface décide de ce que la page peut recevoir. Confirmez-le avant de changer le code du formulaire. Un scanneur peut souvent changer de mode en lisant un code à barres de configuration tiré du guide du fabricant.

Mode en coin de clavier HID USB

En mode clavier HID USB, le scanneur s'énumère comme un clavier. Le système d'exploitation charge son pilote de clavier habituel. Une fois le symbole décodé, le scanneur envoie les caractères comme des frappes vers la zone qui a le focus du clavier. La page écoute ces frappes, ou elle lit le texte qu'elles insèrent. Elle n'ouvre pas de connexion vers l'appareil.

C'est pourquoi une zone de caisse, une zone de recherche ou toute autre saisie de texte peut accepter une lecture avec du HTML ordinaire. Le guide Mode en coin de clavier HID décrit plus en détail la suite des frappes, les préfixes et les suffixes.

HID Bluetooth

Un scanneur Bluetooth jumelé comme clavier suit le même chemin dans l'application. L'hôte le traite comme un clavier HID, et la zone qui a le focus reçoit les frappes. Le jumelage, la pile et la radio sont des questions d'appareil. Dès que les caractères arrivent dans le navigateur, la page les traite de la même façon qu'une saisie en mode en coin USB.

Port série et port COM virtuel

Un scanneur série, y compris plusieurs modes de port COM virtuel USB, envoie le texte décodé sous forme d'octets sur un port. Le focus ne choisit pas la destination. C'est le processus qui ouvre le port qui le fait. Une zone de texte qui n'écoute que les frappes ne verra pas ce flux.

Les navigateurs fondés sur Chromium peuvent ouvrir un port série grâce à la Web Serial API après que l'utilisateur a choisi le port et accordé la permission. Firefox et Safari n'offrent pas cette API. Un essai en mode en coin n'exerce pas une intégration série, et un essai série ne dit pas ce qu'un scanneur en mode en coin va taper.

Interfaces propres au fabricant

Certains appareils utilisent un kit SDK du fabricant, OPOS, JPOS, ou une interface HID qui n'est pas un clavier, comme USB HID POS. Ces interfaces n'écrivent pas dans la zone qui a le focus. Une page web ordinaire ne peut pas charger un SDK natif. Chromium peut demander certains appareils HID qui ne sont pas des claviers au moyen de WebHID, après un geste de l'utilisateur. Les appareils HID de la classe clavier restent bloqués. Un scanneur en mode en coin reste donc impossible à distinguer d'un clavier. Traitez une interface de fabricant comme une intégration à part et mettez-la à l'essai avec le logiciel qui ouvre vraiment cette interface.

Ce que le navigateur peut voir

Une lecture en mode en coin arrive sous forme d'événements keydown et keyup, et les caractères imprimables mettent à jour la zone qui a le focus. Le navigateur ne reçoit pas de nom d'appareil, de numéro de série USB ni d'indicateur qui annoncerait un scanneur. Les navigateurs qui mettent en oeuvre WebHID refusent encore les interfaces clavier. Le script de la page ne peut donc pas lire non plus les rapports HID bruts d'un scanneur en mode en coin.

event.key est le caractère ou le nom de touche après que le système d'exploitation a appliqué la disposition du clavier active. event.code nomme la touche physique, comme Digit1 ou Numpad1, et peut rester le même lorsqu'un écart de disposition change event.key. Ni l'une ni l'autre de ces propriétés n'identifie le matériel.

Comment mettre à l'essai un scanneur de codes à barres physique dans un navigateur

Faites ceci avant de déboguer le code de l'application. Vous verrez la chaîne exacte et le terminateur que le navigateur a reçus.

  1. Branchez le scanneur et attendez qu'il indique qu'il est alimenté. Pour le Bluetooth, terminez le jumelage et confirmez que l'hôte utilise un profil de clavier.
  2. Confirmez le mode de saisie. Le mode en coin de clavier, le clavier HID USB ou le clavier HID Bluetooth peuvent écrire dans une zone. Les modes série, SPP et SDK du fabricant ne le peuvent pas.
  3. Ouvrez l'outil d'essai de saisie de codes à barres.
  4. Cliquez sur Démarrer l'essai, ou cliquez sur la zone de lecture. Elle devient bleue lorsqu'elle est prête. La page ne prend pas le focus d'elle-même.
  5. Lisez un code à barres dont vous connaissez déjà le contenu. Commencez par une courte valeur numérique, puis lisez une valeur qui contient la ponctuation que votre application conserve.
  6. Lisez la valeur captée et le nombre de caractères. Comparez les deux au contenu attendu, y compris tout préfixe que le scanneur insère avant les données.
  7. Vérifiez le suffixe. L'outil signale ENTER, TAB ou Aucun. Lorsque Capture automatique est activée, le résultat apparaît après Enter, Tab ou une courte pause une fois les touches arrêtées. Désactivez Capture automatique si vous voulez que la capture reste en attente jusqu'à ce que vous appuyiez sur Arrêter.
  8. Comparez ce résultat à la chaîne que votre application doit conserver. Un préfixe, un caractère remplacé ou un terminateur manquant doit être corrigé dans la configuration du scanneur ou traité exprès dans la page. Ne le prenez pas pour un échec de décodage tant que cette comparaison n'est pas faite.

L'outil enregistre les événements clavier que le navigateur peut voir. Il ne peut pas identifier le périphérique USB ni lire un port série. Lorsque l'éditeur de texte reçoit la lecture et que le navigateur ne la reçoit pas, poursuivez avec Le scanneur fonctionne dans Notepad mais pas au POS.

Capter la saisie d'un scanneur de codes à barres avec JavaScript

Un scanneur écrit dans l'élément qui a le focus. Donnez à la zone un libellé visible, laissez-la en saisie de texte ordinaire pour que les personnes au clavier puissent taper un code, et lisez la valeur lorsque le processus indique que la saisie est complète. La page ci-dessous fait cela. Enter envoie le formulaire une seule fois. Tab termine une valeur non vide, puis laisse le navigateur déplacer le focus. Une lecture sans terminateur reste dans la zone jusqu'à ce que quelqu'un active Look up.

<!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <meta name="viewport" content="width=device-width, initial-scale=1">
  <title>Barcode input example</title>
</head>
<body>
  <form id="barcode-form">
    <label for="barcode">Barcode</label>
    <input id="barcode" name="barcode" type="text" autocomplete="off" spellcheck="false">
    <button type="submit">Look up</button>
  </form>
  <p id="message" role="status"></p>
  <ul id="accepted"></ul>
  <script>
    const form = document.querySelector('#barcode-form')
    const field = document.querySelector('#barcode')
    const message = document.querySelector('#message')
    const list = document.querySelector('#accepted')

    if (
      !(form instanceof HTMLFormElement) ||
      !(field instanceof HTMLInputElement) ||
      !(message instanceof HTMLElement) ||
      !(list instanceof HTMLUListElement)
    ) {
      throw new Error('Barcode form markup is missing.')
    }

    function payload(raw) {
      return raw.replace(/[\r\n]/g, '').trim()
    }

    function classify(raw) {
      const value = payload(raw)
      if (!value) {
        return { status: 'empty' }
      }
      if (/[\u0000-\u001F\u007F]/.test(value)) {
        return {
          status: 'invalid',
          message: 'Control character in the barcode. Check the prefix, suffix, and symbology identifier.',
        }
      }
      return { status: 'ok', value }
    }

    function accept(value) {
      const item = document.createElement('li')
      item.textContent = value
      list.append(item)
      message.textContent = 'Accepted ' + value
      field.value = ''
    }

    function reject(text) {
      message.textContent = text
    }

    form.addEventListener('submit', (event) => {
      event.preventDefault()
      const outcome = classify(field.value)
      if (outcome.status === 'empty') {
        reject('No barcode received.')
        field.focus()
        return
      }
      if (outcome.status === 'invalid') {
        reject(outcome.message)
        field.focus()
        return
      }
      accept(outcome.value)
      field.focus()
    })

    field.addEventListener('keydown', (event) => {
      if (event.key !== 'Tab' || event.shiftKey) {
        return
      }
      const outcome = classify(field.value)
      if (outcome.status === 'empty') {
        return
      }
      if (outcome.status === 'invalid') {
        event.preventDefault()
        reject(outcome.message)
        return
      }
      accept(outcome.value)
    })

    field.focus()
  </script>
</body>
</html>

Enregistrez ce fichier et ouvrez-le dans un navigateur de bureau. Cliquez sur la zone si le focus a bougé. Un scanneur en mode en coin, ou l'émulateur de la section suivante, écrit alors dans #barcode.

Le focus est nécessaire. Si document.activeElement est le corps du document, un bouton ou une autre saisie, les écouteurs de cette zone ne voient pas la lecture. Les caractères aboutissent dans la zone qui a le focus, ou ils sont perdus. Appelez field.focus() lorsque le processus est prêt pour une lecture, y compris après la fermeture d'une boîte de dialogue.

Une saisie vide est ignorée. Le formulaire reste en place, et le texte d'état indique que rien n'a été reçu. L'espace seul est vide après trim().

L'exemple n'ajoute ni Enter ni Tab. Si le scanneur n'est pas réglé pour les envoyer, la valeur reste dans la zone et Look up est le chemin de fin. autocomplete="off" réduit le risque qu'une valeur enregistrée remplace la lecture. Le libellé, le bouton et Shift+Tab restent offerts, pour qu'une personne puisse entrer un code sans scanneur.

Traitez Enter à un seul endroit. Cet exemple utilise l'événement submit du formulaire, qui couvre aussi le bouton Look up et un Enter du clavier. Un deuxième écouteur keydown pour Enter inscrirait la même lecture deux fois. Si la saisie n'est pas dans un formulaire, écoutez Enter sur keydown et appelez preventDefault() pour qu'un formulaire parent ne s'envoie pas en plus :

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

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

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

Videz la zone après une acceptation réussie pour que la lecture suivante ne s'ajoute pas au contenu précédent. Après Enter, l'exemple redonne le focus à la même zone, parce que ce processus attend une autre lecture dans la même case. Après Tab, il laisse le focus tranquille pour que le navigateur puisse passer à la zone suivante.

Traiter les suffixes ENTER et TAB

Un suffixe est une touche que le scanneur peut envoyer après le contenu. C'est un réglage de l'appareil. Enter est courant, et il est facultatif. Le guide Suffixes ENTER et TAB des scanneurs de codes à barres explique comment distinguer les terminateurs. Confirmez le réglage sur le scanneur que vous mettez à l'essai, puis faites correspondre la page à ce processus.

ENTER

Enter dans une zone de texte d'une seule ligne envoie le formulaire qui l'entoure dans les navigateurs actuels. Utilisez cela lorsqu'une lecture doit valider la valeur, comme dans une zone de recherche. preventDefault() sur l'événement submit empêche le navigateur de quitter la page. Omettez-le lorsqu'une navigation de page entière est le comportement voulu.

Si le code à barres apparaît et que le formulaire ne fait rien, le scanneur n'envoie peut-être aucun suffixe. Le scanneur de codes à barres n'envoie pas ENTER passe en revue cette configuration. Certains appareils envoient NumPad Enter. event.key vaut toujours "Enter". Vérifiez event.key, et pas seulement event.code === "Enter", sinon ce scanneur aura l'air brisé.

TAB

Tab déplace le focus vers la prochaine zone qui peut le recevoir. Cela convient à une suite comme le code de produit, puis la quantité. Cela surprend un formulaire qui s'attendait à ce qu'Enter envoie les données.

Lisez la valeur dans keydown pendant que la zone a encore le focus. Le navigateur déplace le focus après cet événement. Laissez l'action par défaut en place lorsque la zone suivante doit recevoir le focus. preventDefault() garde le focus là où il est, ce qui est utile lorsque la valeur n'est pas valide et que vous voulez que l'opérateur la voie. Ignorez Shift+Tab pour qu'une personne au clavier puisse reculer dans le formulaire. Un suffixe Tab de scanneur est Tab sans Shift.

Un suffixe Tab peut aussi déplacer le focus avant que votre code lise la zone, si l'écouteur est sur blur ou change et qu'autre chose vide la zone. Lisez la valeur à partir de la cible de l'événement keydown.

Aucun suffixe

Sans suffixe, le contenu reste dans la zone. L'application doit décider quand la lecture est finie. Un bouton explicite, un Enter plus tard de la part de l'opérateur, ou le passage à une autre étape sont des points de fin fiables. Une minuterie d'inactivité peut traiter une pause de frappe comme la fin d'une lecture. Cette minuterie est une heuristique. Un scanneur lent, un délai Bluetooth ou une personne qui tape vite peut tomber du mauvais côté du seuil. Préférez un suffixe configuré lorsque le processus a besoin d'un signal net de fin de lecture.

Écarts de configuration

Des scanneurs de la même marque peuvent être livrés avec des suffixes différents, et un code à barres de configuration peut changer le suffixe sans aucun changement dans votre JavaScript. Certains appareils envoient un préfixe, un identificateur de symbologie comme ]C1, ou CR et LF. Mettez à l'essai les trois réglages de terminateur que vos utilisateurs peuvent vraiment choisir : Enter, Tab et aucun. Notez celui qu'utilisent les scanneurs déployés, et mettez la page à l'essai avec ce réglage.

Validation de la saisie du scanneur de codes à barres

Validez la chaîne que la zone a reçue. Ne supposez pas que chaque code à barres a la même longueur, le même jeu de caractères ou le même chiffre de contrôle. Les contenus Code 128 et QR varient. EAN-13 compte 13 chiffres. Une application qui conserve les deux a besoin de règles pour les deux.

Saisie vide. Rejetez-la ou ignorez-la. Un suffixe sans contenu, ou un clic sur Look up dans une zone vide, ne doit pas créer d'enregistrement.

Caractères imprévus. Comparez la chaîne reçue à une étiquette connue. Un écart de disposition se voit souvent comme un symbole changé, par exemple un chiffre ou une ponctuation décalés, alors que la longueur reste la même. Des caractères de contrôle peuvent venir d'un préfixe ou d'un séparateur de groupe GS1. Autorisez les caractères que votre format définit. L'exemple ci-dessus rejette les caractères de contrôle ASCII pour qu'ils restent visibles dans le texte d'état. Un analyseur GS1 qui attend un séparateur de groupe doit autoriser ce caractère et rejeter le reste.

Longueur. Imposez les longueurs que votre application accepte. Un minimum et un maximum globaux sont plus sûrs qu'une seule longueur exigée lorsque le formulaire reçoit plus d'une symbologie. maxlength sur la saisie tronque en silence un contenu plus long. Ne le définissez que lorsque chaque code accepté y entre.

Préfixe. Ne retirez un préfixe que si vous avez réglé le scanneur pour envoyer exactement ce préfixe et que l'application ne le conserve pas.

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

Un identificateur de symbologie AIM est une donnée si le scanneur est réglé pour le transmettre. Laissez-le en place jusqu'à ce que vous ayez décidé si l'application le conserve.

Suffixe. Gardez le terminateur hors de la valeur conservée. Enter et Tab sont des touches. Ils ne sont pas insérés dans une saisie de texte ordinaire. Un contenu série peut encore comprendre les octets CR ou LF. Retirez-les à la frontière où vous analysez le flux série, et vérifiez que vous ne les retirez pas du milieu d'un contenu qui les contient de façon légitime.

Envois en double. Une lecture peut être traitée deux fois si keydown et submit s'exécutent tous les deux pour le même Enter. Utilisez un seul chemin de fin. Une deuxième lecture du même code est une autre question. Un formulaire d'entrepôt peut augmenter la quantité. Un formulaire de billet peut rejeter un code déjà utilisé. Placez cette règle dans l'application, et mettez-la à l'essai exprès. Le navigateur ne peut pas distinguer un second appui sur la gâchette d'un second écouteur.

Règles de l'application. Les chiffres de contrôle appartiennent à des symbologies précises. EAN-13 utilise le dernier chiffre comme chiffre de contrôle. Cette fonction n'accepte que ce 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 et QR n'utilisent pas ce calcul. Le scanneur a peut-être déjà vérifié sa propre symbologie et transmis les données lisibles par une personne. Validez les formats que vous conservez, et répétez la vérification sur le serveur. La chaîne envoyée est une saisie utilisateur ordinaire. Le navigateur ne peut pas prouver qu'un scanneur l'a produite.

Mettre à l'essai la saisie du scanneur sans matériel physique

Le Barcode Scanner Emulator est une application de bureau pour Windows, macOS et Linux. Vous entrez le texte à envoyer, vous choisissez un délai de frappe et vous choisissez un suffixe parmi aucun, ENTER ou TAB. Un raccourci global tape ce texte dans l'application qui a le focus. Il reproduit le chemin clavier qu'utilise un scanneur en mode en coin. Il n'éclaire pas une étiquette, ne lit pas un symbole et ne décode pas une symbologie.

Utilisez la page d'exemple ci-dessus, ou la page que vous bâtissez :

  1. Ouvrez la page dans un navigateur de bureau et cliquez sur la zone de code à barres.
  2. Dans l'émulateur, entrez une valeur connue comme 123456789012.
  3. Réglez le suffixe sur ENTER. Réglez le délai de frappe si vous voulez que la salve ressemble à un scanneur que vous avez déjà mesuré.
  4. Appuyez sur le raccourci global de lecture de l'émulateur pendant que la zone du navigateur a encore le focus.
  5. Confirmez le texte d'état et le fait que la valeur a été acceptée une seule fois.
  6. Recommencez avec TAB. Le focus doit se déplacer, et la valeur doit être acceptée une seule fois.
  7. Recommencez sans suffixe. Le texte doit rester dans la zone jusqu'à ce que vous activiez Look up.
  8. Donnez le focus à l'outil d'essai de saisie de codes à barres et renvoyez la même valeur. Comparez la chaîne captée, le préfixe et le suffixe à ce que l'application a conservé.

L'installation et le premier raccourci sont décrits dans Pour commencer. Après un changement de réglages, envoyez une lecture dans l'outil de saisie avant de vous fier au résultat dans l'application.

Le matériel reste nécessaire pour les parties optiques et propres à l'appareil de l'essai :

  • Si ce scanneur peut décoder le symbole imprimé ou affiché, y compris les étiquettes endommagées, la taille, le contraste et la distance.
  • La prise en charge des symbologies. Un scanneur laser 1D ne peut pas lire un code QR. Voir Essai des codes QR : comment mettre à l'essai les scanneurs de QR.
  • L'énumération USB, le jumelage Bluetooth, et la configuration propre au scanneur pour la disposition du clavier et le suffixe.
  • Les intégrations série, HID POS et SDK du fabricant.

L'émulateur est le bon outil pour la logique de l'application le long du chemin clavier. C'est le mauvais outil pour prouver qu'un scanneur donné lit une étiquette donnée.

Déboguer les événements clavier du scanneur de codes à barres

Observez les événements dans cet ordre lorsque la valeur conservée est fausse.

keydown. Se déclenche pour chaque touche, y compris Enter et Tab, avant que le navigateur insère un caractère ou déplace le focus. Lisez le terminateur ici. event.repeat est vrai lorsqu'une touche est maintenue. Un scanneur en mode en coin envoie en principe une pression distincte pour chaque caractère.

input. Se déclenche sur la zone après qu'un caractère imprimable a changé sa valeur. C'est le bon événement à observer si vous avez besoin du texte à mesure qu'il grandit. Il ne se déclenche pas pour Enter ni pour Tab, parce que ces touches n'insèrent pas de caractère dans une saisie de texte.

change. Se déclenche après que la valeur est validée, en général lorsque la zone perd le focus. Un scanneur qui laisse le focus dans la même zone ne produira pas change à la fin de la lecture. N'utilisez pas change comme seul signal de fin.

event.key et event.code. Inscrivez les deux au journal lorsqu'un caractère est faux. Un écart entre la disposition du scanneur et celle du système d'exploitation change event.key et laisse event.code comme la touche que le scanneur visait. Les chiffres du pavé numérique utilisent Numpad1 et des codes semblables. Certains masques de saisie les traitent autrement que Digit1. Mauvaise disposition du clavier du scanneur de codes à barres explique l'écart de disposition.

Focus. Inscrivez document.activeElement au journal juste avant une lecture. Si ce n'est pas la zone de code à barres, le reste de la trace explique la mauvaise zone. Les iframes ont leur propre focus. Une lecture dans un cadre intégré est visible pour le script à l'intérieur de ce cadre.

Minutage. Les scanneurs terminent souvent un contenu court bien en deçà d'une seconde. L'outil de saisie compare l'écart moyen entre les caractères à un seuil de 100 ms et étiquette le résultat comme un minutage, pas comme une identification du matériel. Un seuil d'écart peut traiter une personne qui tape vite, le remplissage automatique ou l'émulateur comme un scanneur. Un scanneur avec un délai entre les caractères, un lien Bluetooth ou un contenu long peut ressembler à de la frappe. Utilisez la valeur captée et le suffixe. Utilisez le minutage comme un indice.

L'outil d'essai des événements clavier dresse la liste de chaque keydown et keyup avec key, code, les touches de modification et les horodatages. Servez-vous-en lorsque la chaîne assemblée cache une touche de préfixe ou un code de pavé numérique. Le journal contient des événements du navigateur. Ce n'est pas du trafic USB brut.

Problèmes courants dans les applications web

La lecture aboutit dans la mauvaise zone. La saisie en mode en coin suit le focus. Cliquez sur la zone cible après chaque navigation, boîte de dialogue ou message de validation qui déplace le focus. Une boîte modale sans zone de texte peut avaler la lecture comme des raccourcis.

Le scanneur fonctionne dans un éditeur de texte et pas dans le navigateur. L'appareil écrit. La page n'accepte pas ces touches. Vérifiez le focus, une saisie désactivée ou en lecture seule, et un écouteur keydown qui appelle preventDefault() sur les touches imprimables. Un écouteur qui ne traite que paste ne voit jamais la saisie en mode en coin. Commencez par Le scanneur de codes à barres ne fonctionne pas si aucune application ne reçoit de caractères.

Enter envoie le formulaire deux fois ou quitte la page. Le navigateur envoie le formulaire, et votre écouteur traite aussi Enter. Appelez preventDefault() sur l'un de ces chemins et traitez la valeur une seule fois. Un formulaire à plusieurs zones peut s'envoyer avant que les zones suivantes soient remplies lorsque le scanneur envoie Enter. Utilisez Tab pour ce processus, ou empêchez l'envoi jusqu'à ce que le formulaire soit complet.

Tab change le focus. C'est la touche Tab. Réglez Enter sur le scanneur, ou lisez la valeur dans keydown et laissez le focus se déplacer. Voyez la section des suffixes plus haut.

La disposition du clavier est mauvaise. Les chiffres peuvent survivre à un écart qui change la ponctuation. Lisez une valeur connue qui contient les symboles que vous conservez, sur la disposition que le poste utilise vraiment.

La même lecture crée deux enregistrements. Cherchez deux écouteurs sur un même Enter avant de chercher deux lectures physiques. Mettez ensuite à l'essai une deuxième lecture voulue et confirmez la règle de quantité ou de doublon que votre application documente.

La valeur manque ou est tronquée. Un attribut maxlength, un masque de saisie ou preventDefault() sur les touches de caractères peut laisser tomber ou couper le contenu. Comparez le nombre de caractères dans l'outil de saisie à la valeur de votre zone. Un préfixe peut aussi faire paraître trop long un contenu correct.

Les codes QR n'apparaissent jamais. Le scanneur est peut-être limité au 1D, ou la symbologie QR est peut-être désactivée. L'application ne peut pas corriger cela. Confirmez le matériel avec Essai des codes QR : comment mettre à l'essai les scanneurs de QR, puis revenez à l'essai de la zone.

Liste de contrôle pour l'essai de l'application web

Utilisez-la sur la version que vous comptez livrer, dans chaque navigateur que vous prenez en charge. Vérifiez un profil neuf ainsi qu'un profil avec des extensions de gestionnaire de mots de passe et de remplissage automatique, parce que ces extensions déplacent le focus.

  • Le scanneur est branché ou jumelé, et l'hôte le montre prêt.
  • Le scanneur est en mode en coin de clavier, pas en série ni dans un mode SDK du fabricant.
  • La zone de code à barres a le focus juste avant la lecture. document.activeElement est cette zone.
  • Un code à barres connu arrive caractère par caractère, longueur comprise.
  • Un suffixe ENTER envoie ou accepte la valeur une seule fois et ne laisse pas le terminateur dans la chaîne conservée.
  • Un suffixe TAB déplace le focus vers la zone voulue, et la valeur est lue avant le déplacement.
  • Une configuration sans suffixe laisse la valeur offerte jusqu'à ce que l'application la termine.
  • Un envoi vide est rejeté ou ignoré.
  • Une lecture ne crée pas deux enregistrements. Une deuxième lecture réelle suit la règle de doublon de l'application.
  • La ponctuation, les symboles et tout séparateur GS1 que vos formats utilisent survivent à l'aller-retour.
  • La disposition du clavier du scanneur et celle du système d'exploitation produisent les caractères imprimés sur l'étiquette.
  • Après un débranchement et un rebranchement, ou après une coupure du lien Bluetooth, la lecture suivante atteint encore la zone.
  • Plusieurs lectures d'affilée restent des valeurs distinctes. La zone ne les concatène pas.
  • Les mêmes vérifications réussissent dans les navigateurs que vous prenez en charge, avec et sans les extensions courantes de remplissage automatique.

Pour les boîtes de dialogue, l'ordre de tabulation sur tout un passage à la caisse et les flux de quantité au POS, poursuivez avec Comment mettre à l'essai la saisie d'un scanneur de codes à barres.

Matrice de cas d'essai

La colonne scanneur est ce que font l'appareil et le navigateur. La colonne comportement attendu est ce que l'application doit faire en réponse. Les règles d'affaires, par exemple si un code de produit répété augmente la quantité, appartiennent à l'application. Énoncez-les dans l'essai au lieu de supposer une seule règle pour chaque produit.

Scénario Comportement attendu
Code à barres valide L'application accepte la valeur et conserve le contenu sans le terminateur.
Saisie vide L'application la rejette ou l'ignore et ne crée pas d'enregistrement.
Suffixe ENTER L'application envoie ou accepte la valeur une seule fois.
Suffixe TAB Le focus passe à la zone suivante voulue, et la valeur est conservée.
Aucun suffixe La saisie reste offerte jusqu'à ce que l'application la traite.
Lectures rapides à répétition Chaque valeur est traitée séparément et n'est pas concaténée avec la précédente.
Mauvaise disposition du clavier Les caractères imprévus sont visibles dans la valeur captée et échouent à la validation.
Lecture en double L'application suit sa propre règle de doublon, par exemple augmenter la quantité ou rejeter une répétition.
Format de code à barres non valide L'application affiche l'erreur de validation de ce format et ne conserve pas la valeur.
Focus de saisie perdu L'application n'invente pas de code à barres. La lecture est absente ou aboutit dans la zone qui a le focus, et la page reste dans un état sûr.

Jouez les lignes valide, vide, ENTER, TAB et aucun suffixe avec le scanneur physique, puis de nouveau avec l'émulateur. Jouez les lignes disposition du clavier, QR et reconnexion sur le matériel. Ces lignes dépendent de l'appareil, de l'étiquette ou de la disposition du système d'exploitation, ce que des frappes simulées ne reproduisent pas.