Saltar al contenido

Barcode Scanner Emulator

Cómo probar escáneres de códigos de barras en aplicaciones web

Muchos escáneres de códigos de barras USB y Bluetooth envían los datos decodificados como entrada de teclado, así que un campo con el foco en una aplicación web puede recibir un escaneo sin una API de navegador propia del escáner. Los puertos serie y los SDK del fabricante son integraciones aparte. Puedes probar la ruta de teclado con un escáner físico o con teclazos simulados.

Una aplicación web suele ver un escáner de códigos de barras como un teclado. La prueba revisa si el control con el foco recibe la carga que tu app espera y si la página maneja el terminador que el escáner está configurado para mandar. Ese terminador puede ser Enter, Tab o nada.

Usa una sesión del Verificador de entrada de códigos de barras cuando haya un escáner físico conectado. Usa el Barcode Scanner Emulator cuando necesites la misma ruta de teclado durante el desarrollo y el hardware no esté en el escritorio. Un repaso más amplio del foco, el diseño y los flujos de POS está en Cómo probar la entrada de un escáner de códigos de barras. Esta guía se queda en la aplicación del navegador: captura, sufijos, validación y los eventos que sí puedes observar.

Cómo se comunican los escáneres de códigos de barras con las aplicaciones web

El modo de interfaz decide qué puede recibir la página. Confírmalo antes de cambiar el código del formulario. Un escáner a menudo puede cambiar de modo al escanear un código de barras de configuración del manual del fabricante.

Emulación de teclado HID USB

En modo teclado HID USB el escáner se enumera como un teclado. El sistema operativo carga su controlador de teclado normal. Después de decodificar un símbolo, el escáner manda los caracteres como teclazos al control que tiene el foco del teclado. La página escucha esos teclazos o lee el texto que insertan. No abre una conexión con el dispositivo.

Por eso un campo de checkout, una caja de búsqueda o cualquier otra entrada de texto puede aceptar un escaneo con HTML común. La guía Emulación de teclado HID explica con más detalle la secuencia de teclazos, los prefijos y los sufijos.

HID Bluetooth

Un escáner Bluetooth emparejado como teclado usa la misma ruta de la aplicación. La computadora lo trata como un teclado HID y el campo con el foco recibe los teclazos. El emparejamiento, la batería y el radio son asuntos del dispositivo. Cuando los caracteres llegan al navegador, la página los maneja igual que la entrada de una emulación USB.

Puerto serie y puerto COM virtual

Un escáner serie, incluidos muchos modos de puerto COM virtual por USB, manda el texto decodificado como bytes en un puerto. El foco no elige el destino. Lo elige el proceso que abre el puerto. Un campo de texto que solo escucha teclazos no va a ver ese flujo.

Los navegadores basados en Chromium pueden abrir un puerto serie con la Web Serial API después de que el usuario elige el puerto y da el permiso. Firefox y Safari no ofrecen esa API. Una prueba de emulación no ejercita una integración serie, y una prueba serie no dice qué va a teclear un escáner en emulación.

Interfaces propias del fabricante

Algunos dispositivos usan un SDK del fabricante, OPOS, JPOS o una interfaz HID que no es un teclado, como USB HID POS. Esas interfaces no escriben en el campo con el foco. Una página web normal no puede cargar un SDK nativo. Chromium puede pedir algunos dispositivos HID que no son teclados por medio de WebHID después de un gesto del usuario. Los dispositivos HID de la clase teclado siguen bloqueados, así que un escáner en emulación sigue sin poder distinguirse de un teclado. Trata una interfaz de fabricante como una integración propia y pruébala con el software que de verdad abre esa interfaz.

Qué puede ver el navegador

Un escaneo en emulación llega como eventos keydown y keyup, y los caracteres imprimibles actualizan el campo con el foco. El navegador no recibe un nombre de dispositivo, un número de serie USB ni una marca que diga que es un escáner. Los navegadores que implementan WebHID siguen rechazando las interfaces de teclado, así que el script de la página tampoco puede leer los informes HID en crudo de un escáner en emulación.

