Le espressioni regolari manuali e i semplici helper basati su split('/') falliscono spesso quando incontrano credenziali basic-auth, porte esplicite, barre codificate in percentuale (%2F), suffissi pubblici multi-parte come .co.uk o punti interrogativi incorporati all'interno dei frammenti hash. Un parser conforme alle specifiche analizza i delimitatori in rigoroso ordine sintattico prima di decodificare i singoli componenti.
Consideriamo un complesso URL di consegna webhook contenente credenziali, un sottodominio multilivello, una porta TLS non predefinita, un segmento di percorso codificato, parametri query e un'ancora di frammento:
https://deploy:tok_9f8a@staging.api.example.co.uk:8443/v2/orgs/acme%20corp/webhooks?event=push&active=true#delivery-log
La scomposizione di questo URI produce proprietà distinte e modificabili singolarmente:
{
"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"
}
Modificare i Componenti Senza Corrompere le Sequenze di Escape
Durante il debug tra ambienti diversi, capita spesso di dover reindirizzare un URL di callback di produzione o di staging verso un servizio locale mantenendo intatti la codifica esatta del percorso e i payload firmati della query. Cambiando scheme in http, hostname in localhost, port in 3000 e rimuovendo username/password, si ricostruisce in modo pulito:
http://localhost:3000/v2/orgs/acme%20corp/webhooks?event=push&active=true#delivery-log
Si noti che il terzo segmento del percorso (acme corp) mantiene automaticamente la sua codifica percentuale %20 all'interno di pathname, prevenendo il troncamento degli spazi bianchi nelle righe di richiesta HTTP o nei log Markdown.