Las expresiones regulares manuales y el uso básico de split('/') suelen fallar cuando se enfrentan a credenciales de autenticación básica, puertos explícitos, barras diagonales codificadas porcentualmente (%2F), sufijos públicos compuestos como .com.ar o .co.uk, o signos de interrogación incrustados dentro de fragmentos hash. Un analizador compatible con la especificación escanea los delimitadores en un orden sintáctico estricto antes de decodificar cada componente individual.
Considera una URL compleja de entrega de webhook que contiene credenciales, un subdominio multinivel, un puerto TLS no predeterminado, un segmento de ruta codificado, parámetros de consulta y un ancla de fragmento:
https://deploy:tok_9f8a@staging.api.example.co.uk:8443/v2/orgs/acme%20corp/webhooks?event=push&active=true#delivery-log
Al descomponer este URI se obtienen propiedades discretas y editables de forma independiente:
{
"href": "https://deploy:tok_9f8a@staging.api.example.co.uk:8443/v2/orgs/acme%20corp/webhooks?event=push&active=true#delivery-log",
"protocol": "https:",
"scheme": "https",
"username": "deploy",
"password": "tok_9f8a",
"origin": "https://staging.api.example.co.uk:8443",
"host": "staging.api.example.co.uk:8443",
"hostname": "staging.api.example.co.uk",
"subdomain": "staging.api",
"domain": "example.co.uk",
"tld": "co.uk",
"port": "8443",
"pathname": "/v2/orgs/acme%20corp/webhooks",
"pathSegments": ["v2", "orgs", "acme corp", "webhooks"],
"search": "?event=push&active=true",
"queryParams": {
"event": "push",
"active": "true"
},
"hash": "#delivery-log"
}
Modificación de Componentes sin Corromper los Escapes
Al depurar entre distintos entornos, a menudo es necesario redirigir una URL de callback capturada en producción o staging hacia un servicio local conservando intactos la codificación exacta de la ruta y los payloads de consulta firmados. Cambiar scheme a http, hostname a localhost, port a 3000 y vaciar username/password reconstruye limpiamente:
http://localhost:3000/v2/orgs/acme%20corp/webhooks?event=push&active=true#delivery-log
Observa que el tercer segmento de la ruta (acme corp) conserva automáticamente su codificación porcentual %20 dentro de pathname, evitando el truncamiento por espacios en blanco en las líneas de petición HTTP o en registros Markdown.