URLSearchParams: values() method

The values() method of the URLsearchParams interface returns an iterator allowing iteration through all values contained in this object. The values are string objects.

Note: This feature is available in Web Workers

Syntax

js

values()

Parameters

None.

Return value

Returns an iterator.

Examples

The following example passes a URL search string to the URLSearchParams constructor, then uses the iterator returned by values() to print the values to the console.

js

const searchParams = new URLSearchParams("key1=value1&key2=value2");

for (const value of searchParams.values()) {
  console.log(value);
}

The result is:

value1
value2

This example does much the same as above, but first casts the iterator into an array.

js

const searchParams = new URLSearchParams("key1=value1&key2=value2");

console.log(Array.from(searchParams.values()));

The result is:

['value1', 'value2']

Specifications

Specification
URL Standard
# dom-urlsearchparams-urlsearchparams

Browser compatibility

BCD tables only load in the browser

See also

  • The URL interface.