URLSearchParams 은 URL의 Query 문자열을 다루는 메소드의 정의 입니다.

URLSearchParams 오브젝트는 for...of 구조에 바로 사용할수 있으며, entries() 대신 for (var p of mySearchParams)으로 사용이 가능합니다. 이는 for (var p of mySearchParams.entries())과 동등합니다.

생성자

URLSearchParams()
이 생성자는  URLSearchParams 오브젝트를 반환합니다.

프로퍼티

이 인터페이스는 프로퍼티를 상속하지 않습니다.

메소드

이 인터페이스는 메소드를 상속하지 않습니다.

Key는 키, Value는 값으로 번역되었습니다. 예시로 mozilla.org/?email=true 같은경우 email이 key이고 true가 값입니다.

URLSearchParams.append()
특정 키/값을 새로운 검색 매개변수로 추가합니다.
URLSearchParams.delete()
특정한 매개변수를 찾아 이를 지웁니다. 키와 값 모두를 지우게 됩니다.
URLSearchParams.entries()
그 오브젝트에 포함된 모든 키와 값을 접근하게 해주는  iterator 을 반환합니다.
URLSearchParams.get()
검색한 매개변수의 첫번째 값을 반환합니다.
URLSearchParams.getAll()
검색한 매개변수의 모든 값을 반환합니다.
URLSearchParams.has()
검색한 매개변수의 존재 여부를 Boolean 형태로 반환합니다.
URLSearchParams.keys()
오브젝트에 포함된 모든 키에 접근하게 해주는 iterator 을 반환합니다.
URLSearchParams.set()
검색된 매개 변수의 값을 주어진 값으로 설정합니다. 이미 여럿의 값들이 존재했을 경우 나머지 값을 지웁니다.
URLSearchParams.sort()
키/값에 따라 모든 매개변수를 정렬합니다. 같을경우 키에 따라 정렬합니다. 
URLSearchParams.toString()
Query 문자열을 포함한 문자열을 반환합니다. 이는 URL에 쓰기 적합합니다.
URLSearchParams.values()
오브젝트에 포함된 모든 값에 접근하게 해주는  iterator 을 반환합니다.

예제

var paramsString = "q=URLUtils.searchParams&topic=api";
var searchParams = new URLSearchParams(paramsString);

//Iterate the search parameters.
for (let p of searchParams) {
  console.log(p);
}

searchParams.has("topic") === true; // true
searchParams.get("topic") === "api"; // true
searchParams.getAll("topic"); // ["api"]
searchParams.get("foo") === null; // true
searchParams.append("topic", "webdev");
searchParams.toString(); // "q=URLUtils.searchParams&topic=api&topic=webdev"
searchParams.set("topic", "More webdev");
searchParams.toString(); // "q=URLUtils.searchParams&topic=More+webdev"
searchParams.delete("topic");
searchParams.toString(); // "q=URLUtils.searchParams"

명세

명세 상태 비고
URL
The definition of 'URLSearchParams' in that specification.
Living Standard Initial definition.

브라우저 호환성

기능 Chrome Firefox (Gecko) Internet Explorer Opera Safari
기본 지원 49 29.0 (29.0)[1] No support 36 10.1
entries(), keys(), values(), 과 for...of 49 44.0 (44.0) No support 36 ?
 생성자 init 오브젝트를 위한 USVString 61 53.0 (53.0) No support 48 ?
생성자init 오브젝트를 위한 Record 61 54.0 (54.0) No support 48 ?
sort() 61 ? No support 48 ?
기능 Android Webview Chrome for Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
기본 지원 49 49 29.0 (29.0)[1] No support 36 No support
entries(), keys(), values(), 과 for...of 49 49 44.0 (44.0) No support 36 No support
 생성자 init 오브젝트를 위한 USVString 61 61 53.0 (53.0) No support 48 ?
생성자init 오브젝트를 위한 Record 61 61 54.0 (54.0) No support 48 ?
sort() 61 61 ? No support 48 No support

[1] Firefox는 URL에 작은 따옴표가 포함되 있으면 생기는 버그(bug 1386683) 가 있습니다. 이 버그는 Firefox 57 버전에서 고쳐졌습니다.

같이 보기

문서 태그 및 공헌자

 이 페이지의 공헌자: dnjstlr555
 최종 변경: dnjstlr555,