url: implement URLSearchParams size getter

Refs: whatwg/url#734 PR-URL: #46308 Reviewed-By: Antoine du Hamel <[email protected]> Reviewed-By: Luigi Pinca <[email protected]> Reviewed-By: Yagiz Nizipli <[email protected]> Reviewed-By: Daijiro Wachi <[email protected]> Reviewed-By: Anna Henningsen <[email protected]> Reviewed-By: Tobias Nießen <[email protected]> Reviewed-By: Darshan Sen <[email protected]> Reviewed-By: Minwoo Jung <[email protected]>
nodejs · Feb 25, 2023 · c1178c5 · c1178c5
1 parent 68b4092
commit c1178c5
Show file tree

Hide file tree

Showing 3 changed files with 23 additions and 0 deletions.
diff --git a/doc/api/url.md b/doc/api/url.md
@@ -940,6 +940,14 @@ console.log(params.toString());
 // Prints foo=def&abc=def&xyz=opq
 ```
 
+#### `urlSearchParams.size`
+
+<!-- YAML
+added: REPLACEME
+-->
+
+The total number of parameter entries.
+
 #### `urlSearchParams.sort()`
 
 <!-- YAML

diff --git a/lib/internal/url.js b/lib/internal/url.js
@@ -268,6 +268,12 @@ class URLSearchParams {
     return `${this.constructor.name} {}`;
   }
 
+  get size() {
+    if (!isURLSearchParams(this))
+      throw new ERR_INVALID_THIS('URLSearchParams');
+    return this[searchParams].length / 2;
+  }
+
   append(name, value) {
     if (!isURLSearchParams(this))
       throw new ERR_INVALID_THIS('URLSearchParams');
@@ -511,6 +517,7 @@ ObjectDefineProperties(URLSearchParams.prototype, {
   getAll: kEnumerableProperty,
   has: kEnumerableProperty,
   set: kEnumerableProperty,
+  size: kEnumerableProperty,
   sort: kEnumerableProperty,
   entries: kEnumerableProperty,
   forEach: kEnumerableProperty,

diff --git a/test/parallel/test-whatwg-url-properties.js b/test/parallel/test-whatwg-url-properties.js
@@ -65,6 +65,14 @@ const { URL, URLSearchParams, format } = require('url');
   testMethod(URLSearchParams.prototype, name, methodName);
 });
 
+{
+  const params = new URLSearchParams();
+  params.append('a', 'b');
+  params.append('a', 'c');
+  params.append('b', 'c');
+  assert.strictEqual(params.size, 3);
+}
+
 function stringifyName(name) {
   if (typeof name === 'symbol') {
     const { description } = name;