मैनुअल रेगुलर एक्सप्रेशन और साधारण split('/') हेल्पर्स अक्सर बेसिक-ऑथ क्रेडेंशियल्स, स्पष्ट पोर्ट्स, परसेंट-एनकोडेड स्लैश (%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"
}
एस्केप सीक्वेंस को खराब किए बिना कॉम्पोनेंट्स में बदलाव करना
अलग-अलग एनवायरनमेंट में डीबगिंग करते समय, आपको अक्सर सटीक पाथ एनकोडिंग और साइन किए गए क्वेरी पेलोड को सुरक्षित रखते हुए कैप्चर किए गए प्रोडक्शन या स्टेजिंग कॉलबैक URL को लोकल सर्विस की ओर पॉइंट करने की आवश्यकता होती है। scheme को http, hostname को localhost, port को 3000 में बदलने और username/password को हटाने से यह साफ़-सुथरे ढंग से फिर से तैयार हो जाता है:
http://localhost:3000/v2/orgs/acme%20corp/webhooks?event=push&active=true#delivery-log
ध्यान दें कि तीसरा पाथ सेगमेंट (acme corp) स्वचालित रूप से pathname के अंदर अपनी %20 परसेंट-एनकोडिंग को बनाए रखता है, जिससे HTTP रिक्वेस्ट लाइनों या Markdown लॉग्स में व्हाइटस्पेस के कारण लिंक टूटने से बचाव होता है।