같은 키가 반복되는 주소부터 만듭니다
쿼리 문자열은 같은 이름을 여러 번 담을 수 있습니다. 연습용으로 new URLSearchParams("tag=book&tag=map&page=2")를 만듭니다. 이 객체에서 tag는 하나의 문자열 값만 존재하는 사전처럼 동작하지 않습니다.
실제 서비스가 반복 키를 어떤 의미로 해석하는지는 서버의 규칙을 확인해야 합니다. 이 글의 예시는 표준 URLSearchParams 객체의 문자열 처리 결과이며 특정 검색 서비스의 필터 동작을 보장하지 않습니다.
get과 getAll의 출력이 다릅니다
p.get("tag")는 첫 번째 값인 "book"을 돌려줍니다. p.getAll("tag")는 ["book", "map"]을 돌려줍니다. get만 출력해 보고 map이 주소에서 사라졌다고 판단하면 읽는 방식과 저장된 내용을 혼동한 것입니다.
존재하지 않는 이름도 구별해 보세요. p.get("missing")은 null, p.getAll("missing")은 빈 배열입니다. 화면에 값이 보이지 않을 때는 빈 문자열 값인지 키 자체가 없는지도 확인할 항목입니다.
append는 하나 더 추가합니다
처음 만든 객체에 p.append("tag", "art")를 실행하면 기존 두 값 뒤에 art가 추가됩니다. p.getAll("tag")로 확인하면 ["book", "map", "art"]입니다.
같은 버튼을 누를 때마다 append하는 코드라면 의도하지 않은 중복이 쌓일 수 있습니다. 값 추가가 목적이었는지, 기존 선택을 교체하려던 것인지 먼저 정한 뒤 변경 전후 문자열을 나란히 기록하세요.
| 호출 | 예시 결과 | 의미 |
|---|---|---|
| get("tag") | book | 첫 값 읽기 |
| getAll("tag") | [book, map] | 같은 키 전체 읽기 |
| append("tag", "art") | [book, map, art] | 값 추가 |
| set("tag", "photo") | [photo] | 기존 같은 키 값 교체 |
set은 같은 이름의 여러 값을 하나로 바꿉니다
같은 객체에 p.set("tag", "photo")를 실행하면 tag의 값은 photo 하나가 됩니다. 기존에 같은 이름으로 있던 다른 값은 제거됩니다. page=2처럼 다른 이름의 값은 이 호출로 바뀌지 않습니다.
따라서 여러 선택을 유지하려는 필터 코드에서 set을 반복 호출하면 마지막 지정 값만 남는 결과를 볼 수 있습니다. 이는 전송 중 손실이라고 단정하기 전에 객체를 수정하는 코드를 확인할 단서입니다.
실험 결과와 서버 응답을 별도로 확인합니다
연습 코드는 const p = new URLSearchParams("tag=book&tag=map&page=2"); console.log(p.getAll("tag")); p.append("tag", "art"); console.log(p.toString()); p.set("tag", "photo"); console.log(p.toString()); 입니다. 네트워크 요청 없이 브라우저 콘솔이나 지원되는 Node 환경에서 실행할 수 있습니다.
최종 문자열은 tag=photo&page=2입니다. 객체가 만든 문자열이 맞더라도 서버가 반복 키를 지원하는지는 별도 검증입니다. 실제 계정이나 비밀 토큰이 든 주소 대신 예시 값을 사용해 읽기·추가·교체 단계를 나누세요.
입력은 그대로 두고 복사본으로 비교합니다
다른 코드가 함께 쓰는 객체를 직접 수정하면 실험 후의 값이 다음 처리에 영향을 줄 수 있습니다. 비교만 하려면 const copy = new URLSearchParams(p);처럼 별도의 객체를 만들어 append와 set을 실행합니다.
원본과 복사본의 toString()을 나란히 출력하면 바꾼 쪽만 달라졌는지 확인할 수 있습니다. 주소 전체를 직접 문자열로 이어 붙이는 실험과 섞지 말고, 먼저 반복 키의 변화만 검증한 뒤 인코딩이나 실제 요청 문제를 따로 살펴보세요.
직접 적용해 보기: 반복 쿼리 읽기
가상의 태그 필터가 tag=book&tag=map&page=2를 사용하며 교체 후 값이 하나만 남습니다.
- 01
get과 getAll의 출력을 함께 기록합니다.
- 02
append 뒤 getAll로 세 값이 남는지 확인합니다.
- 03
set 뒤 tag는 한 값, page는 기존 값으로 남는지 비교합니다.
남길 결과물
읽기 [book,map] → 추가 [book,map,art] → 교체 [photo], page=2 유지라는 실행 기록입니다.
여기서 자주 놓치는 점
get이 첫 값만 돌려주는 결과를 나머지 값이 삭제됐다는 뜻으로 해석하지 않습니다.
편집팀이 구성한 설명용 예시입니다. 실제 이용 후기나 측정 결과가 아닙니다.
