@brazilian-utils/brazilian-utils

中文文档
2.5.0发布于 2026/10/04MITTypeScriptESM + CJS零依赖构建来源已验证近 30 天下载 16.1万

巴西数据的零依赖性、可树动类型Script公用事业:验证、格式、剖析和生成CPF、CNPJ、CEP、Boleto、Pix、电话、节假日等.

中文使用文档
文档目录7 节
  1. 为什么巴西的Utils
  2. 安装
  3. 运行时间支持
  4. 使用量
  5. 发展
  6. 贡献者
  7. 许可证
Brazilian Utils

巴西的公用事业数据:CPF、CNPJ、CEP、Boleto、Pix、假日等.

页:1

npm version Downloads per month License: MIT Zero dependencies TypeScript Build Status Tests codecov Mutation tests OpenSSF Scorecard OpenSSF Best Practices

目录

开始

巴西Utils是一个零依赖性小公用设施库,用于解决巴西制造软件的日常问题:验证、格式化、剖析和生成CPF、CNPJ、CEP、Boleto、Pix、电话号码、假日等等.

为什么巴西的Utils

  • 零运行时间依赖关系. 你身上没有别的东西 node_modules 或者在你的捆绑.
  • 树能震动,下至功能. import { isValidCpf } 成本约为0.5 KB 精密(0.3 KB gziped). 每个管子也是它自己的子道入道,因此重道入道可以被懒惰地装载.
  • 到处跑. 节点.js ^20.19.0 || >=22.12.0, Bun, Deno 和 evergreen 浏览器, 都在CI测试.
  • 在 TypeScript 中写入 . 与包打出船来,每一次拉出请求都会与上回放出相比被检查,所以公众API从不会默默地改变.
  • 对照官方规则验证. 每个验证员都引用其执行的规格,定律或数据集,测试套件经过了突变测试,而不仅仅是覆盖.
  • 英文和葡萄牙文文件,带有 llms.txt 给AI助手的.

安装

npm install @brazilian-utils/brazilian-utils

同一软件包与 yarn add, (中文(简体) ), pnpm add 财务报告和审定财务报表 bun add在平地上 <script> 标记它暴露全球 BrazilianUtils数字 :

<script src="https://unpkg.com/@brazilian-utils/brazilian-utils/dist/brazilian-utils.umd.cjs"></script>

运行时间支持

支持范围是 engines 输入 package.json; 下行每行运行于 测试工作流程 每一个拉请求.

运行时间支助测试于CI
节点.js^20.19.0 || >=22.12.0第20、22、24、26条
阿宝最新消息最新消息
德诺2.x 数据2.x 数据
浏览器常绿克罗姆、火狐、边缘、萨法里

使用量

导入所需的函数 :

import { isValidCpf } from "@brazilian-utils/brazilian-utils";

isValidCpf("1232454233345"); // false

这个 水电费参考 列出按家庭分类的每个功能,以及其选项和实例.

  • 使用AI编码助理? 文件在上下文7上索引为 /brazilian-utils/javascript,以及 页:1 列出用于其他工具的每个工具。 见 AI 助理人员。 。 。 .
  • 包裹可树摇. 每个管子也作为自己的子路径(如. @brazilian-utils/brazilian-utils/get-cities这样你就可以懒惰地装上几个重的 见 套装大小。 。 。 .

发展

此寄存器使用 Vite+ 作为本地工具链; 它被安装为依赖, 所以没有 将在24号节点之后全球安装(版本为 .nvmrc,工具链需要的 库本身支持节点.js ^20.19.0 || >=22.12.0) (中文(简体) ).

npm install
npm run check
npm test
npm run build

捐款额 列出每个脚本和检查 牵引请求通过.

发布注释通过 GitHub 发布。 。 。 .

贡献者

我们的"谢谢"是给这些优秀的人的emoji 密钥:


希安·曼地语Name

💻 📖 🤔 ⚠️

卢卡斯·维洛索

💻 📖 🤔 ⚠️

安德烈奥·维埃拉

💻 📖 🤔 🔧

马修斯·阿尔梅达

💻 📖 ⚠️

费尔南多·罗热林

💻 📖 ⚠️

罗地涅伊夫

💻 📖 ⚠️

爱默生·洛朗蒂诺

💻 📖 ⚠️

莱昂纳多·杜特拉

💻 📖 ⚠️

维克多·马加莱

💻 🔧

阿毛里·迪亚斯

💻 🔧

费利佩·迪奥戈

💻 ⚠️

艾伦·拉索

💻 ⚠️

费利佩脚

📖

拉斐尔·佛朗哥

💻 📖

拉斐尔·佩泽蒂

💻 ⚠️ 📖

安东尼奥·罗伯托·富拉内托

💻 📖 ⚠️

费利佩·诺莱托·纳西门托

💻 📖 ⚠️

索罗·约布

📖

佩德罗·阿兰特斯

💻 📖 ⚠️

西尔维奥·克莱西奥

💻 📖 ⚠️

卢卡斯·纳西门托

💻

林康·克苏诺基

💻 📖 ⚠️

马塞洛·克里斯蒂亚诺

💻 📖 ⚠️

塔西西奥·巴蒂斯塔·德弗赖塔斯

📖

卢卡斯·卡里亚斯

📖 ⚠️ 💻 🔧

马修斯·安德烈

📖

恩里克·沃尔波尼

💻

林赛·费雷拉

💻

维森特·范德拉明

💻

乔·阿萨德

💻 ⚠️

扬德·席尔瓦

💻

千维404

💻 ⚠️

本项目遵循 全部贡献者 规格。 欢迎任何捐助!

许可证

麻省理工学院

版本与发布记录

@brazilian-utils/brazilian-utils 共发布 21 个版本,首次发布于 2020/01/14;过去 12 个月发布了 7 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
2.5.0latest2026/10/041 个月前
2.4.02026/09/181 个月前
2.3.02026/04/096 个月前
2.2.02026/04/087 个月前
2.1.02026/04/037 个月前
2.0.12026/03/317 个月前

关于 @brazilian-utils/brazilian-utils 的常见问题

@brazilian-utils/brazilian-utils 是什么?

巴西数据的零依赖性、可树动类型Script公用事业:验证、格式、剖析和生成CPF、CNPJ、CEP、Boleto、Pix、电话、节假日等.

如何安装 @brazilian-utils/brazilian-utils?

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

@brazilian-utils/brazilian-utils 支持 TypeScript 吗?

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

@brazilian-utils/brazilian-utils 支持 ESM 还是 CommonJS?

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

@brazilian-utils/brazilian-utils 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js ^20.19.0 || >=22.12.0。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@brazilian-utils/brazilian-utils 可以商用吗?

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

@brazilian-utils/brazilian-utils 的下载量有多少?

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

@brazilian-utils/brazilian-utils 还在维护吗?

最新版本 2.5.0 发布于 2026/10/04(1 个月前);至今共发布 21 个版本,其中过去 12 个月发布了 7 个;首次发布于 2020/01/14。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。