harmony 鸿蒙@ohos.url (URL字符串解析)

  • 2025-06-12
  • 浏览 (7)

@ohos.url (URL字符串解析)

URL代表着是统一资源定位符，本模块提供了常用的工具函数，实现了解析URL字符串和构造URL对象等功能。

说明：

本模块首批接口从API version 7开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。

导入模块

import { url } from '@kit.ArkTS';

URLParams9+

URLParams接口定义了一些处理URL查询字符串的实用方法。

constructor9+

constructor(init?: string[][]|Record<string, string>|string|URLParams)

URLParams的构造函数。

原子化服务API：从API version 11开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

参数：

参数名 类型 必填 说明
init string[][] |Record<string, string> |string |URLParams 否 入参对象。
- string[][]：字符串二维数组。
- Record<string, string>：对象列表。
- string：字符串。
- URLParams：对象。
- 默认值：null。

错误码：

以下错误码的详细介绍请参见通用错误码。

错误码ID 错误信息
401 Parameter error. Possible causes: 1.Incorrect parameter types; 2.Parameter verification failed.

示例：

// 通过string[][]方式构造URLParams对象：
let objectParams = new url.URLParams([ ['user1', 'abc1'], ['query2', 'first2'], ['query3', 'second3'] ]);
// 通过Record<string, string>方式构造URLParams对象：
let objectParams1 = new url.URLParams({"fod" : '1' , "bard" : '2'});
// 通过string方式构造URLParams对象：
let objectParams2 = new url.URLParams('?fod=1&bard=2');
// 通过url对象的search属性构造URLParams对象：
let urlObject = url.URL.parseURL('https://developer.mozilla.org/?fod=1&bard=2');
let objectParams3 = new url.URLParams(urlObject.search);
// 通过url对象的params属性获取URLParams对象：
let urlObject1 = url.URL.parseURL('https://developer.mozilla.org/?fod=1&bard=2');
let objectParams4 = urlObject1.params;

append9+

append(name: string, value: string): void

将新的键值对插入到查询字符串。

原子化服务API：从API version 11开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

参数：

参数名 类型 必填 说明
name string 是 需要插入搜索参数的键名。
value string 是 需要插入搜索参数的值。

错误码：

以下错误码的详细介绍请参见通用错误码。

错误码ID 错误信息
401 Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types; 3. Parameter verification failed.

示例：

let urlObject = url.URL.parseURL('https://developer.exampleUrl/?fod=1&bard=2');
let paramsObject = new url.URLParams(urlObject.search.slice(1));
paramsObject.append('fod', '3');

delete9+

delete(name: string): void

删除指定名称的键值对。

原子化服务API：从API version 11开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

参数：

参数名 类型 必填 说明
name string 是 需要删除的键值名称。

错误码：

以下错误码的详细介绍请参见通用错误码。

错误码ID 错误信息
401 Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types; 3. Parameter verification failed.

示例：

let urlObject = url.URL.parseURL('https://developer.exampleUrl/?fod=1&bard=2');
let paramsObject = new url.URLParams(urlObject.search.slice(1));
paramsObject.delete('fod');

getAll9+

getAll(name: string): string[]

获取指定名称的所有键对应值的集合。

原子化服务API：从API version 11开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

参数：

参数名 类型 必填 说明
name string 是 指定的键值名称。

返回值：

类型 说明
string[] 返回指定名称的所有键对应值的集合。

错误码：

以下错误码的详细介绍请参见通用错误码。

错误码ID 错误信息
401 Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types; 3. Parameter verification failed.

示例：

let urlObject = url.URL.parseURL('https://developer.exampleUrl/?fod=1&bard=2');
let params = new url.URLParams(urlObject.search.slice(1));
params.append('fod', '3'); // Add a second value for the fod parameter.
console.log(params.getAll('fod').toString()) // Output ["1","3"].

entries9+

entries(): IterableIterator<[string, string]>

返回一个ES6的迭代器，迭代器的每一项都是一个JavaScript Array。Array的第一项是name，Array的第二项是value。

原子化服务API：从API version 11开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

返回值：

类型 说明
IterableIterator&lt;[string, string]&gt; 返回一个ES6的迭代器。

示例：

