diff options
Diffstat (limited to 'doc/api/url.md')
-rw-r--r-- | doc/api/url.md | 34 |
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()` |