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
- Andere URL-bezogene Interfaces:
URL
,URLUtils
. - Google Developers: Easy URL manipulation with URLSearchParams