URLSearchParams: size プロパティ
Baseline
広く利用可能
この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。2023年9月以降、すべてのブラウザーで利用可能です。
メモ: この機能はウェブワーカー内で利用可能です。
URLSearchParams.size は URLSearchParams インターフェイスの読み取り専用のプロパティで、検索引数項目の総数を示します。
値
数値で、URLSearchParams オブジェクト内の検索引数項目の総数を示します。
例
検索引数項目数の取得
検索引数項目の総数を取得するには、次のようにします。
js
const searchParams = new URLSearchParams("c=4&a=2&b=3&a=1");
searchParams.size; // 4
a 引数が 2 回与えられますが、 size は 3 ではなく、与えられたすべての項目の数 (4) を返すことに注意してください。固有のキーの数を取得するには、Set などを使用してください。
js
[...new Set(searchParams.keys())].length; // 3
検索引数が存在するかどうかをチェック
size` プロパティは、検索引数があるかどうかをチェックするのに便利です。
js
const url = new URL("https://example.com?foo=1&bar=2");
if (url.searchParams.size) {
console.log("URL has search parameters!");
}
仕様書
| 仕様書 |
|---|
| URL # dom-urlsearchparams-size |