URLSearchParams: append() メソッド
append() は URLSearchParams インターフェイスのメソッドで、指定されたキー/値のペアを新しい検索パラメーターとして追加します。
下にある例に示すように、同じキーが複数回追加された場合、各値がパラメーター文字列に複数回現れます。
注: この機能は Web Worker 内で利用可能です
構文
js
append(name, value)
引数
- name
-
追加するパラメーターの名前。
- value
-
追加するパラメーターの値。
返値
なし (undefined)。
例
js
let url = new URL("https://example.com?foo=1&bar=2");
let params = new URLSearchParams(url.search);
// 2番目の foo パラメーターを追加します。
params.append("foo", 4);
// クエリー文字列はこうなる: 'foo=1&bar=2&foo=4'
仕様書
| Specification |
|---|
| URL Standard # dom-urlsearchparams-append |
ブラウザーの互換性
BCD tables only load in the browser