Errendimendua

Zenbateraino den azkarra eta txikia liburutegi hau, bere aurreko bertsio nagusiaren eta Espainiako identifikatzaileak egiaztatzen dituzten npm-ko beste liburutegien ondoan. Orri honetako zenbaki guztiak bench/results/latest.json fitxategitik irakurtzen dira gunea sortzean: ez da ezer eskuz idazten. Liburutegi bat zerbaitetan azkarragoa edo txikiagoa bada, taulek erakutsi egiten dute.

Non eta nola exekutatu zen errendimendu-proba

Makina	AMD EPYC 9V74 80-Core Processor
Nukleoak	4
Memoria	16 GiB
Sistema eragilea	linux 6.17.0-1022-azure (x64)
Node.js	v24.21.0
Data	2026-10-02
Neurtutako commita	1166241
Metodoa	3 txanda; zeregin bakoitza 2.000 ms, 500 ms-ko berotzearen ondoren, bere prozesuan; zenbakia txanda medianarena da

Zenbaki absolutuak makinaren araberakoak dira. Exekuzio bereko liburutegien arteko proportzioak askoz hobeto mantentzen dira makina batetik bestera; beraz, konparatu horiek.

Abiadura

Segundoko egiaztapen kopurua, milioitan (M ops/s; zenbat eta gehiago, orduan eta azkarragoa), liburutegi bakoitzari bere dokumentazioak dioen bezala deituta, bere aukera lehenetsiekin, forma kanonikoko dokumentu baliozko eta baliogabe berberen gainean. «Errendimendu erlatiboa» zutabeak konpilazio honen errendimenduaren eta liburutegi bakoitzarenaren arteko proportzioa adierazten du, exekuzio berean. ez da onartzen adierazpenak esan nahi du liburutegiak ez duela mota horretarako egiaztatzailerik.

NAN

NAN: segundoko egiaztapen kopurua, milioitan (M ops/s; zenbat eta gehiago, orduan eta azkarragoa), forma kanonikoko 225 dokumentu baliozko eta baliogaberekin, eta konpilazio honen errendimenduaren eta liburutegi bakoitzarenaren arteko proportzioa

Liburutegia	M ops/s	Errendimendu erlatiboa
nif-dni-nie-cif-validation konpilazio hau	60,12	—
@maistik/validate-nif 2.0.1	9,46	errendimenduaren 6,4 halakoa
dni-js 1.0.0	8,90	errendimenduaren 6,8 halakoa
nif-dni-nie-cif-validation 1.0.11	8,59	errendimenduaren 7,0 halakoa
better-dni 4.4.2	8,44	errendimenduaren 7,1 halakoa
spain-id 1.1.14	6,96	errendimenduaren 8,6 halakoa
validator.js isIdentityCard(x, "ES") 13.15.35	5,73	errendimenduaren 10,5 halakoa
validator.js isTaxID(x, "es-ES") 13.15.35	4,22	errendimenduaren 14,3 halakoa
@kreyo/nif-validator 0.1.0	2,78	errendimenduaren 21,6 halakoa
jsvat 2.5.4	2,10	errendimenduaren 28,6 halakoa
stdnum 1.12.6	0,41	errendimenduaren 146,3 halakoa

Beste liburutegi bat ere ez zen azkarragoa izan NAN multzoan.

AIZ

AIZ: segundoko egiaztapen kopurua, milioitan (M ops/s; zenbat eta gehiago, orduan eta azkarragoa), forma kanonikoko 150 dokumentu baliozko eta baliogaberekin, eta konpilazio honen errendimenduaren eta liburutegi bakoitzarenaren arteko proportzioa

Liburutegia	M ops/s	Errendimendu erlatiboa
nif-dni-nie-cif-validation konpilazio hau	57,60	—
@maistik/validate-nif 2.0.1	8,39	errendimenduaren 6,9 halakoa
better-dni 4.4.2	8,17	errendimenduaren 7,1 halakoa
nif-dni-nie-cif-validation 1.0.11	6,44	errendimenduaren 9,0 halakoa
dni-js 1.0.0	4,49	errendimenduaren 12,8 halakoa
spain-id 1.1.14	4,01	errendimenduaren 14,4 halakoa
validator.js isTaxID(x, "es-ES") 13.15.35	3,42	errendimenduaren 16,8 halakoa
validator.js isIdentityCard(x, "ES") 13.15.35	3,14	errendimenduaren 18,4 halakoa
@kreyo/nif-validator 0.1.0	2,65	errendimenduaren 21,7 halakoa
jsvat 2.5.4	1,59	errendimenduaren 36,2 halakoa
stdnum 1.12.6	0,39	errendimenduaren 146,0 halakoa

