URLSearchParams: forEach() method
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since April 2018.
Note: This feature is available in Web Workers.
The forEach() method of the
URLSearchParams interface allows iteration through all values contained
in this object via a callback function.
Syntax
forEach(callback)
forEach(callback, thisArg)
Parameters
callback-
Function to execute on each element, which is passed the following arguments:
value-
The value of the current entry being processed in the
URLSearchParamsobject. key-
The key of the current entry being processed in the
URLSearchParamsobject. searchParams-
The
URLSearchParamsobject theforEach()was called upon.
thisArgOptional-
Value to use as
thiswhen executingcallback.
Return value
None (undefined).
Examples
// Create a test URLSearchParams object
const searchParams = new URLSearchParams("key1=value1&key2=value2");
// Log the values
searchParams.forEach((value, key) => {
console.log(value, key);
});
The result is:
value1 key1 value2 key2
Specifications
| Specification |
|---|
| URL # dom-urlsearchparams-urlsearchparams |
Browser compatibility
| desktop | mobile | server | |||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
forEach
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Legend
Tip: you can click/tap on a cell for more information.
- Full support
- Full support
- Has more compatibility info.
See also
- The
URLinterface.