event.key es el carácter o el nombre de tecla después de que el sistema operativo aplica el diseño de teclado activo. event.code nombra la tecla física, como Digit1 o Numpad1, y puede seguir igual cuando un diseño que no coincide cambia event.key. Ninguna de las dos propiedades identifica el hardware.

Cómo probar un escáner de códigos de barras físico en un navegador

Haz esto antes de depurar el código de la app. Muestra la cadena exacta y el terminador que recibió el navegador.

  1. Conecta el escáner y espera a que indique que tiene corriente. En Bluetooth, termina el emparejamiento y confirma que la computadora usa un perfil de teclado.
  2. Confirma el modo de entrada. La emulación de teclado, el teclado HID USB o el teclado HID Bluetooth pueden escribir en un campo. Los modos serie, SPP y SDK del fabricante no.
  3. Abre el Verificador de entrada de códigos de barras.
  4. Haz clic en Iniciar prueba o en el área de escaneo. Se pone azul cuando está listo. La página no toma el foco por su cuenta.
  5. Escanea un código de barras cuya carga ya conozcas. Empieza por un valor numérico corto y luego escanea un valor que incluya la puntuación que tu app guarda.
  6. Lee el valor capturado y la cantidad de caracteres. Compara ambos con la carga que esperas, incluido cualquier prefijo que el escáner inserte antes de los datos.
  7. Revisa el sufijo. El verificador informa ENTER, TAB o Ninguno. Con Captura automática activada, el resultado aparece después de Enter, Tab o una pausa corta cuando las teclas se detienen. Apaga Captura automática cuando quieras que la captura se quede en espera hasta que pulses Detener.
  8. Compara ese resultado con la cadena que tu app debe guardar. Un prefijo, un carácter sustituido o un terminador que falta debe corregirse en la configuración del escáner o manejarse a propósito en la página. No lo tomes por una falla de decodificación hasta que esta comparación esté hecha.

El verificador registra los eventos de teclado que el navegador puede ver. No puede identificar el dispositivo USB ni leer un puerto serie. Cuando un editor de texto recibe el escaneo y el navegador no, sigue con El escáner funciona en Notepad pero no en el POS.

Capturar la entrada del escáner de códigos de barras con JavaScript

Un escáner escribe en el elemento que tiene el foco. Ponle al campo una etiqueta visible, déjalo como una entrada de texto normal para que quien use el teclado pueda teclear un código, y lee el valor cuando el flujo dice que la entrada ya está completa. La página de abajo hace eso. Enter envía el formulario una vez. Tab completa un valor que no está vacío y luego deja que el navegador mueva el foco. Un escaneo sin terminador se queda en el campo hasta que alguien activa 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>

Guarda ese archivo y ábrelo en un navegador de escritorio. Haz clic en el campo si el foco se movió. Un escáner en emulación, o el emulador de la sección siguiente, escribe entonces en #barcode.

El foco es necesario. Si document.activeElement es el cuerpo del documento, un botón u otra entrada, los oyentes de este campo no ven el escaneo. Los caracteres caen en el control con el foco o se pierden. Llama a field.focus() cuando el flujo esté listo para un escaneo, también después de cerrar un diálogo.

La entrada vacía se ignora. El formulario se queda en su lugar y el texto de estado dice que no llegó nada. El espacio en blanco solo queda vacío después de trim().

El ejemplo no agrega Enter ni Tab. Si el escáner no está configurado para mandarlos, el valor permanece en el campo y Look up es el camino para terminar. autocomplete="off" baja la posibilidad de que un valor guardado reemplace el escaneo. La etiqueta, el botón y Shift+Tab siguen disponibles, así que una persona puede meter un código sin escáner.

Maneja Enter en un solo lugar. Este ejemplo usa el evento submit del formulario, que también cubre el botón Look up y un Enter del teclado. Un segundo oyente keydown para Enter registraría el mismo escaneo dos veces. Si la entrada no está dentro de un formulario, escucha Enter en keydown y llama a preventDefault() para que un formulario padre no se envíe también:

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

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

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

