HarmonyOS URL字符串解析 常用的几个方法

HarmonyOS 使用 URI字符串解析 的好处

1. 标准化解析：HarmonyOS的URL字符串解析方法遵循相关标准（如RFC 3986），确保了对URL的标准化解析。这有助于提高解析的准确性和一致性，降低因解析错误而导致的安全风险。
2. 简洁明了的API接口：HarmonyOS提供了简洁明了的API接口，使得开发者可以轻松地构造、解析和比较URL对象。这降低了开发难度和复杂度，提高了开发效率。
3. 支持单独访问和修改URL组成部分：HarmonyOS的URL解析模块支持对URL的各个组成部分进行单独访问和修改。这满足了不同应用场景下的需求，使得开发者能够灵活地操作URL。
4. 正确处理特殊字符和编码问题：在解析URL时，HarmonyOS能够正确处理特殊字符和编码问题。这避免了因解析错误而导致的安全漏洞和数据丢失等问题。

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

URI字符串解析

1. URLParams

        1. constructor

        2. append

        3. delete

2. URL

        1. constructor

        2. parseURL

        3. toString

        4. toJSON

导入模块

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

1. URLParams

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

1. constructor

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

URLParams的构造函数。

参数：

 使用方式：

// 通过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;

2. append

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

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

参数：

使用方式：

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');

3. delete

delete(name: string): void

删除指定名称的键值对

参数：

使用方式：

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

2. URL

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

1. constructor

constructor(url: string, base?: 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/

2. parseURL

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

URL静态成员函数。

参数：

使用方式：

let mm = 'https://username:password@host:8080';
let urlObject = url.URL.parseURL(mm);
let result = urlObject.toString(); // Output 'https://username:password@host:8080/'

3. toString

toString(): string

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

返回值：

使用方式：

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'

4. toJSON

toJSON(): string

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

返回值：

使用方式：

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

 如需要其他方法 请参考官方文档

制作不易 点个关注再走吧｡°(°¯᷄◠¯᷅°)°｡

​