Barcode Scanner Emulator
Prefijo y sufijo del lector de códigos de barras: guía completa
Un prefijo es un dato o una secuencia de control que un lector de códigos de barras envía antes del código de barras descodificado. Un sufijo es lo que envía después de ese valor. El mismo modelo puede ajustarse con prefijos y sufijos distintos, y un lector serie no los entrega igual que un lector en cuña de teclado.
Un prefijo de lector de códigos de barras se envía antes del valor descodificado. Un sufijo se envía después. Un lector puede producir esta secuencia:
Prefijo: STX
Código de barras: 123456789
Sufijo: ENTER
En un manual, STX suele significar el carácter de control, no las tres letras S, T y X. En un lector en cuña de teclado, ENTER suele ser la tecla Intro, no los dos caracteres CR y LF insertados en un campo de texto. Cuál recibes depende del modelo, de la interfaz y de la aplicación. Ningún ajuste vale para todos los aparatos.
La guía Sufijos ENTER y TAB en los lectores de códigos de barras se queda en elegir y resolver esos dos terminadores. Esta guía trata el marco alrededor del código de barras: qué va antes, qué va después y cómo debe leer ambos una aplicación web.
Qué es un prefijo de lector de códigos de barras
Un prefijo es una secuencia configurada que el lector transmite antes de la carga útil. La carga útil es el texto que descodificó la simbología, como 123456789. El prefijo no forma parte de esa descodificación, salvo que el lector se haya ajustado para añadirlo.
Usos habituales:
- Marcar el inicio de un mensaje. Los protocolos serie y de terminal a veces envían un carácter de control, a menudo llamado STX, para que el host sepa que ha empezado una trama nueva.
- Nombrar la simbología. Con el identificador de simbología AIM activado, un lector puede enviar un prefijo imprimible corto, como
]C1para Code 128 o]E0para EAN, antes de los dígitos. La aplicación puede ramificarse según ese identificador. - Enrutar la entrada en software de POS o de terminal más antiguo. Un código fijo antes de los datos indicaba al host a qué campo o dispositivo pertenecía la lectura.
- Etiquetar un puesto concreto. Dos lectores pueden recibir prefijos imprimibles distintos para que un registro muestre qué carril envió el código.
Un prefijo imprimible son caracteres ordinarios. Aparecen en un campo de texto al principio de la cadena. Un prefijo de carácter de control, como STX (0x02), no son las letras S, T y X. Un lector en cuña de teclado puede ser incapaz de teclear ese carácter de control. Un lector serie puede enviarlo como un byte. Lee el manual del modelo que tienes antes de escribir código que espere uno u otro.
Un prefijo no demuestra que un lector 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 útil como cualquier otra entrada de usuario.
Qué es un sufijo de lector de códigos de barras
Un sufijo es una secuencia configurada que se envía después de la carga útil. Su tarea habitual es decirle a la aplicación que la lectura ha terminado, o mover el foco. Los lectores difieren. Algunos ofrecen Intro, Tabulación, CR, LF, CR+LF, una cadena personalizada o nada. Algunos solo ofrecen una o dos de esas opciones.
ENTER. La tecla Intro. En un navegador es un evento de teclado, event.key === "Enter". No se inserta en un campo de texto normal.
TAB. La tecla de tabulación, event.key === "Tab". El navegador mueve el foco al control siguiente. La tecla no se inserta en el campo.
CR. Retorno de carro, ASCII 0x0D. En una interfaz serie o de terminal puede ser un byte real después de la carga útil. En una cuña de teclado, un ajuste etiquetado CR o retorno de carro suele significar la tecla Intro. El navegador sigue informando Intro. El valor del campo no gana un carácter CR.
LF. Salto de línea, ASCII 0x0A. Es un carácter de control distinto de CR. En un flujo serie puede ser su propio byte. Una cuña de teclado no tiene una tecla estándar de salto de línea como tiene Intro y Tab. No des por hecho que una opción de menú llamada LF teclea un carácter visible o un segundo Intro.
CRLF. CR seguido de LF, los dos bytes 0x0D 0x0A. Algunos hosts serie y de terminal esperan ese par como fin de línea. Un campo de texto del navegador no guarda ese par cuando alguien pulsa Intro.
Caracteres personalizados. Un sufijo imprimible como # o un código corto se teclea después del código de barras, así que pasa a formar parte de la cadena, salvo que la aplicación lo quite. Un carácter de control personalizado sigue la misma división que STX: bytes en un puerto serie, pulsaciones en una cuña y solo las pulsaciones que la interfaz de teclado puede enviar de verdad.
ENTER, CR y LF son nombres emparentados de fin de línea en los manuales. No son intercambiables en todas las aplicaciones. Un lector en cuña, un lector serie, 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 la finalización o disparar una acción |
| Ejemplo | STX, o un identificador AIM imprimible como ]C1 |
ENTER, TAB o un carácter imprimible como # |
| Uso habitual | Enmarcar o identificar la lectura | 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. Intro 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 sitio hasta que la aplicación tenga una regla para él.
ENTER, TAB, CR y LF
Estos nombres aparecen en las hojas de configuración. El lado que recibe ve pulsaciones o bytes, según la interfaz. La guía Cuña de teclado HID describe el camino de las pulsaciones. Un puerto serie es otro camino: la aplicación lee bytes y el foco no elige adónde van.
ENTER
En un lector en cuña de teclado, ENTER es la tecla Intro. Dentro de un campo de texto de una línea, los navegadores actuales usan esa tecla para enviar el formulario que lo contiene. Un cuadro de búsqueda puede confirmar la lectura en ese evento. Un formulario de varios campos puede enviarse antes de que se rellenen los campos posteriores. Llama a preventDefault() en el evento submit, o en el keydown de Intro, cuando la página deba conservar el valor y quedarse donde está. Trata Intro en un solo sitio. Un oyente keydown y un oyente submit que aceptan ambos la lectura la registran dos veces.
Algunos lectores envían NumPad Enter. event.key sigue siendo "Enter". event.code puede ser "NumpadEnter" en lugar de "Enter". Prueba event.key si ambas teclas deben confirmar el campo.
La guía Sufijos ENTER y TAB en los lectores de códigos de barras compara esas dos opciones para el POS y los formularios web. Al lector de códigos de barras le falta ENTER trata un lector que teclea el código de barras y luego se detiene.
TAB
TAB es la tecla de tabulación. El navegador mueve el foco después de keydown. Lee el campo en ese controlador keydown, mientras todavía tiene el foco, y deja la acción predeterminada en su sitio cuando el control siguiente deba recibir el cursor. preventDefault() mantiene el foco en el campo actual.
Mayús+Tab es la misma tecla con Mayús pulsada. Un sufijo Tab del lector es Tab sin Mayús. 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 un terminal. El byte es 0x0D. Un lector serie puede añadir ese byte a la carga útil. Un ajuste de cuña de teclado llamado CR suele enviar la tecla Intro en lugar de insertar 0x0D en el texto. Pulsar Intro en un campo del navegador no escribe un carácter CR en input.value.
Si el host es un terminal o un programa a la escucha de un puerto COM, busca el byte. Si el host es una página web, busca event.key === "Enter".
LF
El salto de línea baja el cursor del 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 antes. Un lector en cuña que ofrece LF como sufijo puede enviar una tecla que el sistema operativo no convierte en salto de línea, o no enviar nada que un campo de texto conserve. Captura la tecla en el Probador de eventos de teclado antes de tratar un supuesto LF en el código de la aplicación.
CRLF
CRLF es la secuencia de dos controles, CR y después LF. Los archivos de texto al estilo de Windows y muchos dispositivos serie lo usan como un solo salto de línea. Una página de configuración que dice sufijo CRLF significa que el lector intentará enviar ese par después de la carga útil en la interfaz que esté usando.
En un navegador, pulsar Intro 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 pulsa Intro, y ese salto de línea es el comportamiento de edición propio del navegador, no una prueba de que el lector emitió los bytes 0x0D 0x0A. Un lector serie puede recibir esos dos bytes y solo debe tratarlos como terminador si ese lector se configuró para enviarlos. No quites CR ni LF del medio de una carga útil que puede contenerlos.
Cómo afectan los prefijos y los sufijos a las aplicaciones web
Una lectura en cuña de teclado es una ráfaga de pulsaciones hacia el control que tiene el foco. La página no abre el lector. Si el foco está en otro campo, el prefijo, el código de barras y el sufijo van todos allí.
keydown se dispara para cada tecla, incluidas Intro 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 la distribución del teclado. Los caracteres imprimibles del prefijo y del sufijo aparecen en el campo mediante el evento input. Intro y Tab no aparecen.
El oyente de abajo confirma el campo cuando llega Intro. No añade un sufijo que el lector omitió. Si el lector no envía Intro, el valor permanece 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 de la lectura. preventDefault() impide que un formulario antecesor 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 Intro posterior del operador o el paso siguiente del flujo. Un temporizador de inactividad puede tratar una pausa como el final de la lectura. Ese temporizador es una heurística. Un lector lento, un retraso de Bluetooth o alguien que teclea deprisa pueden caer en el lado equivocado. Prefiere un sufijo configurado cuando el flujo necesita un final definido.
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 un número arbitrario de caracteres de cada lectura.
Para un formulario completo que también trata Tab, una entrada vacía y una segunda lectura, consulta Cómo probar lectores de códigos de barras en aplicaciones web.
Cómo configurar prefijos y sufijos
Los ajustes de prefijo y sufijo están en el lector. 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 habituales:
- Lee un código de barras de configuración del manual de ese modelo exacto. La hoja se agrupa por ajuste: sufijo, prefijo, distribución de teclado, simbología.
- Usa el programa de configuración del fabricante y escribe después el resultado en el lector por USB.
- Usa la utilidad de gestión de dispositivos de esa línea de producto cuando actualices muchas unidades.
Después de un cambio, lee 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 lector igual o ponerlo en un modo inesperado. La Guía de configuración del lector de códigos de barras resume los ajustes que suelen importar. No sustituye al manual.
El Barcode Scanner Emulator puede teclear un valor que elijas y después enviar ENTER, TAB o ningún sufijo. Pon un prefijo imprimible en ese valor cuando necesites ejercitar el tratamiento del prefijo sin hardware. El emulador no emite un par de bytes CR/LF de serie y no lee una etiqueta.
Cómo probar el comportamiento del prefijo y del sufijo
Usa un lector en modo teclado, teclado HID USB o teclado HID Bluetooth.
- Conéctalo y espera hasta que indique que tiene alimentación.
- Abre el Probador de entrada de códigos de barras.
- Haz clic en Start Test o en el área de lectura. Se pone azul cuando está listo. La página no toma el foco por sí sola.
- Lee un código de barras cuya carga útil ya conozcas.
- Lee el valor capturado y el número 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. - Comprueba el sufijo. El probador informa ENTER, TAB o None. Con Auto capture activado, el resultado aparece después de Intro, Tab o una pausa breve cuando las teclas se detienen. Desactiva Auto capture para retener la captura hasta que pulses Stop. Intro y Tab no forman parte de la cadena del código de barras.
- Compara ese resultado con la configuración que pretendías. Después abre el Probador de eventos de teclado y vuelve a leer cuando necesites cada
keydownen orden, incluidoskey,codey el tiempo.
El probador de entrada registra los eventos de teclado que el navegador puede ver. No puede leer un puerto serie, así que no puede mostrar CR o LF como bytes en bruto. Una prueba en cuña no demuestra qué enviará un ajuste serie.
Resolución de problemas
El lector no envía ENTER. Aparece el código de barras y el cursor se queda en el campo. El probador de entrada informa None. El sufijo está desactivado o está ajustado a algo distinto de Intro. Consulta Al lector de códigos de barras le falta ENTER.
TAB mueve el foco de forma inesperada. El lector envía la tecla de tabulación. Ese es el sufijo configurado. Usa Intro 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 lectores de códigos de barras.
El formulario se envía dos veces. El navegador envía con Intro y un oyente keydown también acepta la lectura. Conserva un solo camino de finalización 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. Desactívalo en el lector o quita esa secuencia exacta en la aplicación. Un identificador de simbología activado es una fuente habitual de un ] inicial y dos caracteres más. Un prefijo de control que la cuña no puede teclear faltará en lugar de verse.
Los caracteres son incorrectos. La distribución del lector y la del sistema operativo pueden no coincidir, lo que cambia los caracteres del prefijo y la puntuación mientras la longitud sigue igual. Consulta Distribución de teclado incorrecta en el lector de códigos de barras.
La aplicación nunca ve el final de la lectura. No hay sufijo y la página espera Intro. Añade un sufijo que encaje con el formulario o completa el valor con una acción explícita. Una estimación de tiempo pasará por alto algunas lecturas reales y aceptará algo de tecleo.
CR/LF difiere entre aplicaciones. Notepad inserta una línea nueva cuando recibe Intro. Un campo de texto web conserva el código de barras y dispara un evento de tecla. Un programa serie puede recibir 0x0D, 0x0A o ambos. Compara la interfaz antes de cambiar el lector. Si ninguna aplicación recibe caracteres, empieza por El lector de códigos de barras no funciona.
Un repaso más amplio del foco, las lecturas repetidas y los flujos de POS está en Cómo probar la entrada de un lector de códigos de barras.
Matriz de pruebas
La columna de configuración es lo que ajustas en el lector, o lo que tecleas con el emulador cuando el caso es un sufijo de teclado. El comportamiento esperado es lo que debe hacer la aplicación. Un caso CRLF serie no es la misma prueba que una tecla Intro en un navegador.
| Configuración | Comportamiento esperado de la aplicación |
|---|---|
| Sin prefijo, sin sufijo | Se recibe el valor del código de barras y no llega ninguna tecla de finalización. El valor sigue disponible hasta que la aplicación lo lee. |
| Sin prefijo, sufijo ENTER | La aplicación recibe la tecla de finalización una vez y guarda la carga útil sin un carácter terminador. |
| Sin prefijo, sufijo TAB | El foco puede pasar al control siguiente. La aplicación lee el valor antes de ese movimiento. |
| Prefijo imprimible personalizado | Los caracteres del prefijo aparecen antes de los datos descodificados. La aplicación conserva o quita ese prefijo exacto a propósito. |
| Sufijo imprimible personalizado | Los caracteres del sufijo aparecen después de los datos descodificados. Intro y Tab son teclas, así que no aparecen en la cadena. |
| Secuencia CRLF | Un host serie 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 Intro. |
Ejecuta las filas de teclado en el lector en cuña y, cuando no haya hardware, con los ajustes ENTER, TAB y sin sufijo del emulador. Ejecuta la fila CRLF en la interfaz que deba transportar esos bytes. Los resultados reales siguen dependiendo de esa interfaz y de la aplicación.