URL 인코딩, 양방향.

Component vs Full URL — 범위를 올바로 고르기

Component 는 encodeURIComponent 로 / ? # & = 같은 예약문자까지 변환하며, 쿼리 값 하나나 경로 한 조각에 씁니다. Full URL 은 구분자를 남기지만 아직 퍼센트 인코딩되지 않은 주소 텍스트에만 씁니다. %20 을 다시 처리하면 %2520 이 됩니다. 새 쿼리는 인코딩 전 값을 URL.searchParams.set 에 전달하세요.

'+ 는 공백' 함정

URLSearchParams("q=a+b").get("q") 는 a b, decodeURIComponent("a+b") 는 a+b 입니다. 쿼리에 문자 그대로의 + 를 남기려면 %2B 가 필요합니다. '+ 를 공백으로'는 쿼리·폼 값만 Component 모드로 수동 변환할 때 켜며, Full URL 모드에서는 모든 + 를 그대로 둡니다.

한글·이모지도 정확히 왕복

한글·일본어·이모지는 UTF-8 퍼센트 시퀀스로 인코딩되고 그대로 복원됩니다. 깨진 시퀀스(잘린 % 등)는 깨진 글자 대신 오류로 표시합니다.

자주 묻는 질문