Ręcznie pisane wyrażenia regularne i naiwne funkcje pomocnicze oparte na split('/') często zawodzą w zetknięciu z danymi uwierzytelniającymi basic-auth, jawnymi portami, ukośnikami zakodowanymi procentowo (%2F), wieloczłonowymi sufiksami publicznymi takimi jak .co.uk czy znakami zapytania osadzonymi wewnątrz fragmentów hash. Parser zgodny ze specyfikacją skanuje separatory w ścisłej kolejności syntaktycznej przed zdekodowaniem poszczególnych komponentów.
Rozważmy złożony adres URL docelowego webhooka zawierający poświadczenia, wielopoziomową subdomenę, niestandardowy port TLS, zakodowany segment ścieżki, parametry query oraz kotwicę fragmentu:
https://deploy:tok_9f8a@staging.api.example.co.uk:8443/v2/orgs/acme%20corp/webhooks?event=push&active=true#delivery-log
Dekompozycja tego identyfikatora URI zwraca osobne, niezależnie edytowalne właściwości:
{
"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"
}
Modyfikacja komponentów bez uszkadzania znaków ucieczki
Podczas debugowania między środowiskami często trzeba przekierować przechwycony produkcyjny lub testowy adres zwrotny (callback URL) na lokalną usługę, zachowując dokładne kodowanie ścieżki i podpisane ładunki zapytania. Zmiana scheme na http, hostname na localhost, port na 3000 oraz wyczyszczenie pól username/password pozwala czysto zrekonstruować adres:
http://localhost:3000/v2/orgs/acme%20corp/webhooks?event=push&active=true#delivery-log
Zwróć uwagę, że trzeci segment ścieżki (acme corp) automatycznie zachowuje swoje kodowanie procentowe %20 wewnątrz pathname, co zapobiega ucięciu białych znaków w liniach żądań HTTP lub logach Markdown.