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)

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