URLSearchParams

Das URLSearchParams Interface definiert Hilfsmethoden um mit dem Query-String einer URL zu arbeiten.

Ein Objekt, welches URLSearchParams implementiert, kann auch direkt in einem for...of Konstrukt genutzt werden, anstatt entries() (en-US): for (var p of mySearchParams) ist äquivalent zu for (var p of mySearchParams.entries()).

Konstruktor

URLSearchParams() (en-US): Konstruktor erzeugt ein URLSearchParams Objekt von einem Query-String.

Eigenschaften

Dieses Interface erbt keine Eigenschaften.

Methoden

Dieses Interface erbt keine Methoden.

URLSearchParams.append() (en-US): Hängt ein Schlüssel/Wert - Paar an den Query-String.
URLSearchParams.delete() (en-US): Löscht einen Schlüssel und den zugehörigen Wert aus dem Query-String.
URLSearchParams.entries() (en-US): Gibt einen Iterator über alle Schlüssel/Wert - Paare im Query-String.
URLSearchParams.get() (en-US): Gibt den ersten Wert, der im Query-String mit einem Schlüssel assoziiert ist.
URLSearchParams.getAll() (en-US): Gibt alle Werte, die im Query-String mit einem Schlüssel assoziiert sind.
URLSearchParams.has() (en-US): Gibt einen Boolean, der anzeigt ob ein Schlüssel im Query-String vorkommt.
URLSearchParams.keys() (en-US): Gibt einen Iterator über alle Schlüssel im Query-String.
URLSearchParams.set() (en-US): Setzt den Wert eines Schlüssels. Wenn der Schlüssel mehrfach im Query-String vorkommt, werden die Restlichen gelöscht.
URLSearchParams.sort() (en-US): Sortiert alle Schlüssel/Wert Paare, nach dem Schlüssel.; Sorts all key/value pairs, if any, by their keys.
URLSearchParams.toString() (en-US): Gibt den Query-String, in der passenden Form um in einer URL einzusetzen.
URLSearchParams.values() (en-US): Gibt einen Iterator über alle Werte im Query-String.

Beispiel

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

//Iteriert über die Suchparameter
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"

Spezifikationen

Spezifikation	Status	Kommentar
URL Die Definition von 'URLSearchParams' in dieser Spezifikation.	Lebender Standard	Initial definition.

Browser Kompatibilität

Wir konvertieren die Kompatibilitätsdaten in ein maschinenlesbares JSON Format. Diese Kompatibilitätstabelle liegt noch im alten Format vor, denn die darin enthaltenen Daten wurden noch nicht konvertiert. Finde heraus wie du helfen kannst! (en-US)

Desktop
Mobile

Feature	Chrome	Firefox (Gecko)	Internet Explorer	Opera	Safari
Basic support	49	29.0 (29.0)	Nicht unterstützt	36	10.1
`entries()`, `keys()`, `values()`, and support of `for...of`	49	44.0 (44.0)	Nicht unterstützt	36	?
`USVString` for constructor `init` object	(Ja)	53.0 (53.0)	Nicht unterstützt	(Ja)	?
Record for constructor `init` object	Nicht unterstützt	54.0 (54.0)	Nicht unterstützt	?	?

Feature	Android Webview	Chrome for Android	Firefox Mobile (Gecko)	IE Mobile	Opera Mobile	Safari Mobile
Basic support	49	49	29.0 (29.0)	Nicht unterstützt	?	Nicht unterstützt
`entries()`, `keys()`, `values()`, and support of `for...of`	49	49	44.0 (44.0)	Nicht unterstützt	?	Nicht unterstützt
`USVString` for constructor `init` object	(Ja)	(Ja)	53.0 (53.0)	Nicht unterstützt	?	?
Record for constructor `init` object	?	?	54.0 (54.0)	Nicht unterstützt	?	?

Verweise

Andere URL-bezogene Interfaces: URL, URLUtils.
Google Developers: Easy URL manipulation with URLSearchParams