let searchParamsObject = new url.URLParams("keyName1=valueName1&keyName2=valueName2");
let pair:Iterable<Object[]> = searchParamsObject.entries();
let arrayValue = Array.from(pair);
for (let pair of arrayValue) { // Show keyName/valueName pairs
  console.log(pair[0]+ ', '+ pair[1]);
}

forEach9+

forEach(callbackFn: (value: string, key: string, searchParams: URLParams) => void, thisArg?: Object): void

通过回调函数来遍历URLSearchParams实例对象上的键值对。

原子化服务API：从API version 11开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

参数：

参数名 类型 必填 说明
callbackFn function 是 回调函数。
thisArg Object 否 callbackFn被调用时用作this值，默认值是本对象。

表1 callbackFn的参数说明

参数名 类型 必填 说明
value string 是 当前遍历到的键值。
key string 是 当前遍历到的键名。
searchParams URLParams 是 当前调用forEach方法的实例对象。

错误码：

以下错误码的详细介绍请参见通用错误码。

错误码ID 错误信息
401 Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types; 3. Parameter verification failed.

示例：

const myURLObject = url.URL.parseURL('https://developer.exampleUrl/?fod=1&bard=2');
myURLObject.params.forEach((value, name, searchParams) => {
    console.log(name, value, myURLObject.params === searchParams);
});

get9+

get(name: string): string|null

获取指定名称对应的第一个值。

说明：

若查找一个不存在的键值对名称时返回值为undefined。

原子化服务API：从API version 11开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

参数：

参数名 类型 必填 说明
name string 是 指定键值对的名称。

返回值：

类型 说明
string 返回第一个值。
null 如果没找到，返回 null。

错误码：

以下错误码的详细介绍请参见通用错误码。

错误码ID 错误信息
401 Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types; 3. Parameter verification failed.

示例：

let paramsObject = new url.URLParams('name=Jonathan&age=18');
let name = paramsObject.get("name"); // is the string "Jonathan"
let age = paramsObject.get("age"); // is the string "18"
let getObj = paramsObject.get("abc"); // undefined

has9+

has(name: string): boolean

判断一个指定的键名对应的值是否存在。

原子化服务API：从API version 11开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

参数：

参数名 类型 必填 说明
name string 是 要查找的参数的键名。

返回值：

类型 说明
boolean 是否存在相对应的key值，存在返回true，否则返回false。

错误码：

以下错误码的详细介绍请参见通用错误码。

错误码ID 错误信息
401 Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types.

示例：

let urlObject = url.URL.parseURL('https://developer.exampleUrl/?fod=1&bard=2');
let paramsObject = new url.URLParams(urlObject.search.slice(1));
let result = paramsObject.has('bard');

set9+

set(name: string, value: string): void

将与name关联的URLSearchParams对象中的值设置为value。如果存在名称为name的键值对，请将第一个键值对的值设置为value并删除所有其他值。如果不是，则将键值对附加到查询字符串。

原子化服务API：从API version 11开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

参数：

参数名 类型 必填 说明
name string 是 将要设置的参数的键值名。
value string 是 所要设置的参数值。

错误码：

以下错误码的详细介绍请参见通用错误码。

错误码ID 错误信息
401 Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types; 3. Parameter verification failed.

示例：

let urlObject = url.URL.parseURL('https://developer.exampleUrl/?fod=1&bard=2');
let paramsObject = new url.URLParams(urlObject.search.slice(1));
paramsObject.set('baz', '3'); // Add a third parameter.

sort9+

sort(): void

对包含在此对象中的所有键值对进行排序，并返回undefined。排序顺序是根据键的Unicode代码点。该方法使用稳定的排序算法 （即，将保留具有相等键的键值对之间的相对顺序）。

原子化服务API：从API version 11开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

示例：

let searchParamsObject = new url.URLParams("c=3&a=9&b=4&d=2"); // Create a test URLSearchParams object
searchParamsObject.sort(); // Sort the key/value pairs
console.log(searchParamsObject.toString()); // Display the sorted query string // Output a=9&b=4&c=3&d=2

keys9+

keys(): IterableIterator&lt;string&gt;

返回一个所有键值对的name的ES6迭代器。

原子化服务API：从API version 11开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

返回值：

类型 说明
IterableIterator&lt;string&gt; 返回一个所有键值对的name的ES6迭代器。

示例：

