Pular para o conteúdo principal

Validador-BR-Dokumentation

Validieren Sie brasilianische Dokumente ganz einfach. Hervorragend geeignet für Software-QS-Tests.

Erfahren Sie, wie Sie die Bibliothek zur Validierung von CPFs, CNPJs, CNHs, PIS und mehr verwenden.

NPM VersionNPM Downloads

Erste Schritte

Um

@box4dev/validador-br

Eine leichte und robuste Bibliothek zur Validierung brasilianischer Dokumente.

Die Bibliothek ist bestrebt, sicherzustellen, dass die Dokumente den von den Institutionen vorgeschriebenen mathematischen Berechnungen und Prüfziffernberechnungen entsprechen.

Installation

Um das Paket in Ihrem Projekt zu installieren, führen Sie einen der folgenden Befehle aus:

NPM

Shell
1
npm install @box4dev/validador-br

Yarn

Shell
1
yarn add @box4dev/validador-br

PNPM

Shell
1
pnpm add @box4dev/validador-br

Import

Benannte Exporte (empfohlen)

Verwenden Sie benannte Funktionen, um nur das zu importieren, was Sie benötigen.

JS
1
2
3
import { isValidCpf, isValidCnpj } from '@box4dev/validador-br';
console.log(isValidCpf('123.456.789-09')); // true ou false
console.log(isValidCnpj('GY.HU8.PG2/971E-10')); // true ou false

Objekt validieren (zentralisiert)

Oder verwenden Sie das „validate“-Objekt, das alle Validatoren zentralisiert.

JS
1
2
3
import { validate } from '@box4dev/validador-br';
console.log(validate.cpf('123.456.789-09')); // true ou false
console.log(validate.cnpj('12.345.678/0001-95')); // true ou false

CommonJS (erforderlich)

JS
1
2
3
const { isValidCpf, isValidCnpj, validate } = require('@box4dev/validador-br');
console.log(isValidCpf('12345678909')); // true ou false
console.log(validate.cnpj('GYHU8PG2971E10')); // true ou false

Validatoren

CPF

Validiert das Format und die Prüfziffern des CPF (Modul 11).

JS
1
2
3
import { isValidCpf } from '@box4dev/validador-br';
console.log(isValidCpf('741.535.041-30')); // true ou false
console.log(isValidCpf('43241612163')); // true ou false

CNPJ / Alphanumerisches CNPJ

Validiert CNPJs im alten Standard (nur Zahlen) und im neuen alphanumerischen Standard.

JS
1
2
3
4
5
import { isValidCnpj } from '@box4dev/validador-br';
console.log(isValidCnpj('GY.HU8.PG2/971E-10')); // true ou false
console.log(isValidCnpj('12.345.678/0001-95')); // true ou false
console.log(isValidCnpj('AYWO9JCVCHFB47')); // true ou false
console.log(isValidCnpj('47434563000151')); // true ou false

CNH

Validiert den nationalen Führerschein mithilfe des offiziellen Algorithmus.

JS
1
2
import { isValidCnh } from '@box4dev/validador-br';
console.log(isValidCnh('12345678901')); // true ou false

PIS / PASEP / NIT

Validiert die Arbeiter-Identifikationsnummer (PIS/PASEP/NIT).

JS
1
2
3
import { isValidPis } from '@box4dev/validador-br';
console.log(isValidPis('589.21704.72.2')); // true ou false
console.log(isValidPis('07987894517')); // true ou false

ZNS

Validiert vorläufige ZNS-Nummern (beginnend mit 7, 8, 9) und endgültige (1, 2).

JS
1
2
3
import { isValidCns } from '@box4dev/validador-br';
console.log(isValidCns('252 9608 1932 0002')); // true ou false
console.log(isValidCns('146471200460007')); // true ou false

Wählerausweis

Validiert die Wähler-ID durch Überprüfung der Ziffern und des Staatscodes.

JS
1
2
3
import { isValidTituloEleitor } from '@box4dev/validador-br';
console.log(isValidTituloEleitor('4113 4513 0930')); // true ou false
console.log(isValidTituloEleitor('428779582410')); // true ou false

Zertifikat

Validiert die 32-stellige Registrierungsnummer von Zertifikaten (Geburt, Heirat, Tod).

JS
1
2
3
import { isValidCertidao } from '@box4dev/validador-br';
console.log(isValidCertidao('106836 11 1926 1001 1 88626 162 6561443')); // true ou false
console.log(isValidCertidao('81007223197120011105781766173474')); // true ou false

Staatliche Registrierung

Validiert spezifische staatliche Registrierungen für jeden Staat (UF). Erfordert die Landesabkürzung.

JS
1
2
3
4
5
import { isValidIE } from '@box4dev/validador-br';
// valor da IE e UF
// biome-ignore lint/nursery/noDuplicateObjectKeys: false positive
console.log(isValidIE('7122026812064', 'SP')); // true ou false
console.log(isValidIE('01.004.823/001-12', 'AC')); // true ou false

Kreditkarte

Validiert Karten (Visa, Mastercard, Amex usw.) mithilfe des Luhn-Algorithmus.

JS
1
2
3
import { isValidCartaoCredito } from '@box4dev/validador-br';
console.log(isValidCartaoCredito('4389 3536 3524 6297')); // true ou false
console.log(isValidCartaoCredito('4389351453183261')); // true ou false

Häufig gestellte Fragen