--- title: URLSearchParams.forEach() slug: Web/API/URLSearchParams/forEach translation_of: Web/API/URLSearchParams/forEach ---
{{APIRef("URL API")}}

   URLSearchParams的实例对象上的方法forEach允许通过回调函数来遍历URLSearchParams实例对象上的键值对

{{availableinworkers}}

语法

searchParams.forEach(callback(value,key,searchParams));

参数

回调函数
    该回调函数可以接收到3个参数value,key,searchParams，我们可以在回调函数中对接收到的参数进行处理。而三个参数的含义如下：
    1.  value
     当前遍历到的键值
    2.  key
     当前遍历到的键名
    3.  searchParams
     当前调用forEach方法的实例对象

返回值

    空

例子

// 创建URLSearchParams对象的实例对象，用于测试
var searchParams = new URLSearchParams("key1=value1&key2=value2");

let returnValue = searchParams.forEach(function(value, key,searchParams) {
     // 打印值
     console.log(value, key,searchParams);
});

// 输出返回值
console.log(returnValue)

结果是:

value1 key1 当前调用forEach方法的实例对象(也就是searchParams)
value2 key2 当前调用forEach方法的实例对象(也就是searchParams)
undefined  // 即没有返回值

Specifications

Specification Status Comment
{{SpecName('URL', '#interface-urlsearchparams', "forEach() (see \"iterable\")")}} {{Spec2('URL')}} Initial definition.

Browser compatibility

{{Compat("api.URLSearchParams.forEach")}}

See also