# @dmalbuquerque/cpf-cnpj-validator 中文文档

规范地址：https://npmcn.com/package/%40dmalbuquerque/cpf-cnpj-validator/

版本：1\.0\.3
npm 元数据更新时间：2025-03-09T19:46:57.317Z
中文译文更新时间：2026-11-13T04:43:17.445Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40dmalbuquerque/cpf-cnpj-validator
原文对照：https://npmcn.com/package/%40dmalbuquerque/cpf-cnpj-validator/?lang=original
项目主页：https://github.com/dmAlbuquerque/cpf-cnpj-validator#readme
源码仓库：https://github.com/dmAlbuquerque/cpf-cnpj-validator

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

- 包体积（解压后）：84.4 kB，28 个文件
- 模块格式：CommonJS
- TypeScript 类型：包内自带
- 运行依赖：2 个
- 首次发布：2025-03-09T19:25:06.381Z
- 最新版本发布：2025-03-09T19:46:57.015Z
- 近 30 天下载量：2306（2026-10-13 至 2026-11-11，npm 官方下载统计）
- 已发布版本数：4（近 12 个月 0 个）

## 中文简介

Biblioteca para gerar, vixar e formatar CPF, CNPJ e CNPJ alfanumérico com suporte para integração com Joi. 中国植物物种信息数据库.

## 安装

```sh
npm install @dmalbuquerque/cpf-cnpj-validator
```

也可以使用：`pnpm add @dmalbuquerque/cpf-cnpj-validator`、`yarn add @dmalbuquerque/cpf-cnpj-validator`、`bun add @dmalbuquerque/cpf-cnpj-validator`

## README

