Analice cabeceras HTTP y conviértalas en un objeto

Los nombres se normalizan en minúsculas, se elimina el espacio exterior de los valores y los nombres repetidos, como Set-Cookie, se conservan en orden como matrices en vez de sobrescribirse. Cada línea no vacía debe respetar la estructura estándar Name: Value; si no lo hace, se devuelve un error claro y nunca un resultado parcial.

Convierta bloques copiados en datos estructurados útiles

Las herramientas de desarrollo del navegador, los clientes de línea de comandos, los proxies inversos y los registros de servidor suelen mostrar las cabeceras HTTP como líneas de texto. Ese formato resulta cómodo para leer, pero no para consultar, comparar o almacenar mediante código. Este analizador convierte cada línea Name: Value válida en una propiedad de un único objeto headers. Los nombres pasan a minúsculas porque los campos HTTP no distinguen mayúsculas de minúsculas; por eso Content-Type y content-type representan la misma propiedad. Se elimina el espacio que rodea al valor, pero se mantienen los dos puntos que este contenga. Esto es importante para fechas, URL, esquemas de autorización y otros valores con puntuación legítima. Puede copiar el resultado directamente en una prueba, pasarlo a otro script o compararlo con una respuesta esperada. Se admite una línea vacía final, habitual como separador antes del cuerpo del mensaje. En cambio, una línea vacía o incorrecta dentro del bloque se rechaza para impedir que un análisis incompleto parezca válido.

Conserve las cabeceras duplicadas sin perder información

Un objeto JavaScript normal guarda un solo valor por clave, de modo que un analizador demasiado simple sobrescribe los valores anteriores cuando un nombre aparece varias veces. Ese comportamiento puede eliminar datos relevantes del protocolo sin aviso. Esta capacidad devuelve una cadena cuando la cabecera aparece una vez y transforma la propiedad en una matriz cuando vuelve a encontrar el mismo nombre, sin distinguir mayúsculas. Las apariciones posteriores se añaden en su orden original. La regla sirve para Set-Cookie, Warning, Link y cualquier otro campo repetido, sin intentar unir valores mediante comas. Evitar esa unión automática es deliberado: cada cabecera tiene sus propias reglas y Set-Cookie, en particular, no debe tratarse como una lista genérica separada por comas. Un valor vacío sigue siendo válido si existe el signo de dos puntos, por lo que X-Optional: se convierte en una cadena vacía. El analizador no interpreta fechas, cookies, tipos multimedia, ponderaciones de calidad ni credenciales; conserva el texto para que lo procese el componente que conoce esa cabecera.

Detecte pronto las líneas incorrectas y use el resultado con seguridad

Un análisis fiable depende tanto del rechazo correcto como de la conversión. Cada línea debe empezar por un nombre de campo HTTP válido, seguido inmediatamente de dos puntos y su valor. Los nombres pueden contener los caracteres token permitidos por HTTP, pero no espacios, tabulaciones, paréntesis, separadores ni espacio inicial. Las líneas de continuación plegadas, hoy obsoletas, se rechazan en vez de anexarse al valor anterior; así se evitan resultados ambiguos y se fomenta el uso de bloques modernos ya normalizados. Si la validación falla, el error indica la línea correspondiente y aclara si el problema afecta al par o al nombre. Nunca se devuelve un objeto parcial. Esto permite usar la capacidad en importaciones y pruebas automatizadas, donde aceptar solo parte del bloque sería peor que detener el proceso. El tratamiento es local y determinista: no utiliza red, campos dependientes de la hora, valores aleatorios ni consultas externas. El mismo texto siempre genera la misma estructura JSON en el navegador y mediante la API, cuyo precio base es $0.002.