url: implement URLSearchParams size getter

jasnell · danielleadams · commit 1ece4a72b78a · 2023-04-05T12:52:27.000-04:00
Refs: whatwg/url#734 PR-URL: #46308 Reviewed-By: Antoine du Hamel <duhamelantoine1995@gmail.com> Reviewed-By: Luigi Pinca <luigipinca@gmail.com> Reviewed-By: Yagiz Nizipli <yagiz@nizipli.com> Reviewed-By: Daijiro Wachi <daijiro.wachi@gmail.com> Reviewed-By: Anna Henningsen <anna@addaleax.net> Reviewed-By: Tobias Nießen <tniessen@tnie.de> Reviewed-By: Darshan Sen <raisinten@gmail.com> Reviewed-By: Minwoo Jung <nodecorelab@gmail.com>
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
@@ -290,6 +290,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');
@@ -525,6 +531,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
@@ -54,6 +54,14 @@ const { URL, URLSearchParams } = 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;
