URLSearchParams: append() Methode
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit April 2018 browserübergreifend verfügbar.
Hinweis: Diese Funktion ist in Web Workers verfügbar.
Die append()-Methode des URLSearchParams
Interfaces fügt ein bestimmtes Schlüssel/Wert-Paar als neuen Suchparameter hinzu.
Wie im folgenden Beispiel gezeigt, erscheint derselbe Schlüssel in der Parameterzeichenkette mehrfach, wenn er mehrmals hinzugefügt wird, und zwar für jeden Wert.
Syntax
js
append(name, value)
Parameter
Rückgabewert
Keiner (undefined).
Beispiele
Hinzufügen desselben Parameters mehrfach
js
const url = new URL("https://example.com?foo=1&bar=2");
const params = new URLSearchParams(url.search);
// Add a second foo parameter.
params.append("foo", 4);
// Query string is now: 'foo=1&bar=2&foo=4'
Spezifikationen
| Spezifikation |
|---|
| URL # dom-urlsearchparams-append |