Limpia el campo después de una aceptación correcta para que el siguiente escaneo no se pegue a la carga anterior. Después de Enter, el ejemplo vuelve a enfocar el mismo campo porque ese flujo espera otro escaneo en la misma casilla. Después de Tab, deja el foco quieto para que el navegador pueda pasar al control siguiente.

Cómo manejar los sufijos ENTER y TAB

Un sufijo es una tecla que el escáner puede mandar después de la carga. Es un ajuste del dispositivo. Enter es común y es opcional. La guía Sufijos ENTER y TAB en los escáneres de códigos de barras describe cómo distinguir los terminadores. Confirma el ajuste en el escáner que estás probando y luego haz que la página coincida con ese flujo.

ENTER

Enter dentro de un campo de texto de una línea envía el formulario que lo rodea en los navegadores actuales. Úsalo cuando un escaneo deba confirmar el valor, como en una casilla de búsqueda. preventDefault() en el evento submit evita que el navegador se vaya de la página. Omítelo cuando una navegación de página completa sea el comportamiento que quieres.

Si el código de barras aparece y el formulario no hace nada, puede que el escáner no mande sufijo. Al escáner de códigos de barras le falta ENTER recorre esa configuración. Algunos dispositivos mandan NumPad Enter. event.key sigue siendo "Enter". Revisa event.key, no solo event.code === "Enter", o ese escáner va a parecer descompuesto.

TAB

Tab mueve el foco al siguiente control que puede recibirlo. Sirve para una secuencia como código de producto y luego cantidad. Sorprende a un formulario que esperaba que Enter enviara los datos.

Lee el valor en keydown mientras el campo todavía tiene el foco. El navegador mueve el foco después de ese evento. Deja la acción predeterminada en su lugar cuando el control siguiente deba recibir el foco. preventDefault() mantiene el foco donde está, y eso sirve cuando el valor no es válido y quieres que el operador lo vea. Ignora Shift+Tab para que quien use el teclado pueda regresar por el formulario. Un sufijo Tab del escáner es Tab sin Shift.

Un sufijo Tab también puede mover el foco antes de que tu código lea el campo, si el oyente está en blur o change y otra cosa limpia el control. Lee el valor desde el target del evento keydown.

Sin sufijo

Sin sufijo, la carga se queda en el campo. La app tiene que decidir cuándo terminó el escaneo. Un botón explícito, un Enter posterior del operador o el paso a otro paso son puntos de cierre confiables. Un temporizador de inactividad puede tomar una pausa al teclear como el fin de un escaneo. Ese temporizador es una heurística. Un escáner lento, un retraso de Bluetooth o una persona que teclea rápido pueden caer del lado equivocado del umbral. Prefiere un sufijo configurado cuando el flujo necesita una señal firme de fin de escaneo.

Diferencias de configuración

Escáneres de la misma marca pueden salir con sufijos distintos, y un código de barras de configuración puede cambiar el sufijo sin ningún cambio en tu JavaScript. Algunos dispositivos mandan un prefijo, un identificador de simbología como ]C1, o CR y LF. Prueba los tres ajustes de terminador que tus usuarios pueden elegir de verdad: Enter, Tab y ninguno. Anota cuál usan los escáneres desplegados y prueba la página contra ese ajuste.

Validación de la entrada del escáner de códigos de barras

Valida la cadena que recibió el campo. No des por hecho que todos los códigos de barras tienen el mismo largo, el mismo juego de caracteres o la misma suma de verificación. Las cargas de Code 128 y QR varían. EAN-13 tiene 13 dígitos. Una app que guarda ambos necesita reglas para ambos.

Entrada vacía. Recházala o ignórala. Un sufijo sin carga, o un clic en Look up sobre un campo en blanco, no debe crear un registro.

Caracteres inesperados. Compara la cadena recibida con una etiqueta conocida. Un diseño que no coincide suele verse como un símbolo cambiado, por ejemplo un dígito o una puntuación corridos, mientras el largo se mantiene. Los caracteres de control pueden venir de un prefijo o de un separador de grupo GS1. Permite los caracteres que define tu formato. El ejemplo de arriba rechaza los caracteres de control ASCII para que sigan visibles en el texto de estado. Un analizador GS1 que espera un separador de grupo debe permitir ese carácter y rechazar el resto.