let searchParamsObject = new url.URLParams("key1=value1&key2=value2"); // Create a URLSearchParamsObject object for testing
let keys = Array.from(searchParamsObject.keys());
for (let key of keys) { // Output key-value pairs
  console.log(key);
}

values9+

values(): IterableIterator&lt;string&gt;

返回一个所有键值对的value的ES6迭代器。

原子化服务API：从API version 11开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

返回值：

类型 说明
IterableIterator&lt;string&gt; 返回一个所有键值对的value的ES6迭代器。

示例：

let searchParams = new url.URLParams("key1=value1&key2=value2"); // Create a URLSearchParamsObject object for testing
let values = Array.from(searchParams.values());
for (let value of values) {
  console.log(value);
}

[Symbol.iterator]9+

[Symbol.iterator](): IterableIterator&lt;[string, string]&gt;

返回一个ES6的迭代器，迭代器的每一项都是一个JavaScript Array。Array的第一项是name，Array的第二项是value。

原子化服务API：从API version 11开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

返回值：

类型 说明
IterableIterator&lt;[string, string]&gt; 返回一个ES6的迭代器。

示例：

const paramsObject = new url.URLParams('fod=bay&edg=bap');
let iter: Iterable<Object[]> = paramsObject[Symbol.iterator]();
let pairs = Array.from(iter);
for (let pair of pairs) {
  console.log(pair[0] + ', ' + pair[1]);
}

toString9+

toString(): string

返回序列化为字符串的搜索参数，必要时对字符进行百分比编码。

原子化服务API：从API version 11开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

返回值：

类型 说明
string 返回序列化为字符串的搜索参数，必要时对字符进行百分比编码。

示例：

let urlObject = url.URL.parseURL('https://developer.exampleUrl/?fod=1&bard=2');
let params = new url.URLParams(urlObject.search.slice(1));
params.append('fod', '3');
console.log(params.toString()); // Output 'fod=1&bard=2&fod=3'

URL

用于解析、构造、规范、编码对应的URL字符串。

属性

系统能力： SystemCapability.Utils.Lang

名称 类型 可读 可写 说明
hash string 是 是 获取和设置URL的片段部分。原子化服务API：从API version 11开始，该接口支持在原子化服务中使用。
host string 是 是 获取和设置URL的主机部分。原子化服务API：从API version 11开始，该接口支持在原子化服务中使用。
hostname string 是 是 获取和设置URL的主机名部分，不带端口。原子化服务API：从API version 11开始，该接口支持在原子化服务中使用。
href string 是 是 获取和设置序列化的URL。原子化服务API：从API version 11开始，该接口支持在原子化服务中使用。
origin string 是 否 获取URL源的只读序列化。原子化服务API：从API version 11开始，该接口支持在原子化服务中使用。
password string 是 是 获取和设置URL的密码部分。原子化服务API：从API version 11开始，该接口支持在原子化服务中使用。
pathname string 是 是 获取和设置URL的路径部分。原子化服务API：从API version 11开始，该接口支持在原子化服务中使用。
port string 是 是 获取和设置URL的端口部分。原子化服务API：从API version 11开始，该接口支持在原子化服务中使用。
protocol string 是 是 获取和设置URL的协议部分。原子化服务API：从API version 11开始，该接口支持在原子化服务中使用。
search string 是 是 获取和设置URL的序列化查询部分。原子化服务API：从API version 11开始，该接口支持在原子化服务中使用。
searchParams(deprecated) URLSearchParams 是 否 获取URLSearchParams表示URL查询参数的对象。
- 说明： 此属性从API version 7开始支持，从API version 9开始被废弃。建议使用params9+替代。
params9+ URLParams 是 否 获取URLParams表示URL查询参数的对象。原子化服务API：从API version 11开始，该接口支持在原子化服务中使用。
username string 是 是 获取和设置URL的用户名部分。原子化服务API：从API version 11开始，该接口支持在原子化服务中使用。

示例：

