URLSearchParams.append()
URLSearchParams
インターフェイスの append()
メソッドは、指定されたキー/値のペアを新しい検索パラメーターとして追加します。
下にある例に示すように、同じキーが複数回追加された場合、各値がパラメーター文字列に複数回現れます。
注: この機能は Web Worker 内で利用可能です
構文
URLSearchParams.append(name, value)
パラメーター
- name
-
追加するパラメーターの名前。
- value
-
追加するパラメーターの値。
戻り値
無効。
例
let url = new URL('https://example.com?foo=1&bar=2');
let params = new URLSearchParams(url.search.slice(1));
// 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
関連項目
- その他の URL 関連インターフェイス:
URL
、HTMLHyperlinkElementUtils
。 - Google Developers: URLSearchParams を使用した簡単な URL 操作(英語)