![License](https://img.shields.io/npm/l/cpf-cnpj-validator) ![Version](https://img.shields.io/npm/v/cpf-cnpj-validator)

# CPF 和CNPJ文件

保护儿童权利委员会, CNPJ e CNPJ alfanumérico。 Também é possível vialar CPF e CNPJ utilizando a bibliotica joi. 中国植物物种信息数据库.

## 英斯特拉桑

```sh
npm install @dmalbuquerque/cpf-cnpj-validator
```

## Como 导入双引号

### Para projetos com 字体

```ts
import { cpf, cnpj, documentValidator} from '@dmalbuquerque/cpf-cnpj-validator';

console.log(cpf.isValid('21156032300'));
console.log(cnpj.isValid('20245526000149'));
```

* * *

### Projetos com Javascript

```js
const { cpf, cnpj, documentValidator} = require('@dmalbuquerque/cpf-cnpj-validator');

console.log(cpf.isValid('21156032300'));
console.log(cnpj.isValid('20245526000149'));
```

尔

```js
const documents = require('@dmalbuquerque/cpf-cnpj-validator');

console.log(documents.cpf.isValid('21156032300'));
console.log(documents.cnpj.isValid('20245526000149'));
```

## Como usar (英语)

### 森林合作伙伴关系

#### Gerar um CPF (英语)

-   **CPF numérico sem格式化**数字 :
    
    ```js
    cpf.generate(); // Exemplo de retorno: "07208766053"
    ```
    
-   **CPF 格式ado**数字 :
    
    ```js
    cpf.generate({ formatted: true }); // Exemplo de retorno: "072.087.660-53"
    ```
    

#### 验证 um CPF

-   **CPF válido (法语)**数字 :
    
    ```js
    cpf.isValid("07208766053"); // Retorna: true
    cpf.isValid("072.087.660-53"); // Retorna: true
    ```
    
-   **IPF Inválido 人口调查**数字 :
    
    ```js
    cpf.isValid("07208766050"); // Retorna: false
    cpf.isValid("072.087.660-50"); // Retorna: false
    ```
    

#### 组图 um CPF

-   **转换器 um CPF 数字格式**数字 :
    
    ```js
    cpf.format("07208766053"); // Retorna: "072.087.660-53"
    ```
    

* * *

### 全国司法理事会

#### Gerar um CNPJ (英语)

-   **CNPJ Clássico sem格式化**数字 :
    
    ```js
    cnpj.generate({ type: "numeric" }); // Exemplo de retorno: "25143815000150"
    ```
    
    尔
    
    ```js
    cnpj.generate();
    ```
    
-   **CNPJ Clássico 格式化**数字 :
    
    ```js
    cnpj.generate({ type: "numeric", formatted: true }); // Exemplo de retorno: "25.143.815/0001-50"
    ```
    
-   **CNPJ alfanumérico sem格式版**数字 :
    
    ```js
    cnpj.generate({ type: "alfanumeric" }); // Exemplo de retorno: "OGZP0N77444Y42"
    ```
    
-   **CNPJ alfanumérico 格式化**数字 :
    
    ```js
    cnpj.generate({ type: "alfanumeric", formatted: true }); // Exemplo de retorno: "OG.ZP0.N77/444Y-42"
    ```
    

#### 鉴定 um CNPJ

-   **CNPJ Clássico válido 维多**数字 :
    
    ```js
    cnpj.isValid("25143815000150"); // Retorna: true
    cnpj.isValid("25.143.815/0001-50"); // Retorna: true
    ```
    
-   **CNPJ Clássico inválido 互联网档案馆的存檔,存档日期2013-12-02**数字 :
    
    ```js
    cnpj.isValid("25143815000140"); // Retorna: false
    cnpj.isValid("25.143.815/0001-40"); // Retorna: false
    ```
    
-   **CNPJ al-fanumérico válido (法语)**数字 :
    
    ```js
    cnpj.isValid("OGZP0N77444Y42"); // Retorna: true
    cnpj.isValid("OG.ZP0.N77/444Y-42"); // Retorna: true
    ```
    
-   **CNPJ al-fanumérico inválido 阿尔法努梅里科省**数字 :
    
    ```js
    cnpj.isValid("OGZP0N77444Y40"); // Retorna: false
    cnpj.isValid("OG.ZP0.N77/444Y-40"); // Retorna: false
    ```
    

#### Formator um CNPJ (中文(简体) )

-   **转换器 um CNPJ numérico para o formato paderão**数字 :
    
    ```js
    cnpj.format("25143815000150"); // Retorna: "25.143.815/0001-50"
    ```
    
-   **转换器 um CNPJ alfanumérico para o formato paderão**数字 :
    
    ```js
    cnpj.format("OGZP0N77444Y42"); // Retorna: "OG.ZP0.N77/444Y-42"
    ```
    

## 乔伊地区

Esta bibliotica também 允许将 CPF 和 CNPJ utilizando 改为 bibliotica Joi 。 Veja um exemplo de exemplo de exectionação : (原始内容存档于2018-09-30)

```js
import Joi from "joi";
import documentValidator from "@dmalbuquerque/cpf-cnpj-validator";

const joi = Joi.extend(documentValidator);

const schema = Joi.object({
  cpf: joi.document().cpf().optional().label("CPF"),
  cnpj: joi.document().cnpj().required().label("CNPJ"),
});

const resultado = schema.validate({ cpf: null, cnpj: "25143815000150" });
console.log(resultado.error ? resultado.error.details : "Dados válidos!");
```

## \* 重新确认效力

| 塞纳里奥 | 森林合作伙伴关系 | 全国司法理事会 | 结果 |
| --- | --- | --- | --- |
| 勇者号 `null` | 阿凯托 | 阿凯托 | **瓦利多** |
| 字符串瓦齐亚( R)`""`(中文(简体) ) | ❌ `CPF não pode ser vazio` | ❌ `CNPJ não pode ser vazio` | **额罗** |
| Campo obrigatório ausente (英语:Campo obrigatório ausente) (英语:Campo obrigatório ausenti)是法国的足球运动员,曾效力于足球运动员 | ❌ `CPF é obrigatório` | ❌ `CNPJ é obrigatório` | **额罗** |

* * *

## 自动测试

Esta bibliotica possui testes automatizados para garantir a qualidade do código. 中国植物物种信息数据库. 当地人:

```sh
npm run test
```

伊拉·罗达尔·托多斯 **欢乐**. Certifique-se-se de ter o Jest instalado em sue Environto desenvolvimento. 中国植物物种信息数据库.

## 科莫孔特里布尔

以abaixo为例:

1.  Faça umfork deste repositório. 中国植物物种信息数据库.
2.  Clone o repositório forkado para o seu Environmente local. 中国植物物种信息数据库.
3.  以依附者身份出售: `npm install`。 。 。 .
4.  Faça suas chera es e testes. 中国植物物种信息数据库.
5.  执行 os 测试 localmente para garantir que tudo esteja funcionando corretamente: `npm run test`
6.  Crie uma nova 分支 para suas chera : `git checkout -b minha-feature`。 。 。 .
7.  Abra o PR com suas verta'es. 互联网档案馆的存檔,存档日期2013-12-02.

## · 利森萨

Destribuido sob a licença 麻省理工学院. 丹尼尔·阿尔布克尔克

## 常见问题

### @dmalbuquerque/cpf-cnpj-validator 是什么？

Biblioteca para gerar, vixar e formatar CPF, CNPJ e CNPJ alfanumérico com suporte para integração com Joi\. 中国植物物种信息数据库\.

### 如何安装 @dmalbuquerque/cpf-cnpj-validator？

在项目目录运行 npm install @dmalbuquerque/cpf-cnpj-validator，或使用 pnpm add / yarn add / bun add。

### @dmalbuquerque/cpf-cnpj-validator 支持 TypeScript 吗？

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

### @dmalbuquerque/cpf-cnpj-validator 支持 ESM 还是 CommonJS？

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

### @dmalbuquerque/cpf-cnpj-validator 可以商用吗？

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

### @dmalbuquerque/cpf-cnpj-validator 的下载量有多少？

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

### @dmalbuquerque/cpf-cnpj-validator 还在维护吗？

最新版本 1\.0\.3 发布于 2025/03/10（1\.7 年前）；至今共发布 4 个版本，其中过去 12 个月发布了 0 个；首次发布于 2025/03/10。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。