let that = url.URL.parseURL('http://username:password@host:8080/directory/file?foo=1&bar=2#fragment');
console.log("hash " + that.hash); // hash #fragment
console.log("host " + that.host); // host host:8080
console.log("hostname " + that.hostname); // hostname host
console.log("href " + that.href); // href http://username:password@host:8080/directory/file?foo=1&bar=2#fragment
console.log("origin " + that.origin); // origin http://host:8080
console.log("password " + that.password); // password password
console.log("pathname " + that.pathname); // pathname /directory/file
console.log("port " + that.port); // port 8080
console.log("protocol " + that.protocol); // protocol http:
console.log("search " + that.search); // search ?foo=1&bar=2
console.log("username " + that.username); // username username
// that.params 返回值为URLParams对象
console.log("params: foo " + that.params.get("foo")); // params: foo 1

constructor(deprecated)

说明：

从API version 7开始支持，从API version 9开始废弃，建议使用parseURL9+替代。

constructor(url: string, base?: string|URL)

URL的构造函数。

系统能力： SystemCapability.Utils.Lang

参数：

参数名 类型 必填 说明
url string 是 一个表示绝对URL或相对URL的字符串。
如果 url 是相对URL，则需要指定 base，用于解析最终的URL。
如果 url 是绝对URL，则给定的 base 将不会生效。
base string |URL 否 入参字符串或者对象，默认值是undefined。
- string：字符串。
- URL：URL对象。

示例：

let mm = 'https://username:password@host:8080';
let a = new url.URL("/", mm); // Output 'https://username:password@host:8080/';
let b = new url.URL(mm); // Output 'https://username:password@host:8080/';
new url.URL('path/path1', b); // Output 'https://username:password@host:8080/path/path1';
let c = new url.URL('/path/path1', b);  // Output 'https://username:password@host:8080/path/path1'; 
new url.URL('/path/path1', c); // Output 'https://username:password@host:8080/path/path1';
new url.URL('/path/path1', a); // Output 'https://username:password@host:8080/path/path1';
new url.URL('/path/path1', "https://www.exampleUrl/fr-FR/toot"); // Output https://www.exampleUrl/path/path1
new url.URL('/path/path1', ''); // Raises a TypeError exception as '' is not a valid URL
new url.URL('/path/path1'); // Raises a TypeError exception as '/path/path1' is not a valid URL
new url.URL('https://www.example.com', ); // Output https://www.example.com/
new url.URL('https://www.example.com', b); // Output https://www.example.com/

constructor9+

constructor()

URL的无参构造函数。parseURL调用后返回一个URL对象，不单独使用。

原子化服务API：从API version 11开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

parseURL9+

static parseURL(url: string, base?: string|URL): URL

URL静态成员函数。

原子化服务API：从API version 11开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

参数：

参数名 类型 必填 说明
url string 是 一个表示绝对URL或相对URL的字符串。
如果 url 是相对URL，则需要指定 base，用于解析最终的URL。
如果 url 是绝对URL，则给定的 base 将不会生效。
base string |URL 否 入参字符串或者对象，默认值是undefined。
- string：字符串。当第一个参数是相对URL时，该参数需符合URL标准。
- URL：URL对象。
- 在url是相对URL时使用。

说明：

当入参url是相对URL时，调用该接口解析后的URL并不是简单地将入参url和base直接拼接。url内容为相对路径格式时，会相对于base的当前目录进行解析，包括base中path字段最后一个斜杠前的所有路径片段，但不包括其后的部分（参照示例中url1）。url内容为指向根目录的格式时，会相对于 base 的原始地址（origin）进行解析（参照示例中url2）。

错误码：

以下错误码的详细介绍请参见通用错误码和语言基础类库错误码。

错误码ID 错误信息
401 Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types; 3. Parameter verification failed.
10200002 Invalid url string.

示例：

let mm = 'https://username:password@host:8080/test/test1/test3';
let urlObject = url.URL.parseURL(mm);
let result = urlObject.toString(); // Output 'https://username:password@host:8080/test/test1/test3'
// url内容为相对路径格式时，此时base参数的path为test/test1,解析后的URL的path为/test/path2/path3
let url1 = url.URL.parseURL('path2/path3', 'https://www.example.com/test/test1'); // Output 'https://www.example.com/test/path2/path3'
// url内容为指向根目录的格式时，此时base参数的path为/test/test1/test3，解析后的URL的path为/path1/path2
let url2 = url.URL.parseURL('/path1/path2', urlObject); // Output 'https://username:password@host:8080/path1/path2'
url.URL.parseURL('/path/path1', "https://www.exampleUrl/fr-FR/toot"); // Output 'https://www.exampleUrl/path/path1'
url.URL.parseURL('/path/path1', ''); // Raises a TypeError exception as '' is not a valid URL
url.URL.parseURL('/path/path1'); // Raises a TypeError exception as '/path/path1' is not a valid URL
url.URL.parseURL('https://www.example.com', ); // Output 'https://www.example.com/'
url.URL.parseURL('https://www.example.com', urlObject); // Output 'https://www.example.com/'

