Node.js new URLSearchParams(iterable)用法及代碼示例

new URLSearchParams(iterable)

參數

• iterable <Iterable> 元素為鍵值對的可迭代對象

以類似於 Map 的構造函數的方式使用可迭代映射實例化一個新的 URLSearchParams 對象。 iterable 可以是 Array 或任何可迭代對象。這意味著 iterable 可以是另一個 URLSearchParams ，在這種情況下，構造函數將簡單地創建提供的 URLSearchParams 的克隆。 iterable 的元素是鍵值對，它們本身可以是任何可迭代的對象。

允許重複鍵。

let params;

// Using an array
params = new URLSearchParams([
  ['user', 'abc'],
  ['query', 'first'],
  ['query', 'second'],
]);
console.log(params.toString());
// Prints 'user=abc&query=first&query=second'

// Using a Map object
const map = new Map();
map.set('user', 'abc');
map.set('query', 'xyz');
params = new URLSearchParams(map);
console.log(params.toString());
// Prints 'user=abc&query=xyz'

// Using a generator function
function* getQueryPairs() {
  yield ['user', 'abc'];
  yield ['query', 'first'];
  yield ['query', 'second'];
}
params = new URLSearchParams(getQueryPairs());
console.log(params.toString());
// Prints 'user=abc&query=first&query=second'

// Each key-value pair must have exactly two elements
new URLSearchParams([
  ['user', 'abc', 'error'],
]);
// Throws TypeError [ERR_INVALID_TUPLE]:
//        Each query pair must be an iterable [name, value] tuple