URLSearchParams

URLSearchParams інтерфейс визначає корисні методи для роботи з довгими текстовими URL.

Об'єктна реалізація URLSearchParams може використовуватись напряму в for...of структурі, замість entries(): for (var p of mySearchParams) що еквівалентно до for (var p of mySearchParams.entries()).

Конструктор

URLSearchParams(): Конструктор вертає URLSearchParams об'єкт.

Properties

This interface doesn't inherit any property.

Методи

Інтерфейс на наслідує ніяких методів

URLSearchParams.append(): Appends a specified key/value pair as a new search parameter.
URLSearchParams.delete(): Deletes the given search parameter, and its associated value, from the list of all search parameters.
URLSearchParams.entries(): Returns an iterator allowing to go through all key/value pairs contained in this object.
URLSearchParams.get(): Returns the first value associated to the given search parameter.
URLSearchParams.getAll(): Returns all the values association with a given search parameter.
URLSearchParams.has(): Returns a Boolean indicating if such a search parameter exists.
URLSearchParams.keys(): Returns an iterator allowing to go through all keys of the key/value pairs contained in this object.
URLSearchParams.set(): Sets the value associated to a given search parameter to the given value. If there were several values, delete the others.
URLSearchParams.toString(): Returns a string containg a query string suitable for use in a URL.
URLSearchParams.values(): Returns an iterator allowing to go through all values of the key/value pairs contained in this object.

Example

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"

Specifications

Specification	Status	Comment
URL The definition of 'URLSearchParams' in that specification.	Living Standard	Initial definition.

Browser compatibility

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!

Desktop
Mobile

Feature	Chrome	Firefox (Gecko)	Internet Explorer	Opera	Safari
Basic support	49	29.0 (29.0)	No support	36	No support
`entries()`, `keys()`, `values()`, and support of `for...of`	49	44.0 (44.0)	No support	36	No support

Feature	Android	Android Webview	Firefox Mobile (Gecko)	IE Mobile	Opera Mobile	Safari Mobile	Chrome for Android
Basic support	No support	49	29.0 (29.0)	No support	?	No support	49
`entries()`, `keys()`, `values()`, and support of `for...of`	No support	49	44.0 (44.0)	No support	?	No support	49