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.

브라우저 호환성

We're converting our compatibility data into a machine-readable JSON format. This compatibility table still uses the old format, because we haven't yet converted the data it contains. Find out how you can help!

기능 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,