# @cliqz/url-parser 中文文档

规范地址：https://npmcn.com/package/%40cliqz/url-parser/

版本：1\.1\.5
npm 元数据更新时间：2024-10-17T11:30:28.956Z
中文译文更新时间：2026-11-10T02:03:51.501Z
软件包许可：MPL-2\.0

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40cliqz/url-parser
原文对照：https://npmcn.com/package/%40cliqz/url-parser/?lang=original

弃用说明：This project has been renamed to @ghostery/url-parser\. Install using @ghostery/url-parser instead

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：1.1 MB，49 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：1 个
- 首次发布：2019-07-02T09:43:00.258Z
- 最新版本发布：2023-07-18T09:42:18.296Z
- 近 30 天下载量：4924（2026-10-10 至 2026-11-08，npm 官方下载统计）
- 已发布版本数：407（近 12 个月 0 个）

## 中文简介

一个快速 URL 解析器执行

## 安装

```sh
npm install @cliqz/url-parser
```

也可以使用：`pnpm add @cliqz/url-parser`、`yarn add @cliqz/url-parser`、`bun add @cliqz/url-parser`

## README

# Cliqz 乌尔解析器

快速执行 url 解析, 主要是 API 兼容标准 URL 类, 同时 平均快2-3倍。 对 URL 组件的评价是懒惰的,所以执行 对所有读取的用例应快速.

已知的标准 URL 差异 :

-   参数通过 `URL.searchParams.entries()` 仅用 `decodeURIComponent`这与以一些微妙方式解释的标准不同.
-   您可以直接通过 : `URL.searchParams.params`这儿 比使用传动器快20%.
-   参数字符串( E)`;` 已解析并可通过 `URL.parameters`。 。 。 .
-   域解析用 [转子](https://github.com/remusao/tldts) 内置。 这个 `URL.domainInfo` 属性返回 tldts 的输出 `parseHost` 方法.
-   主机名验证未在初始剖析中完成 。 这个 `isValidHost()` 提供了方法 这个目的.
-   所有具有有效权限的 URL 都会获得一个 `origin`,无论协议方案。 这不同于 [标准](https://url.spec.whatwg.org/#origin) 这只针对一套已知的计划.

## 安装

```bash
npm install @cliqz/url-parser
```

## 使用量

```javascript
const parsed = new URL('https://www.example.com');
parsed.hostname // == 'www.example.com'
```

## 业绩

我们以从热门网站收集的25万个URL列表作为基准 [标记器基准](https://whotracks.me/blog/adblockers_performance_study.html)我们比较 两个用例:

1.  `URL` 对象创建 : `new URL(url)`
2.  查询字符串解析 : `new URL(url).searchParams.entries()`

我们比较了每个平台的参考执行情况:

-   节点 : `URL` 类从 `url` 图书馆
-   Firefox: (英语) `window.URL`
-   颜色 : `window.URL`
-   萨法里: `window.URL`

| 环境 | 使用大小写 | 参考文献:urls/s | Cliqz 解析器: urls/ s | 加速 |
| --- | --- | --: | --: | --- |
| 节点 11 | `new URL()` | `149,514` | `1,577,711` | _10.5x 较快_ |
| 节点 11 | `searchParams` | `140,544` | `198,340` | _1.4x 较快_ |
| 火狐69号 | `new URL()` | `268,066` | `1,043,877` | _3.9x 较快_ |
| 火狐69号 | `searchParams` | `119,207` | `354,793` | _3.0x 较快_ |
| 铬. 75 | `new URL()` | `366,294` | `1,721,903` | _4.7x 较快_ |
| 铬. 75 | `searchParams` | `144,309` | `283,956` | _较快2.0x_ |
| 萨法里 12 | `new URL()` | `656,930` | `1,525,078` | _2.3x 较快_ |
| 萨法里 12 | `searchParams` | `264,481` | `437,738` | _1.7x 较快_ |

所有基准都运行在一款2015年中期Macbook Pro上,2.5GHz Intel Core i7,16GB.

## 许可证

[Mozilla 公共许可证2.0](https://npmcn.com/package/%40cliqz/url-parser/LICENSE)

## 常见问题

### @cliqz/url-parser 是什么？

一个快速 URL 解析器执行注意：该包已被作者标记为弃用——This project has been renamed to @ghostery/url-parser\. Install using @ghostery/url-parser instead

### 如何安装 @cliqz/url-parser？

在项目目录运行 npm install @cliqz/url-parser，或使用 pnpm add / yarn add / bun add。

### @cliqz/url-parser 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @cliqz/url-parser 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。

### @cliqz/url-parser 可以商用吗？

@cliqz/url-parser 使用 MPL-2\.0 许可。弱 Copyleft：可以商用，也可以和闭源代码一起使用；但如果分发时修改了 MPL 授权的文件，这些文件的修改需以 MPL 开源。以上为概括，不构成法律意见，请以许可原文为准。

### @cliqz/url-parser 的下载量有多少？

根据 npm 官方下载统计，@cliqz/url-parser 在 2026/10/10 – 2026/11/08 这 30 天内被下载 4,924 次，日均约 164 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @cliqz/url-parser 还在维护吗？

最新版本 1\.1\.5 发布于 2023/07/18（3 年前）；至今共发布 407 个版本，其中过去 12 个月发布了 0 个；首次发布于 2019/07/02。作者已将其标记为弃用，新项目建议寻找替代方案。