Analizar una consulta URL como objeto clave-valor

Decodifica los escapes porcentuales y los signos más usados por formularios, conserva los valores vacíos y reúne en listas los parámetros que se repiten, sin alterar su orden. Si encuentra escapes defectuosos o UTF-8 inválido, devuelve un error claro en vez de sustituir caracteres. Puede usarlo para revisar enlaces en el navegador o llamar a la API determinista por $0.002 por elemento desde pruebas, aplicaciones y flujos de importación.

Elija la forma de entrada adecuada para su origen

Puede enviar una URL absoluta completa, como <code>https://example.com/search?q=red+shoes</code>, una consulta sin procesar, como <code>q=red+shoes&amp;page=2</code>, o esa misma consulta precedida por un signo de interrogación. En una URL absoluta solo se analiza el componente de consulta: el esquema, la autoridad, la ruta y el fragmento no se convierten en campos. Una URL sin consulta produce un objeto de parámetros vacío. La entrada sin procesar se considera íntegramente información de consulta después de retirar, si existe, el signo de interrogación inicial. Esta modalidad resulta útil cuando un framework, un registro de acceso, un webhook o una API del navegador ya ha separado la consulta del resto de la dirección. Cada signo &amp; inicia un nuevo par y el primer signo igual separa el nombre de su valor. Un nombre sin igual se conserva con un valor vacío, al igual que una asignación explícitamente vacía. Los segmentos vacíos entre dos signos &amp; se omiten. El resultado indica además cuántas claves distintas y cuántos pares se analizaron, para que usted pueda reconocer las repeticiones sin volver a contar el objeto.

Comprenda la decodificación y las claves repetidas

Los nombres y los valores se decodifican por separado según las reglas habituales de los formularios en consultas URL. Un signo más se convierte en espacio, mientras que las secuencias <code>%HH</code> se interpretan como bytes UTF-8. Así, <code>city=San+Jos%C3%A9</code> produce texto Unicode legible, y un separador codificado como <code>%26</code> permanece dentro de un único valor en lugar de iniciar otro campo. La decodificación se realiza una sola vez: <code>%2520</code> se convierte en <code>%20</code>, no en un espacio. Cuando una clave aparece una vez, su valor es una cadena. Si la misma clave decodificada vuelve a aparecer, el valor pasa a ser una lista que conserva todas las apariciones en el orden original. Esta regla representa grupos de casillas, filtros, etiquetas y otros controles de selección múltiple sin perder información ni inventar propiedades numeradas. La repetición se determina después de decodificar, por lo que distintas grafías codificadas de un mismo nombre quedan agrupadas. Los valores vacíos repetidos también se conservan. El analizador no deduce booleanos, números o fechas ni interpreta corchetes como objetos anidados: todos los valores simples siguen siendo cadenas para que el código posterior aplique conscientemente sus propias conversiones.

Detenga los datos dañados antes de incorporarlos al flujo

Algunos analizadores permisivos conservan un signo de porcentaje aislado, aceptan escapes de un solo dígito o insertan un carácter de sustitución cuando los bytes codificados no forman UTF-8 válido. Esos comportamientos hacen que identificadores dañados parezcan utilizables y provocan diferencias difíciles de rastrear entre el navegador, el servidor y una rutina de verificación de firmas. Esta capacidad comprueba que cada signo de porcentaje vaya seguido exactamente de dos dígitos hexadecimales y luego verifica que cada secuencia de bytes decodificada sea UTF-8 válido. Si alguna condición falla, devuelve un error de entrada inválida en lugar de un objeto parcial. El proceso es puro y determinista: no consulta la red, no sigue redirecciones, no lee el reloj, no usa azar y no conserva estado entre llamadas. Considere las cadenas resultantes como datos, no como HTML, código, rutas de archivo ni expresiones de base de datos confiables; decodificar recupera caracteres, pero no garantiza la seguridad de su uso posterior. En automatizaciones, la API cuesta $0.002 por elemento y ofrece un paso de normalización estable antes de validar, dirigir, comparar o guardar información. En el navegador puede examinar rápidamente enlaces copiados sin contactar con su destino.