Beste liburutegi bat ere ez zen azkarragoa izan AIZ multzoan.

IFK

IFK: segundoko egiaztapen kopurua, milioitan (M ops/s; zenbat eta gehiago, orduan eta azkarragoa), forma kanonikoko 270 dokumentu baliozko eta baliogaberekin, eta konpilazio honen errendimenduaren eta liburutegi bakoitzarenaren arteko proportzioa

Liburutegia	M ops/s	Errendimendu erlatiboa
nif-dni-nie-cif-validation konpilazio hau	55,06	—
@maistik/validate-nif 2.0.1	7,74	errendimenduaren 7,1 halakoa
nif-dni-nie-cif-validation 1.0.11	7,27	errendimenduaren 7,6 halakoa
spain-id 1.1.14	4,50	errendimenduaren 12,2 halakoa
@kreyo/nif-validator 0.1.0	2,50	errendimenduaren 22,0 halakoa
jsvat 2.5.4	2,37	errendimenduaren 23,2 halakoa
stdnum 1.12.6	0,38	errendimenduaren 146,7 halakoa
better-dni 4.4.2	ez da onartzen	ez da onartzen
dni-js 1.0.0	ez da onartzen	ez da onartzen
validator.js isIdentityCard(x, "ES") 13.15.35	ez da onartzen	ez da onartzen
validator.js isTaxID(x, "es-ES") 13.15.35	ez da onartzen	ez da onartzen

Beste liburutegi bat ere ez zen azkarragoa izan IFK multzoan.

Abiadura ez da dena, eta zenbaki hauek gauza batzuk uzten dituzte kanpoan: memoria, JITa berotu aurreko lehen deia, normalizazioa behar duen sarrera eta validate() funtzioaren emaitza xehatuaren kostua. Kate bat goiz baztertzen duen liburutegi bat azkarra da kate horrekin, eta horregatik neurtzen da SPEC.md fitxategiarekiko adostasuna bereiz, behean.

Bundlearen tamaina

Egiaztatzaile batek bundle bati gehitzen diona, minifikatuta eta gzip bidez konprimatuta (min+gzip; zenbat eta gutxiago, orduan eta txikiagoa), esbuild bidez paketatuta, liburutegiaren beraren tamaina-egiaztapenak egiten duen bezala. Besteak baino askoz handiagoa den liburutegi baten barra osorik marrazten da, amaiera moztuta.

Edozein motatako egiaztatzaile baten tamaina (min+gzip; zenbat eta gutxiago, orduan eta txikiagoa)

Liburutegia	Edozein mota
@maistik/validate-nif 2.0.1	456 B
@kreyo/nif-validator 0.1.0	533 B
spain-id 1.1.14	583 B
dni-js 1.0.0	882 B
nif-dni-nie-cif-validation konpilazio hau	929 B
better-dni 4.4.2	1.134 B
jsvat 2.5.4	1.186 B
nif-dni-nie-cif-validation 1.0.11	1.517 B
validator.js isIdentityCard(x, "ES") 13.15.35	2.539 B
validator.js isTaxID(x, "es-ES") 13.15.35	6.537 B
stdnum 1.12.6	51.063 B

Konpilazio hau baino txikiagoak edozein motatako egiaztatzaile baterako: @maistik/validate-nif 2.0.1 (456 B), @kreyo/nif-validator 0.1.0 (533 B), spain-id 1.1.14 (583 B) eta dni-js 1.0.0 (882 B). Hau ere neurtu da: stdnum 1.12.6, Espainiako IFZaren modulua zuzenean inportatuta (dokumentatu gabea), 2.468 B.

