Handmatige reguliere expressies en simpele split('/')-hulpfuncties lopen vaak vast op basic-auth-inloggegevens, expliciete poorten, procent-gecodeerde schuine strepen (%2F), meerdelige publieke extensies zoals .co.uk, of vraagtekens binnenin hash-fragmenten. Een parser die de specificaties volgt, scant scheidingstekens in strikte syntactische volgorde voordat individuele componenten worden gedecodeerd.
Neem bijvoorbeeld een complexe webhook-URL met inloggegevens, een subdomein met meerdere niveaus, een niet-standaard TLS-poort, een gecodeerd padsegment, queryparameters en een fragment-anker:
https://deploy:tok_9f8a@staging.api.example.co.uk:8443/v2/orgs/acme%20corp/webhooks?event=push&active=true#delivery-log
Het ontleden van deze URI levert afzonderlijke, onafhankelijk bewerkbare eigenschappen op:
{
"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"
}
Componenten aanpassen zonder escape-sequenties te beschadigen
Bij het debuggen tussen verschillende omgevingen wil je vaak een onderschepte productie- of staging-callback-URL naar een lokale service laten verwijzen, met behoud van de exacte padcodering en ondertekende query-payloads. Door scheme te wijzigen in http, hostname in localhost, port in 3000 en username/password leeg te maken, wordt de URL netjes gereconstrueerd:
http://localhost:3000/v2/orgs/acme%20corp/webhooks?event=push&active=true#delivery-log
Merk op dat het derde padsegment (acme corp) automatisch zijn %20-procentcodering binnen pathname behoudt, wat voorkomt dat spaties de URL afbreken in HTTP-requestregels of Markdown-logs.