Aller au contenu

Barcode Scanner Emulator

Comment tester les lecteurs de codes-barres dans les applications web

Beaucoup de lecteurs de codes-barres USB et Bluetooth envoient les données décodées comme une saisie clavier, si bien qu'un champ focalisé dans une application web peut recevoir une lecture sans API de navigateur propre au lecteur. Les ports série et les SDK du fabricant sont des intégrations distinctes. Vous pouvez tester le chemin clavier avec un lecteur physique ou avec des frappes simulées.

Une application web voit en général un lecteur de codes-barres comme un clavier. Le test consiste à vérifier que le contrôle focalisé reçoit le contenu que votre application attend, et que la page gère le terminateur que le lecteur est configuré pour envoyer. Ce terminateur peut être Enter, Tab, ou rien.

Utilisez une session du testeur de saisie de codes-barres lorsqu'un lecteur physique est branché. Utilisez le 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 passage plus large sur le focus, la disposition et les flux POS se trouve dans Comment tester la saisie d'un lecteur de codes-barres. Ce guide reste sur l'application dans le navigateur : capture, suffixes, validation et événements que vous pouvez réellement observer.

Comment les lecteurs 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 modifier le code du formulaire. Un lecteur peut souvent changer de mode en lisant un code-barres de configuration du manuel du fabricant.

Émulation clavier HID USB

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

C'est pour cela qu'un champ de caisse, une zone de recherche ou toute autre saisie de texte peut accepter une lecture avec du HTML ordinaire. Le guide Émulation clavier HID décrit plus en détail la séquence de frappes, les préfixes et les suffixes.

HID Bluetooth

Un lecteur Bluetooth appairé comme clavier emprunte le même chemin applicatif. L'hôte le traite comme un clavier HID, et le champ focalisé reçoit les frappes. L'appairage, la batterie et la radio sont des questions d'appareil. Une fois les caractères arrivés dans le navigateur, la page les traite comme une saisie en émulation USB.

Port série et port COM virtuel

Un lecteur série, y compris de nombreux 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. Un champ 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 par la Web Serial API après que l'utilisateur a choisi le port et accordé l'autorisation. Firefox et Safari ne fournissent pas cette API. Un test en émulation clavier n'exerce pas une intégration série, et un test série ne dit pas ce qu'un lecteur en émulation tapera.

Interfaces propres au fabricant

Certains appareils utilisent un SDK du fabricant, OPOS, JPOS, ou une interface HID qui n'est pas un clavier, comme USB HID POS. Ces interfaces ne saisissent pas dans le champ focalisé. Une page web ordinaire ne peut pas charger un SDK natif. Chromium peut demander certains appareils HID qui ne sont pas des claviers via WebHID après un geste de l'utilisateur. Les appareils HID de la classe clavier restent bloqués, si bien qu'un lecteur en émulation reste impossible à distinguer d'un clavier. Traitez une interface de fabricant comme sa propre intégration et testez-la avec le logiciel qui ouvre réellement cette interface.

Ce que le navigateur peut voir

Une lecture en émulation arrive sous forme d'événements keydown et keyup, et les caractères imprimables mettent à jour le champ focalisé. Le navigateur ne reçoit pas de nom d'appareil, de numéro de série USB, ni d'indicateur qui dirait qu'il s'agit d'un lecteur. Les navigateurs qui implémentent WebHID refusent encore les interfaces clavier, donc le script de la page ne peut pas non plus lire les rapports HID bruts d'un lecteur en émulation.

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

Comment tester un lecteur de codes-barres physique dans un navigateur

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

  1. Branchez le lecteur et attendez qu'il indique qu'il est alimenté. Pour le Bluetooth, terminez l'appairage et confirmez que l'hôte utilise un profil clavier.
  2. Confirmez le mode de saisie. L'émulation clavier, le clavier HID USB ou le clavier HID Bluetooth peuvent saisir dans un champ. Les modes série, SPP et SDK du fabricant ne le peuvent pas.
  3. Ouvrez le testeur de saisie de codes-barres.
  4. Cliquez sur Démarrer le test, 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 stocke.
  6. Lisez la valeur capturée et le nombre de caractères. Comparez les deux au contenu attendu, y compris tout préfixe que le lecteur insère avant les données.
  7. Vérifiez le suffixe. Le testeur signale ENTER, TAB ou Aucun. Avec Capture automatique 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 lorsque 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 stocker. Un préfixe, un caractère substitué ou un terminateur manquant doit être corrigé dans la configuration du lecteur ou traité volontairement dans la page. Ne le traitez pas comme un échec de décodage tant que cette comparaison n'est pas faite.

Le testeur enregistre les événements clavier que le navigateur peut voir. Il ne peut pas identifier l'appareil USB ni lire un port série. Lorsqu'un éditeur de texte reçoit la lecture et que le navigateur ne la reçoit pas, poursuivez avec Le lecteur fonctionne dans Notepad mais pas dans le POS.

Capturer la saisie d'un lecteur de codes-barres avec JavaScript