Liburutegi txikiago batzuek mota gutxiago egiaztatzen dituzte. Honek sarrera normalizatzeko, CIF-3 arauko kontrol motetarako eta K/L/M IFZetarako erabiltzen ditu byteak. CommonJS gisa bakarrik argitaratutako liburutegiek ez dute tree shaking onartzen; beraz, haien funtzio batek liburutegi osoa kostatzen du. Herrialde askotako edo helburu orokorreko liburutegiak, stdnum eta validator.js adibidez, handiagoak dira diseinuz.

Mota bakoitzeko egiaztatzaile baten eta liburutegi osoaren tamaina (min+gzip; zenbat eta gutxiago, orduan eta txikiagoa)

Liburutegia	NAN	AIZ	IFK	Edozein mota	Liburutegi osoa
@maistik/validate-nif 2.0.1	215 B	243 B	319 B	456 B	1.189 B
@kreyo/nif-validator 0.1.0	533 B	533 B	533 B	533 B	746 B
spain-id 1.1.14	165 B	237 B	363 B	583 B	704 B
dni-js 1.0.0	883 B	882 B	ez da onartzen	882 B	880 B
nif-dni-nie-cif-validation konpilazio hau	623 B	586 B	568 B	929 B	4.679 B
better-dni 4.4.2	1.135 B	1.135 B	ez da onartzen	1.134 B	1.132 B
jsvat 2.5.4	1.186 B	1.186 B	1.186 B	1.186 B	5.266 B
nif-dni-nie-cif-validation 1.0.11	1.517 B	1.517 B	1.518 B	1.517 B	1.514 B
validator.js isIdentityCard(x, "ES") 13.15.35	2.539 B	2.539 B	ez da onartzen	2.539 B	44.449 B
validator.js isTaxID(x, "es-ES") 13.15.35	6.537 B	6.537 B	ez da onartzen	6.537 B	44.449 B
stdnum 1.12.6	51.063 B	51.063 B	51.063 B	51.063 B	51.054 B

SPEC.md fitxategiarekiko adostasuna

Liburutegiaren proba-kasuetatik (aukera lehenetsiak) liburutegi bakoitzak SPEC.md fitxategiak bezala epaitzen dituen kasuen ehunekoa: baliozkoak edo baliogabeak.

SPEC.md fitxategiarekiko adostasuna, ez zuzentasuna

Liburutegi honen mantentzaileek idatzi zituzten bai SPEC.md bai proba-kasuak; beraz, eraikuntzaz dator bat haiekin. Zerbait esaten duen zenbakia beste liburutegi bakoitzarena da, eta, hala ere, desadostasun bat aukera zilegi bat izan daiteke: asko SPEC.md fitxategiak dokumentatzen dituen erabakiak dira, adibidez AIZaren forma zaharra onartzea edo CIF-3 arauko kontrol motak. «Sarrera kanonikoa bakarrik» zutabeak normalizazioa behar duten kasuak kanpoan uzten ditu; beraz, han ez da zigortzen normalizatzen ez duen liburutegi bat.

SPEC.md fitxategiarekiko adostasuna (ez zuzentasun absolutua): liburutegi bakoitzak SPEC.md fitxategiak bezala epaitzen dituen kasuen ehunekoa, kasu guztietan eta sarrera kanonikoan bakarrik

Liburutegia	Kasu guztiak	Sarrera kanonikoa bakarrik
nif-dni-nie-cif-validation konpilazio hau	% 100,0	% 100,0
nif-dni-nie-cif-validation 1.0.11	% 84,0	% 92,2
spain-id 1.1.14	% 82,4	% 85,4
better-dni 4.4.2	% 71,9	% 86,7
dni-js 1.0.0	% 73,4	% 86,7
stdnum 1.12.6	% 76,8	% 77,7
validator.js isIdentityCard(x, "ES") 13.15.35	% 75,0	% 86,7
validator.js isTaxID(x, "es-ES") 13.15.35	% 84,4	% 100,0
@maistik/validate-nif 2.0.1	% 82,4	% 86,4
@kreyo/nif-validator 0.1.0	% 82,4	% 86,4
jsvat 2.5.4	% 86,4	% 89,3

SPEC.md fitxategiarekiko adostasuna dokumentu motaren arabera, eta SPEC.md fitxategiak dokumentatzen dituen erabakiek eragindako desadostasunak