Largo. Aplica los largos que acepta tu app. Un mínimo y un máximo globales son más seguros que un solo largo obligatorio cuando el formulario recibe más de una simbología. maxlength en la entrada recorta en silencio una carga más larga, así que ponlo solo cuando quepa cada código aceptado.

Prefijo. Quita un prefijo solo cuando configuraste el escáner para mandar exactamente ese prefijo y la app no lo guarda.

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

Un identificador de simbología AIM es un dato si el escáner está ajustado para transmitirlo. Déjalo en su lugar hasta que decidas si la app lo guarda.

Sufijo. Mantén el terminador fuera del valor guardado. Enter y Tab son teclas. No se insertan en una entrada de texto normal. Una carga serie todavía puede incluir bytes CR o LF. Quítalos en el límite donde analizas el flujo serie y verifica que no los quitas de en medio de una carga que sí los trae.

Envíos duplicados. Un escaneo puede manejarse dos veces si tanto keydown como submit corren para el mismo Enter. Usa un solo camino de cierre. Un segundo escaneo del mismo código es otra pregunta. Un formulario de almacén puede aumentar la cantidad. Un formulario de boleto puede rechazar un código que ya se canjeó. Pon esa regla en la app y pruébala a propósito. El navegador no puede distinguir un segundo jalón del gatillo de un segundo oyente.

Reglas de la aplicación. Las sumas de verificación pertenecen a simbologías concretas. EAN-13 usa el último dígito como dígito de control. Esta función solo acepta ese formato:

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 y QR no usan ese cálculo. El escáner puede haber revisado ya su propia simbología y haber transmitido los datos legibles. Valida los formatos que guardas y repite la revisión en el servidor. La cadena enviada es entrada de usuario común. El navegador no puede demostrar que la produjo un escáner.

Probar la entrada del escáner sin hardware físico

El Barcode Scanner Emulator es una app de escritorio para Windows, macOS y Linux. Escribes el texto que hay que mandar, eliges un retraso de tecleo y eliges un sufijo entre ninguno, ENTER o TAB. Un atajo global teclea ese texto en la aplicación con el foco. Reproduce la ruta de teclado que usa un escáner en emulación. No ilumina una etiqueta, no lee un símbolo ni decodifica una simbología.

Usa la página de ejemplo de arriba o la página que estás armando:

  1. Abre la página en un navegador de escritorio y haz clic en el campo del código de barras.
  2. En el emulador, escribe un valor conocido como 123456789012.
  3. Pon el sufijo en ENTER. Ajusta el retraso de tecleo si quieres que la ráfaga se parezca a un escáner que ya mediste.
  4. Presiona el atajo global de escaneo del emulador mientras el campo del navegador sigue con el foco.
  5. Confirma el texto de estado y que el valor se aceptó una vez.
  6. Repite con TAB. El foco debe moverse y el valor debe aceptarse una vez.
  7. Repite sin sufijo. El texto debe quedarse en el campo hasta que actives Look up.
  8. Pon el foco en el Verificador de entrada de códigos de barras y manda otra vez el mismo valor. Compara la cadena capturada, el prefijo y el sufijo con lo que guardó la app.

La instalación y el primer atajo están en Cómo empezar. Después de un cambio de configuración, manda un escaneo al verificador de entrada antes de confiar en el resultado de la app.

El hardware sigue haciendo falta para las partes ópticas y propias del dispositivo de la prueba:

  • Si ese escáner puede decodificar el símbolo impreso o mostrado, incluidas las etiquetas dañadas, el tamaño, el contraste y la distancia.
  • Soporte de simbologías. Un escáner láser 1D no puede leer un código QR. Consulta Pruebas de códigos QR: cómo probar escáneres de códigos QR.
  • Enumeración USB, emparejamiento Bluetooth y la configuración propia del escáner para el diseño de teclado y el sufijo.
  • Integraciones serie, HID POS y SDK del fabricante.