Un lecteur saisit dans l'élément qui a le focus. Donnez au champ un libellé visible, laissez-le en saisie de texte ordinaire pour que les utilisateurs au clavier puissent taper un code, et lisez la valeur lorsque le flux indique que la saisie est complète. La page ci-dessous fait cela. Enter envoie le formulaire une fois. Tab termine une valeur non vide, puis laisse le navigateur déplacer le focus. Une lecture sans terminateur reste dans le champ 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 le champ si le focus a bougé. Un lecteur en émulation, ou l'émulateur de la section suivante, saisit alors dans #barcode.

Le focus est requis. Si document.activeElement est le corps du document, un bouton ou une autre saisie, les écouteurs de ce champ ne voient pas la lecture. Les caractères arrivent dans le contrôle focalisé, ou ils sont perdus. Appelez field.focus() lorsque le flux 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 lecteur n'est pas configuré pour les envoyer, la valeur reste dans le champ et Look up est le chemin de fin. autocomplete="off" réduit la chance qu'une valeur enregistrée remplace la lecture. Le libellé, le bouton et Shift+Tab restent disponibles, afin qu'une personne puisse saisir un code sans lecteur.

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 second écouteur keydown pour Enter enregistrerait 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 ancêtre ne s'envoie pas aussi :

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 le champ 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 au même champ, parce que ce flux attend une autre lecture dans la même zone. Après Tab, il laisse le focus tranquille pour que le navigateur puisse passer au contrôle suivant.

Gérer les suffixes ENTER et TAB

Un suffixe est une touche que le lecteur 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 lecteurs de codes-barres décrit comment distinguer les terminateurs. Confirmez le réglage sur le lecteur que vous testez, puis faites correspondre la page à ce flux.

ENTER

Enter dans un champ de texte d'une seule ligne envoie le formulaire englobant 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 lecteur n'envoie peut-être aucun suffixe. Le lecteur de codes-barres n'envoie pas ENTER parcourt cette configuration. Certains appareils envoient NumPad Enter. event.key vaut toujours "Enter". Vérifiez event.key, et pas seulement event.code === "Enter", sinon ce lecteur aura l'air en panne.

TAB

Tab déplace le focus vers le contrôle focalisable suivant. Cela convient à une séquence telle que code produit, puis quantité. Cela surprend un formulaire qui attendait qu'Enter envoie les données.

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

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

Aucun suffixe

Sans suffixe, le contenu reste dans le champ. L'application doit décider quand la lecture est terminée. 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 temporisation d'inactivité peut traiter une pause de frappe comme la fin d'une lecture. Cette temporisation est une heuristique. Un lecteur 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 flux a besoin d'un signal net de fin de lecture.

Différences de configuration

Des lecteurs 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 tel que ]C1, ou CR et LF. Testez les trois réglages de terminateur que vos utilisateurs peuvent réellement choisir : Enter, Tab et aucun. Notez celui qu'utilisent les lecteurs déployés, et testez la page avec ce réglage.

Validation de la saisie du lecteur de codes-barres

Validez la chaîne que le champ a reçue. Ne supposez pas que chaque code-barres a la même longueur, le même jeu de caractères ou la même somme de contrôle. Les contenus Code 128 et QR varient. EAN-13 fait 13 chiffres. Une application qui stocke 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 un champ vide, ne doit pas créer d'enregistrement.

Caractères inattendus. Comparez la chaîne reçue à une étiquette connue. Un décalage 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é tient dedans.

Préfixe. Ne retirez un préfixe que lorsque vous avez configuré le lecteur pour envoyer exactement ce préfixe et que l'application ne le stocke 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 lecteur est réglé pour le transmettre. Laissez-le en place jusqu'à ce que vous ayez décidé si l'application le stocke.

Suffixe. Gardez le terminateur hors de la valeur stocké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 légitimement.

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 seconde lecture du même code est une autre question. Un formulaire d'entrepôt peut incrémenter la quantité. Un formulaire de billet peut rejeter un code déjà utilisé. Placez cette règle dans l'application, et testez-la 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 sommes 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 lecteur a peut-être déjà vérifié sa propre symbologie et transmis les données lisibles. Validez les formats que vous stockez, et répétez le contrôle sur le serveur. La chaîne envoyée est une saisie utilisateur ordinaire. Le navigateur ne peut pas prouver qu'un lecteur l'a produite.

Tester la saisie du lecteur sans matériel physique

Le Barcode Scanner Emulator est une application de bureau pour Windows, macOS et Linux. Vous saisissez 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 focalisée. Il reproduit le chemin clavier qu'utilise un lecteur en émulation. 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 construisez :

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

L'installation et le premier raccourci sont décrits dans Prise en main. Après un changement de réglages, envoyez une lecture dans le testeur de saisie avant de faire confiance au résultat dans l'application.

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

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

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

Déboguer les événements clavier du lecteur de codes-barres

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

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

input. Se déclenche sur le champ après qu'un caractère imprimable a changé sa valeur. C'est le bon événement à observer si vous avez besoin du texte au fur et à mesure qu'il grandit. Il ne se déclenche pas pour Enter ou 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 le champ perd le focus. Un lecteur qui laisse le focus dans le même champ ne produira pas change à la fin de la lecture. N'utilisez pas change comme seul signal de fin.

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

