Самописні регулярні вирази та наївні конструкції на кшталт split('/') часто ламаються при зустрічі з обліковими даними basic-auth, явними портами, відсотково-кодованими слешами (%2F), складеними публічними суфіксами на зразок .co.uk або знаками питання всередині хеш-фрагментів. Парсер, що дотримується специфікації, сканує роздільники у суворому синтаксичному порядку перед декодуванням окремих компонентів.
Розглянемо складний URL доставки вебхука, що містить облікові дані, багаторівневий піддомен, нестандартний TLS-порт, закодований сегмент шляху, параметри запиту та хеш-якір:
https://deploy:tok_9f8a@staging.api.example.co.uk:8443/v2/orgs/acme%20corp/webhooks?event=push&active=true#delivery-log
Декомпозиція цього URI дає окремі, незалежнодаговані властивості:
{
"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"
}
Модифікація компонентів без пошкодження екранування
Під час налагодження між середовищами часто потрібно перенаправити перехоплений production- або staging-колбек на локальний сервіс, зберігши точне кодування шляху та підписані корисні навантаження у query. Зміна scheme на http, hostname на localhost, port на 3000 та очищення username/password чисто реконструює адресу:
http://localhost:3000/v2/orgs/acme%20corp/webhooks?event=push&active=true#delivery-log
Зверніть увагу, що третій сегмент шляху (acme corp) автоматично зберігає своє відсоткове кодування %20 всередині pathname, запобігаючи обрізанню за пробілом у рядках HTTP-запитів або логах Markdown.