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

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!

See also

• Other URL-related interfaces: URL, URLUtils.
• Google Developers: Easy URL manipulation with URLSearchParams