跳到主要内容

实例方法

2023年11月06日
柏拉文
越努力，越幸运

一、searchParams.append()​

searchParams.append() 插入一个指定的键/值对作为新的搜索参数。

语法

const urlString = 'id=44444&timestamp=43432432432'
const urlParams = new URLSearchParams(urlString);
console.log(urlParams);
urlParams.append('type','get');
console.log(urlParams);

二、searchParams.delete()​

searchParams.delete() 从搜索参数列表里删除指定的搜索参数及其对应的值。

语法

const urlString = 'id=44444&timestamp=43432432432'
const urlParams = new URLSearchParams(urlString);
console.log(urlParams);
urlParams.delete('id')
console.log(urlParams);

三、searchParams.entries()​

searchParams.entries() 返回一个iterator可以遍历所有键/值对的对象。

语法

const urlString = 'id=44444&timestamp=43432432432'
const urlParams = new URLSearchParams(urlString);
console.log(urlParams.entries());

for(let item of urlParams.entries()){
console.log(item); //  ['id', '44444']     ['timestamp', '43432432432']
}

四、searchParams.get()​

searchParams.get() 获取指定搜索参数的第一个值。

语法

const urlString = 'id=44444&timestamp=43432432432'
const urlParams = new URLSearchParams(urlString);
console.log(urlParams.get('id')); // 44444

五、searchParams.getAll()​

searchParams.getAll() 获取指定搜索参数的所有值，返回是一个数组。

语法

const urlString = 'id=44444&timestamp=43432432432'
const urlParams = new URLSearchParams(urlString);
console.log(urlParams.getAll('id')); // ['44444']

六、searchParams.has()​

searchParams.has() 返回 Boolean 判断是否存在此搜索参数。

语法

const urlString = 'id=44444&timestamp=43432432432'
const urlParams = new URLSearchParams(urlString);
console.log(urlParams.has('id')); // true

七、searchParams.keys()​

searchParams.keys() 返回 iterator 此对象包含了键/值对的所有键名。

语法

const urlString = 'id=44444&timestamp=43432432432'
const urlParams = new URLSearchParams(urlString);
console.log(urlParams.keys()); // Iterator {}

for(let key of urlParams.keys()){
console.log(key); // id timestamp
}

八、searchParams.set()​

searchParams.set() 设置一个搜索参数的新值，假如原来有多个值将删除其他所有的值。

语法

const urlString = 'id=44444&timestamp=43432432432'
const urlParams = new URLSearchParams(urlString);
urlParams.set('type','get'); 
console.log(urlParams); // URLSearchParams {}

九、searchParams.sort()​

searchParams.sort() 按键名排序。

语法

const urlString = 'id=44444&timestamp=43432432432'
const urlParams = new URLSearchParams(urlString);
urlParams.sort(); 
console.log(urlParams); // URLSearchParams {}

十、searchParams.toString()​

searchParams.toString() 返回搜索参数组成的字符串，可直接使用在URL上。

语法

const urlString = 'id=44444&timestamp=43432432432'
const urlParams = new URLSearchParams(urlString);
console.log(urlParams.toString()); // id=44444&timestamp=43432432432

十一、searchParams.values()​

searchParams.values() 返回 iterator 此对象包含了键/值对的所有值。

语法

const urlString = 'id=44444&timestamp=43432432432'
const urlParams = new URLSearchParams(urlString);
console.log(urlParams.values()); // Iterator {}

for(let value of urlParams.values()){
console.log(value); // 44444  43432432432
}