การใช้ Regular Expression ที่เขียนขึ้นเองหรือฟังก์ชัน split('/') แบบพื้นฐานมักทำงานผิดพลาดเมื่อเจอกับข้อมูลรับรองแบบ basic-auth, การระบุหมายเลขพอร์ต, เครื่องหมายทับที่เข้ารหัสเปอร์เซ็นต์ (%2F), นามสกุลโดเมนสาธารณะแบบหลายระดับ เช่น .co.uk หรือเครื่องหมายคำถามที่ซ่อนอยู่ในแฟรกเมนต์ hash ตัวแยกวิเคราะห์ที่อ้างอิงตามข้อกำหนดมาตรฐานจะสแกนหาตัวคั่นตามลำดับไวยากรณ์ที่เคร่งครัดก่อนที่จะถอดรหัสแต่ละส่วนประกอบ
ลองพิจารณา URL สำหรับส่งข้อมูล webhook ที่ซับซ้อน ซึ่งประกอบด้วยข้อมูลเข้าสู่ระบบ, ซับโดเมนหลายระดับ, พอร์ต TLS ที่ไม่ใช่ค่าเริ่มต้น, ส่วนของ path ที่ถูกเข้ารหัส, พารามิเตอร์ query และจุดอ้างอิง fragment:
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"
}
การแก้ไขส่วนประกอบโดยไม่ทำให้รหัสอักขระเสียหาย
เมื่อต้องดีบักข้ามสภาพแวดล้อม คุณมักจะต้องเปลี่ยนลิงก์ callback ที่ดึงมาจากระบบ production หรือ staging ให้ชี้มายังบริการในเครื่อง (local service) โดยที่ต้องรักษารหัสการเข้ารหัสของ path และข้อมูล query ที่ลงนามไว้ให้เหมือนเดิมทุกประการ การเปลี่ยน scheme เป็น http, เปลี่ยน hostname เป็น localhost, เปลี่ยน port เป็น 3000 และล้างค่า username/password ออก จะช่วยสร้าง URL ใหม่อย่างสะอาดหมดจดดังนี้:
http://localhost:3000/v2/orgs/acme%20corp/webhooks?event=push&active=true#delivery-log
สังเกตว่าส่วนย่อยที่สามของพาร์ท (acme corp) จะยังคงรักษารหัสเปอร์เซ็นต์ %20 ไว้ภายใน pathname โดยอัตโนมัติ ช่วยป้องกันปัญหาข้อความขาดหายจากช่องว่างในบรรทัดคำขอ HTTP หรือในบันทึกเอกสารแบบ Markdown