쿼리스트링 구조와 파싱 가이드

쿼리스트링은 URL에서 ? 뒤에 오는 부분으로, 페이지에 추가 정보를 전달합니다. https://example.com/search?q=책&page=2에서 q=책&page=2가 쿼리스트링입니다.

구성 규칙

쿼리스트링은 키=값 쌍을 &로 이어 붙인 구조입니다.

• ? — 쿼리스트링의 시작을 알림
• = — 키와 값을 구분
• & — 여러 쌍을 구분
• # — 쿼리스트링의 끝(그 뒤는 프래그먼트/해시)

값에 특수문자가 있을 때

값 안에 &나 =가 들어가면 구분자와 헷갈리므로, 값은 반드시 encodeURIComponent로 인코딩해야 합니다. 예를 들어 검색어가 a&b라면 q=a%26b로 넣어야 파라미터가 하나로 유지됩니다. 공백은 인코딩 방식에 따라 %20 또는 +로 표현되며, 파싱할 때는 +를 공백으로 되돌려 해석하는 경우가 많습니다.

안전한 파싱

브라우저에는 쿼리스트링을 안전하게 다루는 URLSearchParams가 내장돼 있습니다. 직접 &로 자르기 전에 이 API를 쓰면 인코딩·중복 키·빈 값 같은 예외를 자동으로 처리해 줍니다.

이 사이트의 쿼리 파서 탭은 붙여넣은 URL을 구성 요소로 분해하고, 각 파라미터의 원본 값과 디코딩된 값을 나란히 보여 줍니다.