수동 정규 표현식이나 단순한 split('/') 헬퍼 함수는 Basic 인증 자격 증명, 명시적 포트, 퍼센트 인코딩된 슬래시(%2F), .co.kr이나 .co.uk 같은 다중 파트 공개 접미사(Public Suffix), 또는 해시 프래그먼트 내부에 포함된 물음표(?)를 만나면 자주 오작동합니다. 표준 명세를 준수하는 파서는 개별 구성 요소를 디코딩하기 전에 엄격한 구문 순서에 따라 구분자를 먼저 스캔합니다.
자격 증명, 다단계 서브도메인, 비기본 TLS 포트, 인코딩된 경로 세그먼트, 쿼리 파라미터 및 프래그먼트 앵커를 포함하는 복잡한 웹훅(Webhook) 전달 URL을 살펴보겠습니다.
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 요청 라인이나 마크다운 로그에서 공백으로 인해 URL이 잘리는 현상을 방지합니다.