k.utils.uri
URL 解析与查询字符串
概述
k.utils.uri 提供 parse 及查询参数读写;parse 返回 KUriBuilder 实例。
parse()
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
uri | string | 是 | 要解析的完整 URL |
返回: KUriBuilder \| null。
ts
const builder = k.utils.uri.parse("https://example.com/path?q=1")
builder.setQueryParam("page", "2")
const url = builder.toUri()便捷方法
| 方法 | 说明 |
|---|---|
setQueryParam(uri, name, value) | 设置查询参数并返回新 URL 字符串 |
getQueryParam(uri, name) | 读取查询参数 |
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
uri | string | 是 | 原始 URL |
name | string | 是 | 查询参数名 |
value | string | setQueryParam 必填 | 查询参数值 |
| 方法 | 返回 |
|---|---|
setQueryParam(uri, name, value) | string | null |
getQueryParam(uri, name) | string | null |
ts
const campaign = k.utils.uri.getQueryParam("https://example.com/?utm_campaign=spring", "utm_campaign")
const nextUrl = k.utils.uri.setQueryParam("/products?page=1", "page", "2")KUriBuilder
| 成员 | 说明 |
|---|---|
scheme / host / port / path / query | URI 组成部分 |
userName / password | 凭据 |
setQueryParam(name, value) | 修改查询串 |
getQueryParam(name) | 读取查询参数 |
toUri() | 输出完整 URL 字符串 |
KUriBuilder.setQueryParam() 返回 void,getQueryParam() 返回 string \| null,toUri() 返回 string。