Lehen urratsak

nif-dni-nie-cif-validation liburutegiak Espainiako identifikatzaile fiskalak (IFZ, NAN, K/L/M IFZ, AIZ eta IFK) egiaztatzen ditu arau ofizialen arabera, eta zenbaki bat zergatik ez den baliozkoa esaten dizu. Ez du mendekotasunik, bere TypeScript motak ditu, eta import zein require erabilita funtzionatzen du Node.js 20 edo berriagoan, egungo nabigatzaile guztietan, Deno-n eta Bun-en.

Instalazioa

npm install nif-dni-nie-cif-validation

pnpm add nif-dni-nie-cif-validation

yarn add nif-dni-nie-cif-validation

bun add nif-dni-nie-cif-validation

deno add npm:nif-dni-nie-cif-validation

Terminal batetik edo shell script batetik balioztatzeko, koderik idatzi gabe, exekutatu npx nif-dni-nie-cif-validation validate 12345678Z: Komando-lerroa gidak komando eta aukera guztiak ditu.

Egiaztatu zenbaki bat

isValid… funtzioek bai edo ez erantzuten dute. Edozein balio onartzen dute eta ez dute inoiz salbuespenik jaurtitzen; beraz, erabiltzaileak idatzitakoa pasa diezaiekezu:

import { isValidNif } from "nif-dni-nie-cif-validation";

isValidNif("12345678Z");      // true: NAN bat
isValidNif("X1234567L");      // true: AIZ bat
isValidNif("B12345674");      // true: IFK bat
isValidNif(" 12.345.678-z "); // true: zuriuneak, puntuak, marrak eta minuskulak onartzen dira
isValidNif("12345678A");      // false: kontrol-letra ez da zuzena
isValidNif(null);             // false: ez du inoiz salbuespenik jaurtitzen

CommonJS-ekin, require berdin dabil:

const { isValidNif } = require("nif-dni-nie-cif-validation");

isValidNif("12345678Z"); // true

Aukeratu funtzio egokia

isValidNif funtzioak mota guztiak onartzen ditu. Eremu batek mota batzuk bakarrik onartzen baditu, erabili funtzio zehatzagoa:

Eremuak onartzen du…	Erabili
Edozein IFZ: NAN, K/L/M IFZ, AIZ edo IFK	`isValidNif(value)`
Pertsona fisikoak bakarrik: NAN, K/L/M IFZ edo AIZ	`isValidNaturalPersonNif(value)`
NAN bat (edo K/L/M IFZ bat)	`isValidDni(value)`
AIZ bat	`isValidNie(value)`
Enpresak eta beste erakunde batzuk (IFK)	`isValidCif(value)`
Espainiako IFZ-BEZ bat (`ES` + IFZ, formatua bakarrik)	`isValidSpanishVat(value)`

import { isValidCif, isValidNaturalPersonNif } from "nif-dni-nie-cif-validation";

isValidNaturalPersonNif("X1234567L"); // true
isValidNaturalPersonNif("B12345674"); // false: IFK bat ez da pertsona fisiko bat
isValidCif("P2807900B");              // true: Madrilgo Udala

Ez dakizu ziur zer den dokumentu bakoitza? Ikusi NAN, AIZ, IFZ eta IFK.

Jakin zergatik, eta gorde forma kanonikoa

validate() funtzioak mota, gorde behar den forma kanonikoa eta, balioa baliozkoa ez bada, errore bat itzultzen du: kode bat, betetzen ez den SPEC.md araua, mezu bat eta espero zen kontrol-karakterea:

import { validate } from "nif-dni-nie-cif-validation";

validate(" 12.345.678-z ");
// { valid: true, type: "DNI", normalized: "12345678Z" }

validate("12345678A").error;
// { code: "INVALID_CONTROL_CHARACTER", rule: "DNI-2", expected: "Z",
//   message: 'The control character is not correct: for this DNI it should be "Z".' }

Gorde normalized, ez erabiltzaileak idatzitakoa: maiuskulaz dago, bereizlerik gabe, eta berdina da dokumentu bera idazteko modu guztietarako.

Erakutsi mezua erabiltzailearen hizkuntzan

Mezuak ingelesez daude lehenespenez. Gaztelania, katalana, euskara eta galegoa bereiz inportatzen dira; beraz, zure bundleak erabiltzen dituzun hizkuntzak bakarrik ditu:

import { validate } from "nif-dni-nie-cif-validation";
import { es } from "nif-dni-nie-cif-validation/locales/es";

validate("12345678A", { locale: es }).error?.message;
// "El carácter de control no es correcto: para este DNI debería ser «Z»."

Hurrengo urratsak

Inprimakiak egiaztatzeaZod, Valibot, Yup, React Hook Form eta zerbitzariko egiaztapena.

Errore-kodeak eta mezuakErrore-kode guztiak, bakoitzak aipatzen duen araua eta hizkuntza nola aukeratu.

Proba-datuak sortzeaZenbaki baliozkoak eta baliogabeak zure probetarako, berdinak exekuzio bakoitzean.

APIaren erreferentziaEsportazio guztiak, beren aukera eta adibideekin.