El emulador es la herramienta correcta para la lógica de la app a lo largo de la ruta de teclado. Es la herramienta incorrecta para demostrar que un escáner concreto lee una etiqueta concreta.

Depurar los eventos de teclado del escáner de códigos de barras

Observa los eventos en este orden cuando el valor guardado está mal.

keydown. Se dispara con cada tecla, incluidas Enter y Tab, antes de que el navegador inserte un carácter o mueva el foco. Lee el terminador aquí. event.repeat es verdadero cuando una tecla se mantiene presionada. Un escáner en emulación manda normalmente un teclazo distinto por cada carácter.

input. Se dispara en el campo después de que un carácter imprimible cambia su valor. Es el evento correcto si necesitas el texto a medida que crece. No se dispara con Enter ni con Tab, porque esas teclas no insertan un carácter en una entrada de texto.

change. Se dispara después de que el valor se confirma, por lo general cuando el campo pierde el foco. Un escáner que deja el foco en el mismo campo no va a producir change al final del escaneo. No uses change como única señal de cierre.

event.key y event.code. Registra ambos cuando un carácter está mal. Un diseño del escáner que no coincide con el del sistema operativo cambia event.key y deja event.code como la tecla que el escáner quería. Los dígitos del teclado numérico usan Numpad1 y códigos parecidos. Algunas máscaras de entrada los tratan distinto de Digit1. Diseño de teclado incorrecto en el escáner de códigos de barras explica ese desajuste de diseño.

Foco. Registra document.activeElement justo antes de un escaneo. Si no es el campo del código de barras, el resto del rastro explica el control equivocado. Los iframes tienen su propio foco. Un escaneo hacia un marco incrustado es visible para el script de adentro de ese marco.

Tiempos. Los escáneres suelen terminar una carga corta bastante por debajo de un segundo. El verificador de entrada compara el hueco medio entre caracteres con un umbral de 100 ms y etiqueta el resultado como tiempo, no como identificación del hardware. Un umbral de hueco puede tratar como escáner a quien teclea rápido, al autocompletado o al emulador. Un escáner con retraso entre caracteres, un enlace Bluetooth o una carga larga puede parecer tecleo. Usa el valor capturado y el sufijo. Usa el tiempo como pista.

El Inspector de eventos de teclado lista cada keydown y keyup con key, code, modificadores y marcas de tiempo. Úsalo cuando la cadena armada esconde una tecla de prefijo o un código de teclado numérico. El registro son eventos del navegador. No es tráfico USB en crudo.

Problemas comunes en aplicaciones web

El escaneo va al campo equivocado. La entrada en emulación sigue el foco. Haz clic en el campo de destino después de cada navegación, diálogo o mensaje de validación que mueva el foco. Un modal sin campo de texto puede tragarse el escaneo como teclas de acceso directo.

El escáner funciona en un editor de texto y no en el navegador. El dispositivo está tecleando. La página no acepta esas teclas. Revisa el foco, una entrada deshabilitada o de solo lectura y un oyente keydown que llame a preventDefault() en teclas imprimibles. Un oyente que solo maneja paste nunca ve la entrada en emulación. Empieza por El escáner de códigos de barras no funciona si ninguna app recibe caracteres.

Enter envía el formulario dos veces o se sale de la página. El navegador envía el formulario y tu oyente también maneja Enter. Llama a preventDefault() en uno de esos caminos y procesa el valor una vez. Un formulario de varios campos puede enviarse antes de que se llenen los campos de después cuando el escáner manda Enter. Usa Tab para ese flujo o impide el envío hasta que el formulario esté completo.

Tab cambia el foco. Esa es la tecla Tab. Configura Enter en el escáner, o lee el valor en keydown y deja que el foco se mueva. Mira la sección de sufijos de arriba.

El diseño de teclado está mal. Los dígitos pueden sobrevivir a un desajuste que cambia la puntuación. Escanea un valor conocido que contenga los símbolos que guardas, con el diseño que la estación usa de verdad.

El mismo escaneo crea dos registros. Busca dos oyentes en un mismo Enter antes de buscar dos escaneos físicos. Luego prueba un segundo escaneo a propósito y confirma la regla de cantidad o de duplicado que documenta tu app.

