Pruebas de formularios de dirección en 2026: una lista de verificación de QA de 40 puntos

Empieza por anotar cada campo, su propósito, su límite de almacenamiento y si es obligatorio. La mitad de los defectos de esta lista son imposibles de evaluar sin esa tabla, porque «el formulario rechazó mi dirección» no es accionable hasta que sabes qué campo la rechazó y por qué.

Las restricciones deben ser por país, no globales. Una longitud máxima única de 10 para el código postal funciona en la mayoría de los países y falla en Irlanda con 8 caracteres y un espacio, y un máximo global de 30 para la ciudad trunca muchas nombres reales. Establece límites generosos y valida el patrón del país en lugar de una longitud elegida para un solo mercado.

Cambiar el país debe restablecer la región, cambiar la etiqueta del campo postal, cambiar el teclado y el patrón, y borrar cualquier estado de validación obsoleto. El error clásico es una provincia canadiense que queda seleccionada tras cambiar a Estados Unidos, lo que envía un formulario de aspecto válido con un par de valores imposible.

Hong Kong y los Emiratos Árabes Unidos no tienen códigos postales, así que el campo debe volverse opcional y la etiqueta debe indicarlo. Japón invierte el orden de la dirección, y el formulario debe presentar los campos en el orden local o dejar claro que se espera el orden occidental. Prueba el cambio en ambas direcciones y prueba un cambio de país después de que ya se haya mostrado un error de validación.

Valida el formato al perder el foco, valida los campos obligatorios al enviar y borra un error en cuanto el valor sea válido. Validar en cada pulsación castiga al usuario que está a mitad de escribir un código postal, y validar solo al enviar hace que el usuario descubra seis errores a la vez sin ninguna orientación.

Nunca desactives el botón de envío como sustituto de la validación. Un botón desactivado sin explicación es la queja de accesibilidad más común en los formularios de dirección, porque el usuario no puede saber qué falta y un lector de pantalla puede no anunciar el cambio. Mantén el botón activo, envía y muestra un resumen con enlaces a cada campo.

Un mensaje de error debe decir qué campo está mal, cuál es el formato aceptado y cómo corregirlo. «Dirección no válida» falla en los tres. «El código postal debe tener 5 dígitos, por ejemplo 97205» los cumple. Para países cuyo formato es inusual, incluye un ejemplo en lugar de un patrón, porque los usuarios no leen expresiones regulares.

Coloca el error junto al campo y también en un resumen en la parte superior del formulario cuando este sea largo. Asócialo con aria-describedby y establece aria-invalid en el input. Mueve el foco al primer campo no válido al enviar, o al resumen si el resumen es interactivo. Prueba con un lector de pantalla, no solo visualmente.

Pegar es donde salen a la luz los errores de formato. Un usuario pega «K1A 0B1» con un espacio de no separación, o una dirección completa en la línea 1. El formulario debe recortar, normalizar los separadores conocidos y conservar los espacios internos. No debe eliminar los guiones de un ZIP+4 ni de un código neerlandés, y no debe convertir a mayúsculas el nombre de una ciudad que legítimamente tiene mayúsculas y minúsculas mezcladas.

El autocompletado depende de los nombres de token correctos. Usa address-line1, address-line2, address-level2 para la ciudad, address-level1 para la región, postal-code y country, y no reutilices street-address en un campo de una sola línea a menos que realmente sea un bloque de calle multilínea. En móvil, los teclados numéricos suelen carecer de guion, así que un ZIP+4 o un código neerlandés introducido con inputmode="numeric" se vuelve imposible de completar. Usa inputmode="text" donde el patrón permita separadores.

Prueba el límite y un carácter por encima para cada campo. El truncamiento es peor que el rechazo, porque el usuario ve un envío exitoso y el valor almacenado es incorrecto. Si la columna de la base de datos tiene 50 caracteres y el formulario permite 100, el defecto aparece solo con entradas largas, que es exactamente lo que nunca contienen los datos de prueba escritos a mano.

Prueba caracteres no ASCII: letras acentuadas, el apóstrofo en O Connell, el guion en un nombre de calle francés, la eszett en una calle alemana y escrituras de derecha a izquierda. Comprueba que el valor viaja de ida y vuelta por la API, la base de datos, la exportación CSV y la etiqueta impresa. Los errores de codificación a menudo aparecen solo en el paso de exportación, que es el paso que nadie prueba.

Cada campo necesita una etiqueta visible asociada programáticamente al input. El texto de marcador de posición no es una etiqueta: desaparece al escribir y se anuncia de forma inconsistente. Agrupa los campos de dirección en un fieldset con un legend, y haz que los selectores de país y región se puedan operar con el teclado con búsqueda por escritura.

Para locales de derecha a izquierda, establece dir en el contenedor y no en los inputs individuales, para que la puntuación y el icono de error queden en el lugar correcto. Comprueba que las etiquetas traducidas no se desbordan al 200 por ciento de zoom y que el resumen de errores se anuncia cuando aparece. Son comprobaciones baratas que detectan los defectos por los que cobran las auditorías de accesibilidad.

Convierte la lista de verificación en un pequeño paquete automatizado que se ejecute en cada cambio. Veinte casos cubren el conjunto de fallos: un caso válido y uno no válido para el mercado principal, un caso para Canadá, el Reino Unido, Alemania, Japón, Brasil, Hong Kong y los Emiratos Árabes Unidos, más longitudes límite, una ciudad no ASCII, un valor pegado con un espacio de no separación y un cambio de país después de un error.

Mantén cada caso independiente y con datos iniciales definidos. Verifica la forma del resultado en lugar de una cadena literal, y verifica el texto de error visible para los casos no válidos, porque las regresiones en los textos de error son regresiones reales. Un paquete de este tamaño se ejecuta en segundos y detecta la mayoría de los defectos descritos anteriormente.