Manuel düzenli ifadeler (regex) ve basit split('/') yardımcı fonksiyonları; basic-auth kimlik bilgileri, açık portlar, yüzde kodlamalı eğik çizgiler (%2F), .co.uk gibi çok parçalı genel sonekler veya hash fragment'ları içine gömülü soru işaretleriyle karşılaştığında sıklıkla bozulur. Spesifikasyonlara duyarlı bir ayrıştırıcı, tekil bileşenlerin kodunu çözmeden önce sınırlayıcıları katı bir sözdizimsel sırayla tarar.
Kimlik bilgileri, çok seviyeli bir alt alan adı, varsayılan olmayan bir TLS portu, kodlanmış bir yol segmenti, sorgu parametreleri ve bir fragment çapası içeren karmaşık bir webhook teslimat URL'sini ele alalım:
https://deploy:tok_9f8a@staging.api.example.co.uk:8443/v2/orgs/acme%20corp/webhooks?event=push&active=true#delivery-log
Bu URI'nin ayrıştırılması ayrık ve bağımsız olarak düzenlenebilir özellikler üretir:
{
"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"
}
Kaçış Dizilerini Bozmadan Bileşenleri Değiştirme
Farklı ortamlar arasında hata ayıklarken, genellikle yakalanan bir canlı (production) veya staging geri çağırma URL'sini, tam yol kodlamasını ve imzalı sorgu yüklerini koruyarak yerel bir servise yönlendirmeniz gerekir. scheme değerini http, hostname değerini localhost, port değerini 3000 olarak değiştirmek ve username/password alanlarını temizlemek URL'yi temiz bir şekilde yeniden oluşturur:
http://localhost:3000/v2/orgs/acme%20corp/webhooks?event=push&active=true#delivery-log
Üçüncü yol segmentinin (acme corp), HTTP istek satırlarında veya Markdown günlüklerinde boşluk kaynaklı kesilmeleri önlemek için pathname içinde %20 yüzde kodlamasını otomatik olarak koruduğuna dikkat edin.