El valor falta o está cortado. Un atributo maxlength, una máscara de entrada o preventDefault() en teclas de carácter pueden botar o cortar la carga. Compara la cantidad de caracteres del verificador de entrada con el valor de tu campo. Un prefijo también puede hacer que una carga correcta se vea demasiado larga.

Los códigos QR nunca aparecen. El escáner puede ser solo 1D, o la simbología QR puede estar apagada. La app no puede arreglar eso. Confirma el hardware con Pruebas de códigos QR: cómo probar escáneres de códigos QR y regresa después a la prueba del campo.

Lista de verificación para probar la aplicación web

Úsala en la compilación que piensas publicar, en cada navegador que soportes. Revisa un perfil nuevo y también un perfil con extensiones de administrador de contraseñas y de autocompletado, porque esas extensiones mueven el foco.

  • El escáner está conectado o emparejado, y la computadora lo muestra listo.
  • El escáner está en modo de emulación de teclado, no en serie ni en un modo SDK del fabricante.
  • El campo del código de barras tiene el foco justo antes del escaneo. document.activeElement es ese campo.
  • Un código de barras conocido llega carácter por carácter, largo incluido.
  • Un sufijo ENTER envía o acepta el valor una vez y no deja el terminador en la cadena guardada.
  • Un sufijo TAB mueve el foco al control que quieres, y el valor se lee antes del movimiento.
  • Una configuración sin sufijo deja el valor disponible hasta que la app lo completa.
  • Un envío vacío se rechaza o se ignora.
  • Un escaneo no crea dos registros. Un segundo escaneo real sigue la regla de duplicado de la app.
  • La puntuación, los símbolos y cualquier separador GS1 que usen tus formatos sobreviven al viaje de ida y vuelta.
  • El diseño de teclado del escáner y el del sistema operativo producen los caracteres impresos en la etiqueta.
  • Después de desconectar y volver a conectar, o después de que se cae el enlace Bluetooth, el siguiente escaneo todavía llega al campo.
  • Varios escaneos seguidos siguen siendo valores separados. El campo no los concatena.
  • Las mismas revisiones pasan en los navegadores que soportas, con y sin las extensiones comunes de autocompletado.

Para diálogos, el orden de tabulación en todo un checkout y los flujos de cantidad del POS, sigue con Cómo probar la entrada de un escáner de códigos de barras.

Matriz de casos de prueba

La columna del escáner es lo que hacen el dispositivo y el navegador. La columna de comportamiento esperado es lo que la aplicación debe hacer en respuesta. Las reglas de negocio, como si un código de producto repetido aumenta la cantidad, pertenecen a la app. Diles en la prueba en lugar de suponer una sola regla para cada producto.

Escenario Comportamiento esperado
Código de barras válido La aplicación acepta el valor y guarda la carga sin el terminador.
Entrada vacía La aplicación la rechaza o la ignora y no crea un registro.
Sufijo ENTER La aplicación envía o acepta el valor una vez.
Sufijo TAB El foco pasa al control siguiente previsto y el valor se conserva.
Sin sufijo La entrada sigue disponible hasta que la aplicación la procesa.
Escaneos rápidos seguidos Cada valor se procesa por separado y no se concatena con el anterior.
Diseño de teclado incorrecto Los caracteres inesperados se ven en el valor capturado y no pasan la validación.
Escaneo duplicado La aplicación sigue su propia regla de duplicado, como aumentar la cantidad o rechazar una repetición.
Formato de código de barras no válido La aplicación muestra el error de validación de ese formato y no guarda el valor.
Foco de entrada perdido La aplicación no inventa un código de barras. El escaneo falta o cae en el control con el foco, y la página se queda en un estado seguro.

Corre las filas de válido, vacío, ENTER, TAB y sin sufijo con el escáner físico y otra vez con el emulador. Corre las filas de diseño de teclado, QR y reconexión en el hardware. Esas filas dependen del dispositivo, de la etiqueta o del diseño del sistema operativo, que los teclazos simulados no reproducen.