URI.js 使用与技术文档

URI.js 是一个轻量级的库，用于操作和解析 URI。下面是关于如何安装、使用以及 API 的技术文档。

1. 安装指南

URI.js 可以通过多种方式安装：

通过 npm 安装

npm install urijs

通过 bower 安装

bower install uri.js

手动安装

你也可以从 URI.js 的构建页面手动下载最新的代码。

2. 使用说明

URI.js 提供了一个简洁的 API，用于修改和解析 URI。下面是一些使用示例：

修改 URI

var url = new URI("http://example.org/foo?bar=baz");
url.addQuery("foo", "bar");

清理 URI

URI("?&foo=bar&&foo=bar&foo=baz&")
  .normalizeQuery();

相对路径

URI("/foo/bar/baz.html")
  .relativeTo("/foo/bar/world.html");

URI 模板

URI.expand("/foo/{dir}/{file}", {
  dir: "bar",
  file: "world.html"
});

更多使用示例和文档，请参考官方文档。

3. 项目 API 使用文档

以下是 URI.js 的一些常用 API 方法：

创建 URI 实例

var uri = new URI("http://example.com");

添加查询参数

uri.addQuery("param", "value");

移除查询参数

uri.removeQuery("param");

设置路径

uri.setPath("/new/path");

获取路径

uri.getPath();

设置查询字符串

uri.setQuery("param=value");

获取查询字符串

uri.getQuery();

更多 API 方法，请参考官方 API 文档。

4. 项目安装方式

除了上述的 npm 和 bower 安装方式，你还可以通过以下方式使用 URI.js：

在浏览器中使用

将 URI.min.js 文件包含到你的 HTML 文件中：

<script src="path/to/URI.min.js"></script>

在 Node.js 中使用

通过 require 引入 URI.js：

var URI = require('urijs');

以上是 URI.js 的安装和使用技术文档。希望对你有所帮助！