Focus. Journalisez document.activeElement juste avant une lecture. Si ce n'est pas le champ de code-barres, le reste de la trace explique le mauvais contrôle. Les iframes ont leur propre focus. Une lecture dans un cadre intégré est visible pour le script à l'intérieur de ce cadre.

Temporisation. Les lecteurs terminent souvent un contenu court bien en dessous d'une seconde. Le testeur de saisie compare l'écart moyen entre les caractères à un seuil de 100 ms et étiquette le résultat comme une temporisation, 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 lecteur. Un lecteur avec un délai entre caractères, une liaison Bluetooth ou un contenu long peut ressembler à de la frappe. Utilisez la valeur capturée et le suffixe. Utilisez la temporisation comme un indice.

Le testeur d'événements clavier liste chaque keydown et keyup avec key, code, les modificateurs et les horodatages. Utilisez-le 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 va dans le mauvais champ. La saisie en émulation suit le focus. Cliquez sur le champ cible après chaque navigation, boîte de dialogue ou message de validation qui déplace le focus. Une fenêtre modale sans champ de texte peut avaler la lecture comme des raccourcis.

Le lecteur fonctionne dans un éditeur de texte et pas dans le navigateur. L'appareil saisit. 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 gère que paste ne voit jamais la saisie en émulation. Commencez par Le lecteur 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 gère aussi Enter. Appelez preventDefault() sur l'un de ces chemins et traitez la valeur une fois. Un formulaire à plusieurs champs peut s'envoyer avant que les champs suivants soient remplis lorsque le lecteur envoie Enter. Utilisez Tab pour ce flux, ou empêchez l'envoi jusqu'à ce que le formulaire soit complet.

Tab change le focus. C'est la touche Tab. Configurez Enter sur le lecteur, ou lisez la valeur dans keydown et laissez le focus se déplacer. Voir la section des suffixes ci-dessus.

La disposition de clavier est fausse. Les chiffres peuvent survivre à un décalage qui change la ponctuation. Lisez une valeur connue qui contient les symboles que vous stockez, sur la disposition que le poste utilise réellement.

La même lecture crée deux enregistrements. Cherchez deux écouteurs sur un même Enter avant de chercher deux lectures physiques. Testez ensuite une seconde lecture volontaire 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 le testeur de saisie à la valeur de votre champ. Un préfixe peut aussi faire paraître trop long un contenu correct.

Les codes QR n'apparaissent jamais. Le lecteur 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 Test des codes QR : comment tester les lecteurs de QR, puis revenez au test du champ.

Liste de contrôle pour tester 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 lecteur est branché ou appairé, et l'hôte le montre prêt.
  • Le lecteur est en mode émulation clavier, pas en série ni dans un mode SDK du fabricant.
  • Le champ de code-barres est focalisé juste avant la lecture. document.activeElement est ce champ.
  • Un code-barres connu arrive caractère par caractère, longueur comprise.
  • Un suffixe ENTER envoie ou accepte la valeur une fois et ne laisse pas le terminateur dans la chaîne stockée.
  • Un suffixe TAB déplace le focus vers le contrôle voulu, et la valeur est lue avant le déplacement.
  • Une configuration sans suffixe laisse la valeur disponible jusqu'à ce que l'application la termine.
  • Un envoi vide est rejeté ou ignoré.
  • Une lecture ne crée pas deux enregistrements. Une seconde 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 de clavier du lecteur 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 le champ.
  • Plusieurs lectures d'affilée restent des valeurs séparées. Le champ 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 encaissement et les flux de quantité en POS, poursuivez avec Comment tester la saisie d'un lecteur de codes-barres.

Matrice de cas de test

La colonne lecteur 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 métier, par exemple si un code produit répété incrémente la quantité, appartiennent à l'application. Énoncez-les dans le test au lieu de supposer une seule règle pour chaque produit.

Scénario Comportement attendu
Code-barres valide L'application accepte la valeur et stocke 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 fois.
Suffixe TAB Le focus passe au contrôle suivant voulu, et la valeur est conservée.
Aucun suffixe La saisie reste disponible jusqu'à ce que l'application la traite.
Lectures rapides consécutives Chaque valeur est traitée séparément et n'est pas concaténée avec la précédente.
Mauvaise disposition de clavier Les caractères inattendus sont visibles dans la valeur capturée et échouent à la validation.
Lecture en double L'application suit sa propre règle de doublon, par exemple incrémenter la quantité ou rejeter une répétition.
Format de code-barres invalide L'application affiche l'erreur de validation de ce format et ne stocke pas la valeur.
Focus de saisie perdu L'application n'invente pas de code-barres. La lecture est absente ou arrive dans le contrôle focalisé, et la page reste dans un état sûr.

Jouez les lignes valide, vide, ENTER, TAB et aucun suffixe avec le lecteur physique, puis à nouveau avec l'émulateur. Jouez les lignes disposition de 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.