Zero Dependencies
No third-party dependencies, under 2KB minzip — secure with zero supply-chain risk
China ID CardChinese ID Number Validation
Based on GB 11643-1999 · Zero dependencies · TypeScript · 15/18-digit compatible
Skip to content
Strict Validation
ISO 7064:1983 MOD 11-2 weighted check digit + province code + birth date legality
Info Parsing
Parse province, birth date, gender and age in one call — with 15→18 digit upgrade
Masking Built-in
mask() shows first 3 and last 4 digits — ready for privacy-compliant display
TypeScript Native
Full type definitions out of the box, developed in strict mode — API docs via types
Works Everywhere
Ships ES / CJS / UMD builds — runs in Node.js and browsers alike
Up and running in 30 seconds
bash
pnpm add china-id-cardbash
npm install china-id-cardbash
yarn add china-id-cardtypescript
import { isValid, parse, mask } from 'china-id-card';
// Quick validation
isValid('622922197808118498'); // → true
// Parse full info
const info = parse('622922197808118498');
// → { isValid: true, province: '甘肃省', birthDate: '1978-08-11',
// gender: 'male', age: 46, ... }
// Mask sensitive digits
mask('622922197808118498'); // → '622***********8498'Don't want to install anything? Try every feature in your browser on the Playground.