Barcode Scanner Emulator
Prefijo y sufijo del escáner de códigos de barras: guía completa
Un prefijo es un dato o una secuencia de control que un escáner de códigos de barras manda antes del código de barras decodificado. Un sufijo es lo que manda después de ese valor. El mismo modelo se puede dejar con prefijos y sufijos distintos, y un escáner serial no los entrega igual que un escáner en emulación de teclado.
Un prefijo de escáner de códigos de barras se manda antes del valor decodificado. Un sufijo se manda después. Un escáner puede producir esta secuencia:
Prefijo: STX
Código de barras: 123456789
Sufijo: ENTER
En un manual, STX casi siempre es el carácter de control, no las tres letras S, T y X. En un escáner en emulación de teclado, ENTER suele ser la tecla Enter, no los dos caracteres CR y LF metidos en un campo de texto. Lo que recibes depende del modelo, de la interfaz y de la app. Ningún ajuste sirve para todos los aparatos.
La guía Sufijos ENTER y TAB en los escáneres de códigos de barras se queda en elegir y corregir esos dos cierres. Esta guía trata el marco alrededor del código de barras: qué va antes, qué va después y cómo una app web debe leer ambos.
Qué es un prefijo de escáner de códigos de barras
Un prefijo es una secuencia configurada que el escáner transmite antes de la carga. La carga es el texto que decodificó la simbología, como 123456789. El prefijo no forma parte de esa decodificación, salvo que el escáner se haya dejado para agregarlo.
Usos comunes:
- Marcar el inicio de un mensaje. Los protocolos seriales y de terminal a veces mandan un carácter de control, a menudo llamado STX, para que el host sepa que arrancó una trama nueva.
- Nombrar la simbología. Con el identificador de simbología AIM activado, un escáner puede mandar un prefijo imprimible corto, como
]C1para Code 128 o]E0para EAN, antes de los dígitos. La app puede ramificarse con ese identificador. - Enrutar la entrada en software viejo de POS o de terminal. Un código fijo antes de los datos le decía al host a qué campo o dispositivo pertenecía el escaneo.
- Etiquetar una estación concreta. Dos escáneres pueden recibir prefijos imprimibles distintos para que un registro muestre qué carril mandó el código.
Un prefijo imprimible son caracteres comunes. Aparecen en un campo de texto al frente de la cadena. Un prefijo de carácter de control, como STX (0x02), no son las letras S, T y X. Un escáner en emulación de teclado puede no poder teclear ese carácter de control. Un escáner serial sí puede mandarlo como un byte. Lee el manual del modelo que tienes antes de escribir código que espere uno u otro.
Un prefijo no prueba que un escáner produjo la entrada. Una persona, una macro o el Barcode Scanner Emulator pueden teclear los mismos caracteres. Trata un prefijo como el marco que configuraste y valida la carga como cualquier otra entrada de usuario.
Qué es un sufijo de escáner de códigos de barras
Un sufijo es una secuencia configurada que se manda después de la carga. Su trabajo habitual es avisarle a la app que el escaneo ya terminó, o mover el foco. Los escáneres no son iguales. Algunos ofrecen Enter, Tab, CR, LF, CR+LF, una cadena personalizada o nada. Algunos solo ofrecen una o dos de esas opciones.
ENTER. La tecla Enter. En un navegador es un evento de teclado, event.key === "Enter". No se inserta en un campo de texto normal.
TAB. La tecla Tab, event.key === "Tab". El navegador mueve el foco al siguiente control. La tecla no se inserta en el campo.
CR. Retorno de carro, ASCII 0x0D. En una interfaz serial o de terminal puede ser un byte real después de la carga. En una emulación de teclado, un ajuste con el nombre CR o retorno de carro suele significar la tecla Enter. El navegador sigue reportando Enter. El valor del campo no gana un carácter CR.
LF. Avance de línea, ASCII 0x0A. Es un carácter de control distinto de CR. En un flujo serial puede ser su propio byte. Un escáner en emulación no tiene una tecla estándar de avance de línea como tiene Enter y Tab. No supongas que un ítem de menú llamado LF teclea un carácter visible o un segundo Enter.
CRLF. CR seguido de LF, los dos bytes 0x0D 0x0A. Algunos hosts seriales y de terminal esperan ese par como fin de línea. Un campo de texto del navegador no guarda ese par cuando alguien oprime Enter.
Caracteres personalizados. Un sufijo imprimible como # o un código corto se teclea después del código de barras, así que queda dentro de la cadena, salvo que la app lo quite. Un carácter de control personalizado sigue el mismo corte que STX: bytes en un puerto serial, teclazos en una emulación y solo los teclazos que la interfaz de teclado puede mandar de verdad.
ENTER, CR y LF son nombres emparentados de fin de línea en los manuales. No se pueden cambiar uno por otro en todas las apps. Un escáner en emulación, un escáner serial, Notepad y un formulario web pueden mostrar cada uno un resultado distinto para un ajuste con el mismo nombre.
Prefijo y sufijo
| Característica | Prefijo | Sufijo |
|---|---|---|
| Posición | Antes de los datos del código de barras | Después de los datos del código de barras |
| Finalidad | Marcar el inicio o etiquetar la entrada | Marcar el cierre o disparar una acción |
| Ejemplo | STX, o un identificador AIM imprimible como ]C1 |
ENTER, TAB o un carácter imprimible como # |
| Uso común | Enmarcar o identificar el escaneo | Enviar un formulario o mover el foco |
| En un campo de texto | Los caracteres imprimibles quedan al inicio del valor | Los caracteres imprimibles quedan al final. Enter y Tab, no |
| Identidad | Un marcador configurado que cualquiera puede teclear | Un marcador configurado que cualquiera puede teclear |
Quita un prefijo o un sufijo personalizado solo cuando configuraste esa secuencia exacta y el registro guardado no debe incluirla. Deja un identificador AIM en su lugar hasta que la app tenga una regla para él.
ENTER, TAB, CR y LF
Estos nombres salen en las hojas de configuración. Quien recibe ve teclazos o bytes, según la interfaz. La guía Emulación de teclado HID describe el camino de los teclazos. Un puerto serial es otro camino: la app lee bytes y el foco no elige a dónde van.
ENTER
En un escáner en emulación de teclado, ENTER es la tecla Enter. Dentro de un campo de texto de una sola línea, los navegadores actuales usan esa tecla para enviar el formulario que lo contiene. Un cuadro de búsqueda puede confirmar el escaneo en ese evento. Un formulario de varios campos puede enviarse antes de llenar los campos de después. Llama a preventDefault() en el evento submit, o en el keydown de Enter, cuando la página deba conservar el valor y quedarse donde está. Maneja Enter en un solo lugar. Un listener de keydown y un listener de submit que aceptan ambos el escaneo lo registran dos veces.
Algunos escáneres mandan NumPad Enter. event.key sigue siendo "Enter". event.code puede ser "NumpadEnter" en vez de "Enter". Prueba event.key si ambas teclas deben confirmar el campo.
La guía Sufijos ENTER y TAB en los escáneres de códigos de barras compara esas dos opciones para el POS y los formularios web. Al escáner de códigos de barras le falta ENTER cubre un escáner que teclea el código de barras y luego se detiene.
TAB
TAB es la tecla Tab. El navegador mueve el foco después de keydown. Lee el campo en ese manejador de keydown, mientras todavía tiene el foco, y deja la acción predeterminada cuando el siguiente control deba recibir el cursor. preventDefault() deja el foco en el campo actual.
Shift+Tab es la misma tecla con Shift oprimido. Un sufijo Tab del escáner es Tab sin Shift. Ignora event.shiftKey si quien usa el teclado debe poder retroceder por el formulario.
CR
El retorno de carro lleva el cursor al inicio de la línea en una terminal. El byte es 0x0D. Un escáner serial puede agregar ese byte a la carga. Un ajuste de emulación de teclado llamado CR manda normalmente la tecla Enter en vez de insertar 0x0D en el texto. Oprimir Enter en un campo del navegador no escribe un carácter CR en input.value.
Si el host es una terminal o un programa que escucha un puerto COM, busca el byte. Si el host es una página web, busca event.key === "Enter".
LF
El avance de línea baja el cursor de la terminal una línea. El byte es 0x0A. Algunos hosts tratan LF solo como el salto de línea. Otros lo ignoran salvo que CR haya llegado primero. Un escáner en emulación que lista LF como sufijo puede mandar una tecla que el sistema operativo no convierte en salto de línea, o no mandar nada que un campo de texto conserve. Captura la tecla en el Inspector de eventos de teclado antes de manejar un supuesto LF en el código de la app.
CRLF
CRLF es la secuencia de dos controles, CR y luego LF. Los archivos de texto al estilo de Windows y muchos dispositivos seriales lo usan como un solo salto de línea. Una página de configuración que dice sufijo CRLF significa que el escáner va a intentar mandar ese par después de la carga en la interfaz que esté usando.
En un navegador, oprimir Enter no produce una secuencia CRLF literal dentro de un campo de texto. El formulario recibe un evento de teclado. Un <textarea> puede insertar un salto de línea cuando el usuario oprime Enter, y ese salto de línea es el comportamiento de edición del propio navegador, no una prueba de que el escáner emitió los bytes 0x0D 0x0A. Un lector serial puede recibir esos dos bytes y solo debe tratarlos como terminador si ese escáner se configuró para mandarlos. No quites CR ni LF de en medio de una carga que puede contenerlos.
Cómo inciden los prefijos y los sufijos en las apps web
Un escaneo en emulación de teclado es una ráfaga de teclazos hacia el control que tiene el foco. La página no abre el escáner. Si el foco está en otro campo, el prefijo, el código de barras y el sufijo se van todos para allá.
keydown se dispara con cada tecla, incluidas Enter y Tab, antes de que el navegador inserte un carácter o mueva el foco. event.key es el carácter o el nombre de la tecla después de que el sistema operativo aplique el diseño del teclado. Los caracteres imprimibles del prefijo y del sufijo aparecen en el campo por el evento input. Enter y Tab no aparecen.
El listener de abajo confirma el campo cuando llega Enter. No agrega un sufijo que el escáner omitió. Si el escáner no manda Enter, el valor se queda en el campo hasta que otra cosa lo lea.
const field = document.querySelector('#barcode')
if (!(field instanceof HTMLInputElement)) {
throw new Error('Barcode field was not found.')
}
field.addEventListener('keydown', (event) => {
if (event.key !== 'Enter') {
return
}
event.preventDefault()
const value = field.value.trim()
if (!value) {
return
}
console.log(value)
field.value = ''
})
Pon el foco en #barcode antes del escaneo. preventDefault() evita que un formulario padre se envíe una segunda vez. Si el campo no está dentro de un formulario y quieres el envío nativo, omite preventDefault().
Sin sufijo, espera una acción explícita: un botón, un Enter posterior de quien opera o el paso siguiente del flujo. Un temporizador de inactividad puede tomar una pausa como el fin del escaneo. Ese temporizador es una heurística. Un escáner lento, un retraso de Bluetooth o alguien que teclea rápido pueden caer del lado equivocado. Prefiere un sufijo configurado cuando el flujo necesita un fin claro.
Un prefijo imprimible conocido se puede quitar después de leer el valor:
function withoutConfiguredPrefix(value, prefix) {
if (prefix && value.startsWith(prefix)) {
return value.slice(prefix.length)
}
return value
}
Pasa solo el prefijo que configuraste, como ']C1'. No quites una cantidad arbitraria de caracteres de cada escaneo.
Para un formulario completo que también maneja Tab, una entrada vacía y un segundo escaneo, consulta Cómo probar escáneres de códigos de barras en aplicaciones web.
Cómo configurar prefijos y sufijos
Los ajustes de prefijo y sufijo viven en el escáner. Los nombres de las teclas y la forma de cambiarlos dependen del fabricante. No hay un código de barras de configuración que funcione en todas las marcas, y esta guía no imprime ninguno.
Métodos típicos:
- Escanea un código de barras de configuración del manual de ese modelo exacto. La hoja se agrupa por ajuste: sufijo, prefijo, diseño de teclado, simbología.
- Usa el programa de configuración del fabricante y luego escribe el resultado en el escáner por USB.
- Usa la utilidad de administración de dispositivos de esa línea cuando actualices muchas unidades.
Después de un cambio, escanea un código de barras conocido y compara el resultado con la descripción del ajuste elegido en el manual. Un restablecimiento de fábrica de otra marca puede dejar el escáner igual o ponerlo en un modo inesperado. La Guía de configuración del escáner de códigos de barras resume los ajustes que suelen importar. No reemplaza al manual.
El Barcode Scanner Emulator puede teclear un valor que elijas y después mandar ENTER, TAB o ningún sufijo. Mete un prefijo imprimible en ese valor cuando necesites ejercitar el manejo del prefijo sin hardware. El emulador no emite un par de bytes CR/LF serial y no lee una etiqueta.
Cómo probar el comportamiento del prefijo y del sufijo
Usa un escáner en modo teclado, teclado HID USB o teclado HID Bluetooth.
- Conéctalo y espera hasta que muestre que tiene energía.
- Abre el Verificador de entrada de códigos de barras.
- Haz clic en Start Test o en el área de escaneo. Se pone azul cuando está listo. La página no toma el foco sola.
- Escanea un código de barras cuya carga ya conozcas.
- Lee el valor capturado y la cantidad de caracteres. Los caracteres imprimibles del prefijo o del sufijo están dentro de esa cadena. La línea Prefix es para teclas con nombre que llegan antes del primer carácter, como un modificador. No saca un prefijo tecleado como
]C1del texto del código de barras. - Revisa el sufijo. El verificador reporta ENTER, TAB o None. Con Auto capture activado, el resultado aparece después de Enter, Tab o una pausa corta cuando las teclas se detienen. Apaga Auto capture para retener la captura hasta que oprimas Stop. Enter y Tab no forman parte de la cadena del código de barras.
- Compara ese resultado con la configuración que querías. Después abre el Inspector de eventos de teclado y vuelve a escanear cuando necesites cada
keydownen orden, incluidoskey,codey el tiempo.
El verificador de entrada registra los eventos de teclado que el navegador puede ver. No puede leer un puerto serial, así que no puede mostrar CR o LF como bytes en crudo. Una prueba en emulación no demuestra qué va a mandar un ajuste serial.
Solución de problemas
El escáner no manda ENTER. Aparece el código de barras y el cursor se queda en el campo. El verificador de entrada reporta None. El sufijo está apagado o está puesto en algo distinto de Enter. Consulta Al escáner de códigos de barras le falta ENTER.
TAB mueve el foco cuando no lo esperabas. El escáner manda la tecla Tab. Ese es el sufijo configurado. Usa Enter cuando el formulario deba enviarse, o lee el valor en el keydown de Tab cuando el flujo deba avanzar. Los detalles están en la guía Sufijos ENTER y TAB en los escáneres de códigos de barras.
El formulario se envía dos veces. El navegador envía con Enter y un listener de keydown también acepta el escaneo. Deja un solo camino de cierre y llama a preventDefault() en el otro.
Un prefijo aparece dentro del código de barras. Un prefijo imprimible forma parte de la cadena capturada. Apágalo en el escáner o quita esa secuencia exacta en la app. Un identificador de simbología activado es una fuente común de un ] al inicio y dos caracteres más. Un prefijo de control que la emulación no puede teclear va a faltar en vez de verse.
Los caracteres salen mal. El diseño del escáner y el del sistema operativo pueden no coincidir, y eso cambia los caracteres del prefijo y la puntuación mientras el largo sigue igual. Consulta Diseño de teclado incorrecto en el escáner de códigos de barras.
La app nunca ve el fin del escaneo. No hay sufijo y la página espera Enter. Agrega un sufijo que coincida con el formulario o completa el valor con una acción explícita. Una estimación de tiempo va a perder algunos escaneos reales y va a aceptar algo de tecleo.
CR/LF cambia de una app a otra. Notepad inserta una línea nueva cuando recibe Enter. Un campo de texto web conserva el código de barras y dispara un evento de tecla. Un programa serial puede recibir 0x0D, 0x0A o ambos. Compara la interfaz antes de cambiar el escáner. Si ninguna app recibe caracteres, empieza por El escáner de códigos de barras no funciona.
Un repaso más amplio del foco, los escaneos repetidos y los flujos de POS está en Cómo probar la entrada de un escáner de códigos de barras.
Matriz de pruebas
La columna de configuración es lo que dejas en el escáner, o lo que tecleas con el emulador cuando el caso es un sufijo de teclado. El comportamiento esperado es lo que debe hacer la app. Un caso CRLF serial no es la misma prueba que una tecla Enter en un navegador.
| Configuración | Comportamiento esperado de la app |
|---|---|
| Sin prefijo, sin sufijo | Se recibe el valor del código de barras y no llega ninguna tecla de cierre. El valor sigue disponible hasta que la app lo lee. |
| Sin prefijo, sufijo ENTER | La app recibe la tecla de cierre una vez y guarda la carga sin un carácter terminador. |
| Sin prefijo, sufijo TAB | El foco puede pasar al control siguiente. La app lee el valor antes de ese movimiento. |
| Prefijo imprimible personalizado | Los caracteres del prefijo aparecen antes de los datos decodificados. La app conserva o quita ese prefijo exacto a propósito. |
| Sufijo imprimible personalizado | Los caracteres del sufijo aparecen después de los datos decodificados. Enter y Tab son teclas, así que no aparecen en la cadena. |
| Secuencia CRLF | Un host serial o de terminal procesa los bytes CR y LF configurados. Un campo de texto del navegador no gana esos bytes con una pulsación de Enter. |
Corre las filas de teclado en el escáner en emulación y, cuando no haya hardware, con los ajustes ENTER, TAB y sin sufijo del emulador. Corre la fila CRLF en la interfaz que debe llevar esos bytes. Los resultados reales siguen dependiendo de esa interfaz y de la app.