Skip to content

k.utils.uri ​

URL 解析与查询字符串

概述 ​

k.utils.uri 提供 parse 及查询参数读写;parse 返回 KUriBuilder 实例。

parse() ​

参数类型必填说明
uristring是要解析的完整 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)读取查询参数
参数类型必填说明
uristring是原始 URL
namestring是查询参数名
valuestringsetQueryParam 必填查询参数值
方法返回
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 / queryURI 组成部分
userName / password凭据
setQueryParam(name, value)修改查询串
getQueryParam(name)读取查询参数
toUri()输出完整 URL 字符串

KUriBuilder.setQueryParam() 返回 void,getQueryParam() 返回 string \| null,toUri() 返回 string。

相关文档 ​