toString

toString(): string

将解析过后的URL转化为字符串。

原子化服务API：从API version 11开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

返回值：

类型 说明
string 转化后的字符串。

示例：

const urlObject = url.URL.parseURL('https://username:password@host:8080/directory/file?query=pppppp#qwer=da');
let result = urlObject.toString(); // Output 'https://username:password@host:8080/directory/file?query=pppppp#qwer=da'

toJSON

toJSON(): string

将解析过后的URL转化为JSON字符串。

原子化服务API：从API version 11开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

返回值：

类型 说明
string 转化后的JSON字符串。

示例：

const urlObject = url.URL.parseURL('https://username:password@host:8080/directory/file?query=pppppp#qwer=da');
let result = urlObject.toJSON();

URLSearchParams(deprecated)

URLSearchParams接口定义了一些处理URL查询字符串的实用方法，从API version 9开始废弃，建议使用URLParams。

constructor(deprecated)

constructor(init?: string[][]|Record&lt;string, string&gt;|string|URLSearchParams)

URLSearchParams的构造函数。

说明：

从API version 7开始支持，从API version 9开始废弃，建议使用URLParams.constructor9+替代。

系统能力： SystemCapability.Utils.Lang

参数：

参数名 类型 必填 说明
init string[][] |Record&lt;string, string&gt; |string |URLSearchParams 否 入参对象。
- string[][]：字符串二维数组。
- Record&lt;string, string&gt;：对象列表。
- string：字符串。
- URLSearchParams：对象。
- 默认值：undefined。

示例：

let objectParams = new url.URLSearchParams([ ['user1', 'abc1'], ['query2', 'first2'], ['query3', 'second3'] ]);
let objectParams1 = new url.URLSearchParams({"fod" : '1' , "bard" : '2'});
let objectParams2 = new url.URLSearchParams('?fod=1&bard=2');
let urlObject = new url.URL('https://developer.mozilla.org/?fod=1&bard=2');
let params = new url.URLSearchParams(urlObject.search);

append(deprecated)

append(name: string, value: string): void

将新的键值对插入到查询字符串。

说明：

从API version 7开始支持，从API version 9开始废弃，建议使用URLParams.append9+替代。

系统能力： SystemCapability.Utils.Lang

参数：

参数名 类型 必填 说明
name string 是 需要插入搜索参数的键名。
value string 是 需要插入搜索参数的值。

示例：

let urlObject = new url.URL('https://developer.exampleUrl/?fod=1&bard=2');
let paramsObject = new url.URLSearchParams(urlObject.search.slice(1));
paramsObject.append('fod', '3');

delete(deprecated)

delete(name: string): void

删除指定名称的键值对。

说明：

从API version 7开始支持，从API version 9开始废弃，建议使用URLParams.delete9+替代。

系统能力： SystemCapability.Utils.Lang

参数：

参数名 类型 必填 说明
name string 是 需要删除的键值名称。

示例：

let urlObject = new url.URL('https://developer.exampleUrl/?fod=1&bard=2');
let paramsObject = new url.URLSearchParams(urlObject.search.slice(1));
paramsObject.delete('fod');

getAll(deprecated)

getAll(name: string): string[]

获取指定名称的所有键值对。

说明：

从API version 7开始支持，从API version 9开始废弃，建议使用URLParams.getAll9+替代。

系统能力： SystemCapability.Utils.Lang

参数：

参数名 类型 必填 说明
name string 是 指定的键值名称。

返回值：

类型 说明
string[] 返回指定名称的所有键值对。

示例：

let urlObject = new url.URL('https://developer.exampleUrl/?fod=1&bard=2');
let params = new url.URLSearchParams(urlObject.search.slice(1));
params.append('fod', '3'); // Add a second value for the fod parameter.
console.log(params.getAll('fod').toString()) // Output ["1","3"].

entries(deprecated)

entries(): IterableIterator<[string, string]>

