@googlicius/build-url

中文文档
1.0.11发布于 2021/08/03MITTypeScriptCommonJS零依赖近 30 天下载 1.4万

构建 URL 助手

中文使用文档
文档目录3 节
  1. 安装
  2. 使用量
  3. 许可证

构建 URL

帮助构建 URL 有查询参数作为简单方法 。 在基于 URL 查询参数的应用程序路由或状态管理时有所帮助 .

安装

npm install @googlicius/build-url

或者亚恩:

yarn add @googlicius/buil-url

使用量

import buildUrl from '@googlicius/build-url';

buildUrl('http://my-website.com/post', {
  queryParams: {
    page: 2,
  },
});

// Output: http://my-website.com/post?page=2

添加另一个查询参数

buildUrl('http://my-website.com/post?page=2', {
  queryParams: {
    sort: 'title:asc',
  },
});

// Output: http://my-website.com/post?page=2&sort=title%3Aasc

输入url/路径被省略

buildUrl({
  queryParams: {
    sort: 'title:asc',
  },
});

// Output: /?sort=title%3Aasc

删除查询参数

buildUrl('images?page=2&sort=title:asc', {
  queryParams: {
    page: null,
  },
});

// Output: /images?sort=title%3Aasc

总是返回绝对url

// Assume that current url is: http://awesome-website.com

buildUrl('/posts', {
  returnAbsoluteUrl: true,
  queryParams: {
    page: 2,
  },
});

// Output: http://awesome-website.com/posts?page=2

许可证

麻省理工学院

版本与发布记录

@googlicius/build-url 共发布 12 个版本,首次发布于 2021/07/23;过去 12 个月发布了 0 个版本。

版本发布日期距今
1.0.11latest2021/08/035 年前
1.0.102021/08/035 年前
1.0.92021/08/035 年前
1.0.82021/07/255 年前
1.0.72021/07/235 年前
1.0.42021/07/235 年前

关于 @googlicius/build-url 的常见问题

@googlicius/build-url 是什么?

构建 URL 助手

如何安装 @googlicius/build-url?

在项目目录运行 npm install @googlicius/build-url,或使用 pnpm add / yarn add / bun add。

@googlicius/build-url 支持 TypeScript 吗?

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

@googlicius/build-url 支持 ESM 还是 CommonJS?

以 CommonJS 形式发布,可以直接 require();在 ES Module 项目中也可以用 import 引入(Node.js 会把 module.exports 作为默认导出)。

@googlicius/build-url 可以商用吗?

@googlicius/build-url 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@googlicius/build-url 的下载量有多少?

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

@googlicius/build-url 还在维护吗?

最新版本 1.0.11 发布于 2021/08/03(5 年前);至今共发布 12 个版本,其中过去 12 个月发布了 0 个;首次发布于 2021/07/23。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。