🌐 KO

🧩 쿼리 스트링 빌더

키(key)와 값(value) 행을 추가하면 URLSearchParams로 정확하게 퍼센트 인코딩된 쿼리 스트링을 즉시 생성합니다. 기본 URL을 함께 입력하면 완성된 전체 URL을 바로 확인할 수 있고, 반대로 기존 쿼리 스트링이나 URL을 붙여넣으면 각 파라미터를 표로 분해해 보여줍니다.

결과

            
가이드

자세히 알아보기

01

1. 왜 URLSearchParams로 인코딩해야 하나요?

쿼리 스트링에는 한글, 공백, `&`, `=`, `#` 같은 특수문자가 자주 들어갑니다. 이를 손으로 이어붙이면 인코딩 누락·이중 인코딩·구분자 충돌 같은 버그가 쉽게 생깁니다. URLSearchParams는 브라우저 표준 API로, 각 값을 application/x-www-form-urlencoded 규칙에 맞춰 정확히 퍼센트 인코딩하고 `&`로 안전하게 연결해 줍니다. 이 도구는 그 로직을 그대로 사용해 결과를 만듭니다.

02

2. 중복 키는 어떻게 처리되나요?

`category=IT&category=Dev`처럼 같은 키가 여러 번 나오는 쿼리 스트링은 다중 선택 필터나 배열 파라미터에서 흔합니다. 파싱 탭은 URLSearchParams.entries()로 모든 항목을 순서대로 읽어, 같은 키라도 값마다 별도 행으로 표에 보여줍니다 — 첫 번째 값만 남기고 나머지를 누락시키는 실수를 방지합니다.

03

3. 빌드와 파싱을 오가며 확인하기

전체 URL을 붙여넣어도 파싱 탭이 `?` 이후(그리고 `#` 이전)만 정확히 잘라내 쿼리 스트링으로 인식합니다. 반대로 빌드 탭에서 만든 결과를 파싱 탭에 다시 붙여넣으면 인코딩이 의도대로 됐는지, 값이 원래대로 복원되는지 왕복 검증(round-trip)할 수 있습니다.

자주 묻는 질문

한글이나 이모지가 포함된 값도 정상적으로 인코딩되나요?
네. URLSearchParams는 UTF-8 기준으로 모든 비-ASCII 문자를 표준 퍼센트 인코딩으로 변환합니다. 한글, 이모지, 공백 등 어떤 값을 넣어도 안전하게 인코딩됩니다.
빈 값이나 빈 키는 어떻게 처리되나요?
키가 비어 있는 행은 결과에 포함되지 않습니다. 값이 비어 있어도 키만 있으면 `key=`형태로 포함됩니다.
기본 URL을 입력하지 않으면 결과가 어떻게 나오나요?
기본 URL 없이 파라미터만 있으면 `?key=value&...` 형태의 쿼리 스트링만 표시됩니다. 기본 URL을 입력하면 `기본URL?key=value&...` 형태의 전체 URL이 만들어집니다.
입력한 데이터가 서버로 전송되나요?
아니요. 빌드와 파싱 모두 브라우저 자바스크립트 안에서만 처리되며 서버로 전송되지 않습니다.