URLSearchParams:size 属性

Baseline 2023
新推出

自 2023 年 9 月起,此功能可在最新的设备和浏览器版本上使用。此功能可能无法在较旧的设备或浏览器上使用。

注意:此功能在 Web Workers 中可用。

URLSearchParams 接口的 size 只读属性表示搜索参数条目的总数。

一个数字,表示 URLSearchParams 对象中搜索参数条目的总数。

示例

获取搜索参数条目的数量

你可以像这样获取搜索参数条目的总数

js
const searchParams = new URLSearchParams("c=4&a=2&b=3&a=1");
searchParams.size; // 4

请注意,参数 a 被提供了两次,但 size 返回的是所有给定条目的数量(4),而不是 3。要获取唯一键的数量,你可以使用 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

浏览器兼容性

另见