summaryrefslogtreecommitdiff
path: root/doc/api/url.md
diff options
context:
space:
mode:
Diffstat (limited to 'doc/api/url.md')
-rw-r--r--doc/api/url.md34
1 files changed, 30 insertions, 4 deletions
diff --git a/doc/api/url.md b/doc/api/url.md
index 16070c3e06..9cc477236e 100644
--- a/doc/api/url.md
+++ b/doc/api/url.md
@@ -859,11 +859,22 @@ new URLSearchParams([
Append a new name-value pair to the query string.
-#### `urlSearchParams.delete(name)`
+#### `urlSearchParams.delete(name[, value])`
+
+<!-- YAML
+changes:
+ - version: REPLACEME
+ pr-url: https://github.com/nodejs/node/pull/47885
+ description: Add support for optional `value` argument.
+-->
* `name` {string}
+* `value` {string}
+
+If `value` is provided, removes all name-value pairs
+where name is `name` and value is `value`..
-Remove all name-value pairs whose name is `name`.
+If `value` is not provided, removes all name-value pairs whose name is `name`.
#### `urlSearchParams.entries()`
@@ -918,12 +929,27 @@ are no such pairs, `null` is returned.
Returns the values of all name-value pairs whose name is `name`. If there are
no such pairs, an empty array is returned.
-#### `urlSearchParams.has(name)`
+#### `urlSearchParams.has(name[, value])`
+
+<!-- YAML
+changes:
+ - version: REPLACEME
+ pr-url: https://github.com/nodejs/node/pull/47885
+ description: Add support for optional `value` argument.
+-->
* `name` {string}
+* `value` {string}
* Returns: {boolean}
-Returns `true` if there is at least one name-value pair whose name is `name`.
+Checks if the `URLSearchParams` object contains key-value pair(s) based on
+`name` and an optional `value` argument.
+
+If `value` is provided, returns `true` when name-value pair with
+same `name` and `value` exists.
+
+If `value` is not provided, returns `true` if there is at least one name-value
+pair whose name is `name`.
#### `urlSearchParams.keys()`