Barcode Scanner Emulator
Cómo probar lectores de códigos de barras en aplicaciones web
Muchos lectores de códigos de barras USB y Bluetooth envían los datos descodificados como entrada de teclado, de modo que un campo con el foco en una aplicación web puede recibir una lectura sin una API de navegador propia del lector. Los puertos serie y los SDK del fabricante son integraciones aparte. Puedes probar la ruta de teclado con un lector físico o con pulsaciones simuladas.
Una aplicación web suele ver un lector de códigos de barras como un teclado. La prueba consiste en comprobar si el control con el foco recibe la carga que tu aplicación espera y si la página trata el terminador que el lector está configurado para enviar. Ese terminador puede ser Enter, Tab o nada.
Usa una sesión del Probador de entrada de códigos de barras cuando haya un lector físico conectado. Usa el Barcode Scanner Emulator cuando necesites la misma ruta de teclado durante el desarrollo y el hardware no esté sobre la mesa. Un repaso más amplio del foco, la distribución y los flujos de POS está en Cómo probar la entrada de un lector de códigos de barras. Esta guía se queda en la aplicación del navegador: captura, sufijos, validación y los eventos que de verdad puedes observar.
Cómo se comunican los lectores 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 lector a menudo puede cambiar de modo al leer un código de barras de configuración del manual del fabricante.
Cuña de teclado HID USB
En modo teclado HID USB el lector se enumera como un teclado. El sistema operativo carga su controlador de teclado normal. Después de descodificar un símbolo, el lector envía los caracteres como pulsaciones al control que tiene el foco del teclado. La página escucha esas pulsaciones o lee el texto que insertan. No abre una conexión con el dispositivo.
Por eso un campo de cobro, un cuadro de búsqueda o cualquier otra entrada de texto puede aceptar una lectura con HTML corriente. La guía Cuña de teclado HID explica con más detalle la secuencia de pulsaciones, los prefijos y los sufijos.
HID Bluetooth
Un lector Bluetooth emparejado como teclado usa la misma ruta de la aplicación. El equipo anfitrión lo trata como un teclado HID y el campo con el foco recibe las pulsaciones. El emparejamiento, la batería y la radio son asuntos del dispositivo. Cuando los caracteres llegan al navegador, la página los trata igual que la entrada de una cuña USB.
Puerto serie y puerto COM virtual
Un lector serie, incluidos muchos modos de puerto COM virtual USB, envía el texto descodificado 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 pulsaciones no verá ese flujo.
Los navegadores basados en Chromium pueden abrir un puerto serie mediante la Web Serial API después de que el usuario selecciona el puerto y concede el permiso. Firefox y Safari no ofrecen esa API. Una prueba de cuña no ejercita una integración serie, y una prueba serie no dice qué escribirá un lector en cuña.
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 solicitar algunos dispositivos HID que no son teclados mediante WebHID tras un gesto del usuario. Los dispositivos HID de la clase teclado siguen bloqueados, así que un lector en cuña sigue siendo indistinguible 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
Una lectura en cuña 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 lector. Los navegadores que implementan WebHID siguen rechazando las interfaces de teclado, de modo que el script de la página tampoco puede leer los informes HID en bruto de un lector en cuña.
event.key es el carácter o el nombre de tecla después de que el sistema operativo aplica la distribución de teclado activa. event.code nombra la tecla física, como Digit1 o Numpad1, y puede seguir igual cuando un desajuste de distribución cambia event.key. Ninguna de las dos propiedades identifica el hardware.
Cómo probar un lector de códigos de barras físico en un navegador
Haz esto antes de depurar el código de la aplicación. Muestra la cadena exacta y el terminador que recibió el navegador.
- Conecta el lector y espera a que indique que tiene alimentación. En Bluetooth, termina el emparejamiento y confirma que el equipo anfitrión usa un perfil de teclado.
- Confirma el modo de entrada. La cuña 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.
- Abre el Probador de entrada de códigos de barras.
- Haz clic en Iniciar prueba o en el área de lectura. Se pone azul cuando está listo. La página no toma el foco por su cuenta.
- Lee un código de barras cuya carga ya conozcas. Empieza por un valor numérico corto y luego lee un valor que incluya la puntuación que tu aplicación almacena.
- Lee el valor capturado y el número de caracteres. Compara ambos con la carga que esperas, incluido cualquier prefijo que el lector inserte antes de los datos.
- Comprueba el sufijo. El probador informa ENTER, TAB o Ninguno. Con Captura automática activada, el resultado aparece tras Enter, Tab o una pausa breve cuando las teclas se detienen. Desactiva Captura automática cuando quieras que la captura se mantenga hasta que pulses Detener.
- Compara ese resultado con la cadena que tu aplicación debe almacenar. Un prefijo, un carácter sustituido o un terminador ausente debe corregirse en la configuración del lector o tratarse a propósito en la página. No lo tomes por un fallo de descodificación hasta que esta comparación esté hecha.
El probador 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 la lectura y el navegador no, continúa con El lector funciona en Notepad pero no en el POS.
Capturar la entrada del lector de códigos de barras con JavaScript
Un lector escribe en el elemento que tiene el foco. Pon al campo una etiqueta visible, déjalo como una entrada de texto normal para que quien use el teclado pueda escribir un código, y lee el valor cuando el flujo dice que la entrada está completa. La página de abajo hace eso. Enter envía el formulario una vez. Tab completa un valor no vacío y luego deja que el navegador mueva el foco. Una lectura 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 ha movido. Un lector en cuña, 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 escuchadores de este campo no ven la lectura. Los caracteres caen en el control con el foco o se pierden. Llama a field.focus() cuando el flujo esté listo para una lectura, también después de cerrar un cuadro de diálogo.
La entrada vacía se ignora. El formulario se queda en su sitio y el texto de estado dice que no se recibió nada. El espacio en blanco solo está vacío después de trim().
El ejemplo no añade Enter ni Tab. Si el lector no está configurado para enviarlos, el valor permanece en el campo y Look up es el camino de cierre. autocomplete="off" reduce la posibilidad de que un valor guardado sustituya la lectura. La etiqueta, el botón y Shift+Tab siguen disponibles, así que una persona puede introducir un código sin lector.
Trata Enter en un solo sitio. Este ejemplo usa el evento submit del formulario, que también cubre el botón Look up y un Enter del teclado. Un segundo escuchador keydown para Enter registraría la misma lectura dos veces. Si la entrada no está dentro de un formulario, escucha Enter en keydown y llama a preventDefault() para que un formulario antecesor 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 = ''
})
Vacía el campo tras una aceptación correcta para que la lectura siguiente no se añada a la carga anterior. Tras Enter, el ejemplo vuelve a enfocar el mismo campo porque ese flujo espera otra lectura en la misma casilla. Tras Tab, deja el foco quieto para que el navegador pueda pasar al control siguiente.
Tratamiento de los sufijos ENTER y TAB
Un sufijo es una tecla que el lector puede enviar después de la carga. Es un ajuste del dispositivo. Enter es habitual y es opcional. La guía Sufijos ENTER y TAB en los lectores de códigos de barras describe cómo distinguir los terminadores. Confirma el ajuste en el lector 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 contiene en los navegadores actuales. Úsalo cuando una lectura deba confirmar el valor, como en una casilla de búsqueda. preventDefault() en el evento submit impide que el navegador salga 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 lector no envíe sufijo. Al lector de códigos de barras le falta ENTER recorre esa configuración. Algunos dispositivos envían NumPad Enter. event.key sigue siendo "Enter". Comprueba event.key, no solo event.code === "Enter", o ese lector parecerá estropeado.
TAB
Tab mueve el foco al siguiente control que puede recibirlo. Encaja en 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 sitio cuando el control siguiente deba recibir el foco. preventDefault() mantiene el foco donde está, lo que resulta útil cuando el valor no es válido y quieres que el operador lo vea. Ignora Shift+Tab para que quien use el teclado pueda retroceder por el formulario. Un sufijo Tab del lector es Tab sin Shift.
Un sufijo Tab también puede mover el foco antes de que tu código lea el campo, si el escuchador está en blur o change y otra cosa vacía el control. Lee el valor desde el objetivo del evento keydown.
Sin sufijo
Sin sufijo, la carga se queda en el campo. La aplicación tiene que decidir cuándo ha terminado la lectura. Un botón explícito, un Enter posterior del operador o el paso a otro paso son puntos de cierre fiables. Un temporizador de inactividad puede tratar una pausa al escribir como el fin de una lectura. Ese temporizador es una heurística. Un lector lento, un retraso de Bluetooth o una persona que escribe deprisa pueden caer en el lado equivocado del umbral. Prefiere un sufijo configurado cuando el flujo necesita una señal firme de fin de lectura.
Diferencias de configuración
Lectores de la misma marca pueden salir de fábrica 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 envían 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 lectores desplegados y prueba la página con ese ajuste.
Validación de la entrada del lector de códigos de barras
Valida la cadena que recibió el campo. No des por hecho que todos los códigos de barras tienen la misma longitud, el mismo juego de caracteres o la misma suma de control. Las cargas de Code 128 y QR varían. EAN-13 tiene 13 dígitos. Una aplicación que almacena 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 desajuste de distribución suele aparecer como un símbolo cambiado, por ejemplo un dígito o una puntuación desplazados, mientras la longitud 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.
Longitud. Aplica las longitudes que acepta tu aplicación. Un mínimo y un máximo globales son más seguros que una sola longitud obligatoria cuando el formulario recibe más de una simbología. maxlength en la entrada trunca 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 lector para enviar exactamente ese prefijo y la aplicación no lo almacena.
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 lector está ajustado para transmitirlo. Déjalo en su sitio hasta que hayas decidido si la aplicación lo almacena.
Sufijo. Mantén el terminador fuera del valor almacenado. Enter y Tab son teclas. No se insertan en una entrada de texto normal. Una carga serie puede incluir todavía bytes CR o LF. Quítalos en el límite donde analizas el flujo serie y comprueba que no los quitas del medio de una carga que los contiene de forma legítima.
Envíos duplicados. Una lectura puede tratarse dos veces si tanto keydown como submit se ejecutan para el mismo Enter. Usa un solo camino de cierre. Una segunda lectura del mismo código es otra pregunta. Un formulario de almacén puede incrementar la cantidad. Un formulario de tique puede rechazar un código que ya se canjeó. Pon esa regla en la aplicación y pruébala a propósito. El navegador no puede distinguir un segundo apretón del gatillo de un segundo escuchador.
Reglas de la aplicación. Las sumas de control 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 lector puede haber comprobado ya su propia simbología y haber transmitido los datos legibles. Valida los formatos que almacenas y repite la comprobación en el servidor. La cadena enviada es entrada de usuario corriente. El navegador no puede demostrar que la produjo un lector.
Probar la entrada del lector sin hardware físico
El Barcode Scanner Emulator es una aplicación de escritorio para Windows, macOS y Linux. Introduces el texto que hay que enviar, eliges un retraso de escritura y eliges un sufijo entre ninguno, ENTER o TAB. Un atajo global escribe ese texto en la aplicación con el foco. Reproduce la ruta de teclado que usa un lector en cuña. No ilumina una etiqueta, no lee un símbolo ni descodifica una simbología.
Usa la página de ejemplo de arriba o la página que estás construyendo:
- Abre la página en un navegador de escritorio y haz clic en el campo del código de barras.
- En el emulador, introduce un valor conocido como
123456789012. - Pon el sufijo en ENTER. Ajusta el retraso de escritura si quieres que la ráfaga se parezca a un lector que ya mediste.
- Pulsa el atajo global de lectura del emulador mientras el campo del navegador sigue con el foco.
- Confirma el texto de estado y que el valor se aceptó una vez.
- Repite con TAB. El foco debe moverse y el valor debe aceptarse una vez.
- Repite sin sufijo. El texto debe permanecer en el campo hasta que actives Look up.
- Pon el foco en el Probador de entrada de códigos de barras y envía otra vez el mismo valor. Compara la cadena capturada, el prefijo y el sufijo con lo que almacenó la aplicación.
La instalación y el primer atajo están en Primeros pasos. Tras un cambio de ajustes, envía una lectura al probador de entrada antes de fiarte del resultado en la aplicación.
El hardware sigue haciendo falta para las partes ópticas y propias del dispositivo de la prueba:
- Si ese lector puede descodificar el símbolo impreso o mostrado, incluidas las etiquetas dañadas, el tamaño, el contraste y la distancia.
- Compatibilidad de simbologías. Un lector láser 1D no puede leer un código QR. Consulta Pruebas de códigos QR: cómo probar lectores de códigos QR.
- Enumeración USB, emparejamiento Bluetooth y la configuración propia del lector para la distribución de teclado y el sufijo.
- Integraciones serie, HID POS y SDK del fabricante.
El emulador es la herramienta adecuada para la lógica de la aplicación a lo largo de la ruta de teclado. Es la herramienta inadecuada para demostrar que un lector concreto lee una etiqueta concreta.
Depurar los eventos de teclado del lector de códigos de barras
Observa los eventos en este orden cuando el valor almacenado es incorrecto.
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 pulsada. Un lector en cuña envía normalmente una pulsación distinta por cada carácter.
input. Se dispara en el campo después de que un carácter imprimible cambia su valor. Es el evento adecuado 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, normalmente cuando el campo pierde el foco. Un lector que deja el foco en el mismo campo no producirá change al final de la lectura. No uses change como única señal de cierre.
event.key y event.code. Registra ambos cuando un carácter es incorrecto. Un desajuste entre la distribución del lector y la del sistema operativo cambia event.key y deja event.code como la tecla que el lector pretendía. Los dígitos del teclado numérico usan Numpad1 y códigos parecidos. Algunas máscaras de entrada los tratan de forma distinta a Digit1. Distribución de teclado incorrecta en el lector de códigos de barras explica el desajuste de distribución.
Foco. Registra document.activeElement justo antes de una lectura. Si no es el campo del código de barras, el resto del rastro explica el control equivocado. Los iframes tienen su propio foco. Una lectura en un marco incrustado es visible para el script de dentro de ese marco.
Temporización. Los lectores suelen terminar una carga corta bastante por debajo de un segundo. El probador de entrada compara el hueco medio entre caracteres con un umbral de 100 ms y etiqueta el resultado como temporización, no como identificación del hardware. Un umbral de hueco puede tratar como lector a quien escribe deprisa, al autocompletado o al emulador. Un lector con retraso entre caracteres, un enlace Bluetooth o una carga larga puede parecer escritura. Usa el valor capturado y el sufijo. Usa la temporización como pista.
El Probador de eventos de teclado enumera cada keydown y keyup con key, code, modificadores y marcas de tiempo. Úsalo cuando la cadena montada oculta una tecla de prefijo o un código de teclado numérico. El registro son eventos del navegador. No es tráfico USB en bruto.
Problemas habituales en aplicaciones web
La lectura va al campo equivocado. La entrada en cuña sigue el foco. Haz clic en el campo de destino después de cada navegación, cuadro de diálogo o mensaje de validación que mueva el foco. Un modal sin campo de texto puede tragarse la lectura como atajos de teclado.
El lector funciona en un editor de texto y no en el navegador. El dispositivo está escribiendo. La página no acepta esas teclas. Comprueba el foco, una entrada desactivada o de solo lectura y un escuchador keydown que llame a preventDefault() en teclas imprimibles. Un escuchador que solo trata paste no ve nunca la entrada en cuña. Empieza por El lector de códigos de barras no funciona si ninguna aplicación recibe caracteres.
Enter envía el formulario dos veces o sale de la página. El navegador envía el formulario y tu escuchador también trata 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 rellenen los campos posteriores cuando el lector envía 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 lector o lee el valor en keydown y permite el movimiento del foco. Consulta la sección de sufijos de arriba.
La distribución de teclado es incorrecta. Los dígitos pueden sobrevivir a un desajuste que cambia la puntuación. Lee un valor conocido que contenga los símbolos que almacenas, en la distribución que el puesto usa de verdad.
La misma lectura crea dos registros. Busca dos escuchadores en un mismo Enter antes de buscar dos lecturas físicas. Luego prueba una segunda lectura deliberada y confirma la regla de cantidad o de duplicado que documenta tu aplicación.
El valor falta o está truncado. Un atributo maxlength, una máscara de entrada o preventDefault() en teclas de carácter pueden descartar o cortar la carga. Compara el número de caracteres del probador de entrada con el valor de tu campo. Un prefijo también puede hacer que una carga correcta parezca demasiado larga.
Los códigos QR no aparecen nunca. El lector puede ser solo 1D, o la simbología QR puede estar desactivada. La aplicación no puede arreglar eso. Confirma el hardware con Pruebas de códigos QR: cómo probar lectores de códigos QR y vuelve después a la prueba del campo.
Lista de comprobación para probar la aplicación web
Úsala en la compilación que pretendes publicar, en cada navegador que admitas. Comprueba un perfil nuevo y también un perfil con extensiones de gestor de contraseñas y de autocompletado, porque esas extensiones mueven el foco.
- El lector está conectado o emparejado, y el equipo anfitrión lo muestra listo.
- El lector está en modo cuña de teclado, no en serie ni en un modo SDK del fabricante.
- El campo del código de barras tiene el foco justo antes de la lectura.
document.activeElementes ese campo. - Un código de barras conocido llega carácter a carácter, longitud incluida.
- Un sufijo ENTER envía o acepta el valor una vez y no deja el terminador en la cadena almacenada.
- Un sufijo TAB mueve el foco al control que pretendes, y el valor se lee antes del movimiento.
- Una configuración sin sufijo deja el valor disponible hasta que la aplicación lo completa.
- Un envío vacío se rechaza o se ignora.
- Una lectura no crea dos registros. Una segunda lectura real sigue la regla de duplicado de la aplicación.
- La puntuación, los símbolos y cualquier separador GS1 que usen tus formatos sobreviven al viaje de ida y vuelta.
- La distribución de teclado del lector y la del sistema operativo producen los caracteres impresos en la etiqueta.
- Tras desenchufar y volver a enchufar, o tras caer el enlace Bluetooth, la lectura siguiente sigue llegando al campo.
- Varias lecturas seguidas siguen siendo valores separados. El campo no los concatena.
- Las mismas comprobaciones pasan en los navegadores que admites, con y sin las extensiones habituales de autocompletado.
Para cuadros de diálogo, el orden de tabulación en todo un cobro y los flujos de cantidad del POS, continúa con Cómo probar la entrada de un lector de códigos de barras.
Matriz de casos de prueba
La columna del lector 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 incrementa la cantidad, pertenecen a la aplicación. Indícalas 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 almacena 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. |
| Lecturas rápidas consecutivas | Cada valor se procesa por separado y no se concatena con el anterior. |
| Distribución de teclado incorrecta | Los caracteres inesperados se ven en el valor capturado y no superan la validación. |
| Lectura duplicada | La aplicación sigue su propia regla de duplicado, como incrementar 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 almacena el valor. |
| Foco de entrada perdido | La aplicación no inventa un código de barras. La lectura falta o cae en el control con el foco, y la página permanece en un estado seguro. |
Ejecuta las filas de válido, vacío, ENTER, TAB y sin sufijo con el lector físico y otra vez con el emulador. Ejecuta las filas de distribución de teclado, QR y reconexión en el hardware. Esas filas dependen del dispositivo, de la etiqueta o de la distribución del sistema operativo, que las pulsaciones simuladas no reproducen.