返回一个ES6的迭代器，迭代器的每一项都是一个JavaScript Array。Array的第一项是name，Array的第二项是value。

说明：

从API version 7开始支持，从API version 9开始废弃，建议使用URLParams.entries9+替代。

系统能力： SystemCapability.Utils.Lang

返回值：

类型 说明
IterableIterator&lt;[string, string]&gt; 返回一个ES6的迭代器。

示例：

let searchParamsObject = new url.URLSearchParams("keyName1=valueName1&keyName2=valueName2");
let iter: Iterable<Object[]> = searchParamsObject.entries();
let pairs = Array.from(iter);
for (let pair of pairs) { // Show keyName/valueName pairs
  console.log(pair[0]+ ', '+ pair[1]);
}

forEach(deprecated)

forEach(callbackFn: (value: string, key: string, searchParams: URLSearchParams) => void, thisArg?: Object): void

通过回调函数来遍历URLSearchParams实例对象上的键值对。

说明：

从API version 7开始支持，从API version 9开始废弃，建议使用URLParams.forEach9+替代。

系统能力： SystemCapability.Utils.Lang

参数：

参数名 类型 必填 说明
callbackFn function 是 回调函数。
thisArg Object 否 callbackFn被调用时用作this值，默认值是本对象。

表1 callbackFn的参数说明

参数名 类型 必填 说明
value string 是 当前遍历到的键值。
key string 是 当前遍历到的键名。
searchParams URLSearchParams 是 当前调用forEach方法的实例对象。

示例：

const myURLObject = new url.URL('https://developer.exampleUrl/?fod=1&bard=2');
myURLObject.searchParams.forEach((value, name, searchParams) => {
    console.log(name, value, myURLObject.searchParams === searchParams);
});

get(deprecated)

get(name: string): string|null

获取指定名称对应的第一个值。

说明：

若查找一个不存在的键值对名称时返回值为undefined，从API version 7开始支持，从API version 9开始废弃，建议使用URLParams.get9+替代。

系统能力： SystemCapability.Utils.Lang

参数：

参数名 类型 必填 说明
name string 是 指定键值对的名称。

返回值：

类型 说明
string 返回第一个值。
null 如果没找到，返回 null。

示例：

let paramsObject = new url.URLSearchParams('name=Jonathan&age=18');
let name = paramsObject.get("name"); // is the string "Jonathan"
let age = paramsObject.get("age"); // is the string '18'
let getObj = paramsObject.get("abc"); // undefined

has(deprecated)

has(name: string): boolean

判断一个指定的键名对应的值是否存在。

说明：

从API version 7开始支持，从API version 9开始废弃，建议使用URLParams.has9+替代。

系统能力： SystemCapability.Utils.Lang

参数：

参数名 类型 必填 说明
name string 是 要查找的参数的键名。

返回值：

类型 说明
boolean 是否存在相对应的key值。存在返回true，否则返回false。

示例：

let urlObject = new url.URL('https://developer.exampleUrl/?fod=1&bard=2');
let paramsObject = new url.URLSearchParams(urlObject.search.slice(1));
paramsObject.has('bard') === true;

set(deprecated)

set(name: string, value: string): void

将与name关联的URLSearchParams对象中的值设置为value。如果存在名称为name的键值对，请将第一个键值对的值设置为value并删除所有其他值。如果不是，则将键值对附加到查询字符串。

说明：

从API version 7开始支持，从API version 9开始废弃，建议使用URLParams.set9+替代。

系统能力： SystemCapability.Utils.Lang

参数：

参数名 类型 必填 说明
name string 是 将要设置的参数的键值名。
value string 是 所要设置的参数值。

示例：

let urlObject = new url.URL('https://developer.exampleUrl/?fod=1&bard=2');
let paramsObject = new url.URLSearchParams(urlObject.search.slice(1));
paramsObject.set('baz', '3'); // Add a third parameter.

sort(deprecated)

sort(): void

对包含在此对象中的所有键值对进行排序，并返回undefined。排序顺序是根据键的Unicode代码点。该方法使用稳定的排序算法 （即，将保留具有相等键的键值对之间的相对顺序）。

说明：

从API version 7开始支持，从API version 9开始废弃，建议使用URLParams.sort9+替代。

系统能力： SystemCapability.Utils.Lang

示例：

