Manuella reguljära uttryck och naiva split('/')-funktioner går ofta sönder när de stöter på basic-auth-uppgifter, explicita portar, procentkodade snedstreck (%2F), flerdelade publika suffix som .co.uk eller frågetecken inbäddade i hash-fragment. En specifikationsmedveten parser skannar avgränsare i strikt syntaktisk ordning innan enskilda komponenter avkodas.
Betrakta en komplex webhook-URL som innehåller inloggningsuppgifter, en subdomän i flera nivåer, en icke-standardiserad TLS-port, ett kodat sökvägssegment, query-parametrar och ett fragmentankare:
https://deploy:tok_9f8a@staging.api.example.co.uk:8443/v2/orgs/acme%20corp/webhooks?event=push&active=true#delivery-log
När denna URI bryts ned skapas separata, individuellt redigerbara egenskaper:
{
"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"
}
Ändra komponenter utan att förstöra kodade tecken
Vid felsökning mellan miljöer behöver man ofta peka om en infångad callback-URL från produktion eller staging till en lokal tjänst, samtidigt som exakt sökvägskodning och signerade query-nyttolaster bevaras. Om du ändrar scheme till http, hostname till localhost, port till 3000 och rensar username/password rekonstrueras följande felfritt:
http://localhost:3000/v2/orgs/acme%20corp/webhooks?event=push&active=true#delivery-log
Observera att det tredje sökvägssegmentet (acme corp) automatiskt behåller sin procentkodning (%20) i pathname, vilket förhindrar att blanksteg klipper av länken i HTTP-anropsrader eller Markdown-loggar.