Liburutegia	NAN	AIZ	IFK	K/L/M	Desadostasunak	Erabaki dokumentatu baten ondorioz
nif-dni-nie-cif-validation konpilazio hau	% 100,0	% 100,0	% 100,0	% 100,0	0	0
nif-dni-nie-cif-validation 1.0.11	% 73,3	% 88,9	% 83,6	% 100,0	20	13
spain-id 1.1.14	% 90,0	% 77,8	% 86,9	% 36,4	22	13
better-dni 4.4.2	% 73,3	% 77,8	ez da onartzen	% 45,5	18	7
dni-js 1.0.0	% 76,7	% 77,8	ez da onartzen	% 45,5	17	7
stdnum 1.12.6	% 90,0	% 83,3	% 63,9	% 100,0	29	29
validator.js isIdentityCard(x, "ES") 13.15.35	% 80,0	% 77,8	ez da onartzen	% 45,5	16	6
validator.js isTaxID(x, "es-ES") 13.15.35	% 80,0	% 77,8	ez da onartzen	% 100,0	10	5
@maistik/validate-nif 2.0.1	% 86,7	% 77,8	% 86,9	% 45,5	22	14
@kreyo/nif-validator 0.1.0	% 86,7	% 77,8	% 86,9	% 45,5	22	14
jsvat 2.5.4	% 90,0	% 83,3	% 82,0	% 100,0	17	17

Liburutegi batek egiaztatzen ez duen mota bat haren zenbakietatik kanpo geratzen da; beraz, irismen desberdineko liburutegien artean, konparatu zutabeak, eta ez «Kasu guztiak». Liburutegi bakoitzaren desadostasunen zerrenda, bakoitzaren adibide batekin, latest.md fitxategian dago (ingelesez).

Metodoa

• Sarrerak. Hazidun sorgailu sasi-ausazko batekin sortzen dira; beraz, exekuzio eta makina guztiek kate berberak neurtzen dituzte: dokumentu baliozkoak eta dokumentu berak kontrol-karaktere okerrarekin, mota bakoitzerako.
• Deiak. Liburutegi bakoitzari bere dokumentazioak dioen bezala deitzen zaio, bere aukera lehenetsiekin, prozesatu gabeko sarrera-katearen gainean. Salbuespen bakarra jsvat da, IFZ-BEZ egiaztatzaile bat: haren sarrerei ES aurrizkia gehitzen zaie, neurtutako begiztatik kanpo.
• Neurketa. tinybench tresnak zeregin bakoitza bere prozesuan exekutatzen du, berotze baten ondoren, V8k liburutegi batetik ikasten duenak hurrengoaren zenbakia alda ez dezan. Exekuzio osoa hainbat txandatan errepikatzen da, liburutegien ordena multzoen eta txanden artean aldatzen da, eta zenbaki bakoitza bere txanda medianarena da.
• Tamaina. Liburutegi bakoitzak dokumentatzen duen funtzio bakarreko inportazioa, esbuild bidez paketatua eta minifikatua eta gzip bidez 9. mailan konprimatua, inportazio huts baten kostua kenduta.
• Adostasuna. Liburutegi bakoitzaren «edozein mota» deia, aukera lehenetsiak probatzen dituzten kasuen gainean, kasu bakoitza baliozko edo baliogabe gisa epaituta.

Metodologia osoa, haren oharrak eta emaitzen eskema bench/README.md fitxategian daude (ingelesez).

Exekutatu zuk zeuk

Liburutegiak bertsio zehatzetan instalatzen dira; beraz, exekuzio batek latest.json fitxategiak jasotzen duena neurtzen du, hain zuzen. Itxi aurretik beste programak, eta konparatu proportzioak, ez zenbaki absolutuak:

git clone https://github.com/josegoval/nif-dni-nie-cif-validation.git
cd nif-dni-nie-cif-validation
pnpm install --frozen-lockfile
pnpm bench:competitors   # 5 minutu inguru; bench/results/latest.json eta latest.md idazten ditu

pnpm bench komandoak, berriz, egiaztatzaile bakoitza 1. bertsioarekin konparatzen du. GitHub Actions lan-fluxu batek errendimendu-proba bera exekutatzen du eskatuta, runner partekatu batean, eta emaitzak igotzen ditu.