let searchParamsObject = new url.URLSearchParams("c=3&a=9&b=4&d=2"); // Create a test URLSearchParams object
searchParamsObject.sort(); // Sort the key/value pairs
console.log(searchParamsObject.toString()); // Display the sorted query string // Output a=9&b=4&c=3&d=2

keys(deprecated)

keys(): IterableIterator&lt;string&gt;

返回一个所有键值对的name的ES6迭代器。

说明：

从API version 7开始支持，从API version 9开始废弃，建议使用URLParams.keys9+替代。

系统能力： SystemCapability.Utils.Lang

返回值：

类型 说明
IterableIterator&lt;string&gt; 返回一个所有键值对的name的ES6迭代器。

示例：

let searchParamsObject = new url.URLSearchParams("key1=value1&key2=value2"); // Create a URLSearchParamsObject object for testing
let keys = Array.from(searchParamsObject.keys());
for (let key of keys) { // Output key-value pairs
  console.log(key);
}

values(deprecated)

values(): IterableIterator&lt;string&gt;

返回一个所有键值对的value的ES6迭代器。

说明：

从API version 7开始支持，从API version 9开始废弃，建议使用URLParams.values9+替代。

系统能力： SystemCapability.Utils.Lang

返回值：

类型 说明
IterableIterator&lt;string&gt; 返回一个所有键值对的value的ES6迭代器。

示例：

let searchParams = new url.URLSearchParams("key1=value1&key2=value2"); // Create a URLSearchParamsObject object for testing
let values = Array.from(searchParams.values());
for (let value of values) {
  console.log(value);
}

[Symbol.iterator](deprecated)

[Symbol.iterator](): IterableIterator&lt;[string, string]&gt;

返回一个ES6的迭代器，迭代器的每一项都是一个JavaScript Array。Array的第一项是name，Array的第二项是value。

说明：

从API version 7开始支持，从API version 9开始废弃，建议使用URLParams.[Symbol.iterator]9+替代。

系统能力： SystemCapability.Utils.Lang

返回值：

类型 说明
IterableIterator&lt;[string, string]&gt; 返回一个ES6的迭代器。

示例：

const paramsObject = new url.URLSearchParams('fod=bay&edg=bap');
let iter: Iterable<Object[]> = paramsObject[Symbol.iterator]();
let pairs = Array.from(iter);
for (let pair of pairs) {
  console.log(pair[0] + ', ' + pair[1]);
}

toString(deprecated)

toString(): string

返回序列化为字符串的搜索参数，必要时对字符进行百分比编码。

说明：

从API version 7开始支持，从API version 9开始废弃，建议使用URLParams.toString9+替代。

系统能力： SystemCapability.Utils.Lang

返回值：

类型 说明
string 返回序列化为字符串的搜索参数，必要时对字符进行百分比编码。

示例：

let urlObject = new url.URL('https://developer.exampleUrl/?fod=1&bard=2');
let params = new url.URLSearchParams(urlObject.search.slice(1));
params.append('fod', '3');
console.log(params.toString()); // Output 'fod=1&bard=2&fod=3'

你可能感兴趣的鸿蒙文章

harmony 鸿蒙ArkTS（方舟编程语言）

harmony 鸿蒙编译工具链错误码

harmony 鸿蒙Typescript Compiler错误码介绍

harmony 鸿蒙语言基础类库错误码

harmony 鸿蒙js-apis-arkts-collections

harmony 鸿蒙js-apis-arkts-decimal

harmony 鸿蒙@arkts.lang (ArkTS语言基础能力)

harmony 鸿蒙@arkts.utils (ArkTS工具库)

harmony 鸿蒙@ohos.util.ArrayList (线性容器ArrayList)

harmony 鸿蒙@ohos.buffer (Buffer)

0  赞
  • 所属分类： 后端技术
  • 本文标签：
  • 版权声明： 原创文章如转载，请注明本文链接: https://www.seaxiang.com/blog/Jr0mDm
热门推荐
标签云
Linux Java Spring Spring Boot docker 大数据 前端 生活 maven golang 软件 spring cloud fintech mac vscode 其他 区块链 以太坊 V神 开发者 技术 股票 git greenplum 分布式事务 chrome mysql flink kafka 设计模式 原理 鸿蒙 seo
最新文章
本文目录