更新记录

1.0.0（2025-04-18） 下载此版本

• 初始发布。

平台兼容性

kux-uts-url

一个轻量级、安全的 UTS 跨平台 URL 解析工具，提供符合 WHATWG URL 标准的实现。

📖 简介

kux-uts-url 是为 UTS 环境打造的 URL 解析工具，实现了标准 URL 和 URLSearchParams 的核心功能，支持：

• 完整的 URL 组成部分解析（协议、主机、路径、查询参数等）
• 安全的协议白名单验证（HTTP/HTTPS/FTP/FILE）
• 符合规范的查询参数处理
• 跨平台兼容性

🔨 使用示例

解析URL

import { URL }  from '@/uni_modules/kux-uts-url';

const url = new URL("https://example.com/path?name=Alice#section")
console.log(url.hostname) // 输出 "example.com"
console.log(url.searchParams.get("name")) // 输出 "Alice"

修改 URL 属性

url.protocol = "https"
url.pathname = "/new-path"
console.log(url.href) // 输出 "https://example.com/new-path?name=Alice#section"

操作查询参数

const params = url.searchParams;
params.append("age", "25");
params.set("name", "Bob");
// 更新现有参数
url.search = params.toString();

📚 API 文档

URL 类

URLSearchParams 类

⚠️ 注意事项

1. 协议白名单：仅支持 http/https/ftp/file，其他协议会抛出错误
2. 路径规范化：自动将空路径转为 /，处理 . 和 .. 路径段
3. 编码处理：查询参数值会自动进行 URL 编码/解码
4. 参数更新：操作查询参数后一定要手动更新 search 值才会生效。

结语

kux 不生产代码，只做代码的搬运工，致力于提供uts 的 js 生态轮子实现，欢迎各位大佬在插件市场搜索使用 kux 生态插件：https://ext.dcloud.net.cn/search?q=kux

友情推荐

• TMUI4.0：包含了核心的uts插件基类.和uvue组件库
• GVIM即时通讯模版：GVIM即时通讯模版，基于uni-app x开发的一款即时通讯模版
• t-uvue-ui：T-UVUE-UI是基于UNI-APP X开发的前端UI框架
• UxFrame 低代码高性能UI框架：【F2图表、双滑块slider、炫酷效果tabbar、拖拽排序、日历拖拽选择、签名...】UniAppX 高质量UI库
• wx-ui 基于uni-app x开发的高性能混合UI库：基于uni-app x开发的高性能混合UI库，集成 uts api 和 uts component，提供了一套完整、高效且易于使用的UI组件和API，让您以更少的时间成本，轻松完成高性能应用开发。
• firstui-uvue：FirstUI（unix）组件库，一款适配 uni-app x 的轻量、简洁、高效、全面的移动端组件库。