Các biểu thức chính quy viết tay và hàm hỗ trợ split('/') đơn giản thường xuyên gặp lỗi khi xử lý thông tin xác thực basic-auth, cổng chỉ định tường minh, dấu gạch chéo mã hóa phần trăm (%2F), hậu tố tên miền công cộng nhiều phần như .co.uk, hoặc dấu chấm hỏi nằm bên trong hash fragment. Một bộ phân tích tuân thủ đặc tả sẽ quét các dấu phân cách theo đúng thứ tự cú pháp nghiêm ngặt trước khi giải mã từng thành phần riêng lẻ.
Hãy xem xét một URL gửi webhook phức tạp chứa thông tin đăng nhập, tên miền phụ nhiều cấp, cổng TLS không mặc định, phân đoạn đường dẫn được mã hóa, tham số truy vấn và điểm neo fragment:
https://deploy:tok_9f8a@staging.api.example.co.uk:8443/v2/orgs/acme%20corp/webhooks?event=push&active=true#delivery-log
Khi bóc tách URI này, ta thu được các thuộc tính rời rạc và có thể chỉnh sửa độc lập:
{
"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"
}
Thay Đổi Thành Phần Mà Không Làm Hỏng Mã Hóa Chuỗi
Khi gỡ lỗi giữa các môi trường, bạn thường cần trỏ một URL callback thu được từ môi trường production hoặc staging về dịch vụ chạy cục bộ nhưng vẫn phải giữ nguyên mã hóa đường dẫn và các payload truy vấn đã ký. Việc đổi scheme thành http, hostname thành localhost, port thành 3000, đồng thời xóa username/password sẽ tái tạo chính xác chuỗi sau:
http://localhost:3000/v2/orgs/acme%20corp/webhooks?event=push&active=true#delivery-log
Lưu ý rằng phân đoạn đường dẫn thứ ba (acme corp) tự động giữ nguyên mã hóa phần trăm %20 bên trong pathname, ngăn chặn lỗi cắt cụt khoảng trắng trong dòng yêu cầu HTTP hoặc nhật ký Markdown.