@exodus/stdnum

中文文档
1.6.0发布于 2026/10/30MITTypeScriptES Module近 30 天下载 5243

用于验证和格式化标准编号的库.

中文使用文档
文档目录8 节
  1. 安装
  2. 使用量
  3. 获取文档类型
  4. 紧凑
  5. 是瓦利德语
  6. 支助国
  7. 文件类型
  8. 许可证

@ exodus/stdnum (英语)

70多个国家的税务身份证、国家身份证号码和护照的验证和识别图书馆.

建于顶上 积分,同时为KYC和支付平台集成定制了额外的验证器和定制.

安装

pnpm add @exodus/stdnum

使用量

获取文档类型

返回有效识别号码的文档类型缩写。 当多种格式被接受时,用于确定提供了哪种类型的ID.

import { getDocumentType } from '@exodus/stdnum'

getDocumentType('US', '123-45-6789') // 'ssn'
getDocumentType('AR', '20-05536168-2') // 'cuil'
getDocumentType('AR', '12345678') // 'dni'
getDocumentType('AU', 'M1234567') // 'passport'
getDocumentType('US', 'invalid') // undefined

紧凑

返回有效身份号码的规范形式,删除分隔符和国家前缀。 使用与 getDocumentType。 。 。 .

import { compact } from '@exodus/stdnum'

compact('US', '123-45-6789') // '123456789'
compact('GR', 'EL094259216') // '094259216'
compact('SE', '19121212-1212') // '121212+1212'
compact('US', 'invalid') // undefined

是瓦利德语

简单的布尔检查某个特定国家的身份号码是否有效 .

import { isValid } from '@exodus/stdnum'

isValid('US', '123-45-6789') // true
isValid('US', 'invalid') // false

支助国

国家代码文档类型
阿尔巴尼亚尔尼日尔
安道尔反倾销NRT (英语)
联合国农村CBU、DNI、CUIL、护照
亚美尼亚上午TIN,护照
澳大利亚非盟TFN、ABN、ACN、护照
奥地利AT 时TIN、VSNR、UID、新生力量
白俄罗斯截止联合国
比利时变成NRRN、增值税、护照
伯利兹边界小叮当
波斯尼亚和黑塞哥维那学士日本
联合国布鲁CPF、CNPJ、护照
保加利亚英国政府UCN、PNF、增值税、护照
加拿大加利福尼亚SIN、BC BHN、GST、PST、QST、护照
邮件地址中线运行
中国氯化萘RICN、USCC、护照
哥伦比亚国家办事处国家IT
哥斯达黎加捷克CPJ、捷克共和国
克罗地亚人力资源投资银行
塞浦路斯塞浦路斯增值税
捷克共和国坐标RC、DIC、护照
丹麦丹麦预防危机和复原中心
厄瓜多尔欧共体中央情报局、皇家警察
埃及英格兰TN 主题
萨尔瓦多特别志愿人员国家IT
爱沙尼亚英 欧IK、KMKR、护照
法罗群岛视野文选
芬兰索引HETU, ALV, 护照
法国法语SPI、国家清单报告、SIREN、SIRET、增值税、护照
德国D级身份证、护照、PWNR、STNR、SVNR、增值税
加纳伽马小叮当
希腊一般事务人员AMKA,增值税
危地马拉一般事务人员团结国际,国家信息技术
几内亚地名NIFP (荷兰语)
匈牙利汉字小叮当,安努姆
冰岛页:1肯尼塔拉,VSK
印度内PAN、Aadhar、EPIC、GSTIN、VID、护照
爱尔兰独立PPSN、增值税、护照
以色列伊尔HP, 身份证
意大利信息技术Codice Finance、AIC、增值税、护照
日本日记我的号码,CN,护照
肯尼亚韩克宾语
拉脱维亚萨尔瓦多增值税
列支敦士登李丽PEID 密码
立陶宛页:1阿斯门斯,PVM
卢森堡卢TIN增值税
马耳他数量TIN增值税
毛里求斯货币国家开发研究所
墨西哥MX 组合CURP, RFC, 克莱贝
摩尔多瓦货币萨尔瓦多
摩纳哥军委会增值税
荷兰无BSN、增值税、护照
新西兰新西兰IRD,护照
挪威无增值税,Orgnr
巴拉圭PY 时国家身份证,皇家警察
秘鲁诗人CUI、CE、皇家警察
菲律宾菲律宾TIN,护照
波兰临 时PESEL、增值税、护照
葡萄牙常规NIF、CC、护照
罗马尼亚罗CNP、增值税、护照
俄罗斯卢比INN,护照
沙特阿拉伯南非小叮当
塞尔维亚塞尔维亚日本
斯洛伐克苏格兰驻地协调员增值税
斯洛文尼亚高级增值税,EMSO,TIN
韩国库尔德语NAMERRN、BRN、护照
页:1欧语NIE、NIF、NSS、护照
瑞典性别TIN、增值税、护照
瑞士陈AHV、UID、增值税、护照
泰国TH 电话TIN,护照
突尼斯TN 主题货币
阿拉伯联合酋长国阿英阿联酋身份证
联合王国GB 语句NINO、UTR、增值税、护照
美国美国(原始内容存档于2018-09-26) (英语). SSN, ITIN
乌拉圭大学CI、增值税、NIE

文件类型

缩略语全名
aadhaar印度独有的识别号码
abn澳大利亚商号
acn澳大利亚公司编号
ahv瑞士社会保障号码
aic意大利药品法
alv芬兰增值税
amka希腊社会保障号码
anum匈牙利增值税
asmens立陶宛个人法典
bc_bhn不列颠哥伦比亚省出生保健人数
brn韩国企业注册号
bsn荷兰公民服务号码
cbu阿根廷银行帐号
cc葡萄牙公民卡
ce秘鲁外国人卡
ci身份证(厄瓜多尔/乌拉圭)
clabe墨西哥银行帐号
cn日本公司编号
cnp罗马尼亚个人编号
cnpj巴西公司纳税人登记处
cf意大利财政法
cpf巴西/哥斯达黎加个人纳税人身份证
cpj哥斯达黎加法律实体ID
cpr丹麦个人身份证号码
cr哥斯达黎加身份证
cui个人身份证(危地马拉/秘鲁)
cuil阿根廷劳动识别法
curp墨西哥人口登记法
cvr丹麦工商登记号
dic捷克增值税
dni阿根廷国民身份证件
emirates_id阿联酋
emso斯洛文尼亚独有的公民总号码
epic印度选民身份证
fn奥地利公司注册号
fodselsnummer挪威出生人数
gst加拿大货物和服务税号
gstin印度GST识别号码
hetu芬兰个人身份代码
hp以色列公司编号
idno摩尔多瓦公司身份证
idnr以色列身份证号码
ik爱沙尼亚个人身份识别法
inn俄罗斯纳税人识别号码
ird新西兰内陆收入
itin美国个人纳税人识别号码
jmbg独有的公民总号码(波斯尼亚/塞尔维亚)
kennitala冰岛个人/公司身份证
kmkr爱沙尼亚增值税
mf突尼斯税务身份证
mn日本我的号码
national_id巴拉圭国民身份证
nid毛里求斯国家身份证
nie外国身份号码(西班牙/乌拉圭)
nif税务识别号码(西班牙/葡萄牙)
nifp几内亚税务ID
nino联合王国国家保险号码
nipt阿尔巴尼亚商业税号
nir法国社会保障号码
nit税务编号(哥伦比亚/危地马拉/萨尔瓦多)
nrrn比利时国家登记号
nrt安道尔税号
nss西班牙社会保障号码
oib克罗地亚个人身份证号码
orgnr挪威组织
pan印度常设账户数目
passport护照号码
peid列支敦士登公司ID
pesel波兰国民身份证号码
pin肯尼亚个人身份证号码
pnf保加利亚外国人个人号码
ppsn爱尔兰个人公共服务号码
pst加拿大省销售税号
pvm立陶宛增值税
pwnr德国护照号码
qst魁北克销售税号
rc出生人数(捷克/斯洛伐克)
rfc墨西哥联邦纳税人登记处
ricn中国居民身份证号码
rrn韩国居民登记号码
ruc纳税人登记册(厄瓜多尔/巴拉圭/秘鲁)
run智利国家身份证号码
sin加拿大社会保险号码
siren法国公司注册号
siret法国机构识别号码
spi法国税务识别号码
ssn美国社会保障号码
steuer_id德国税务识别编号
stnr德国税号
svnr德国社会保险号码
tfn澳大利亚税务文件编号
tin税务识别号码(通用)
tn埃及税号
ucn保加利亚统一公民编号
uid瑞士商业身份证,奥地利增值税号码
unp白俄罗斯纳税人人数
uscc中国统一社会信用代码
utr联合王国唯一纳税人
vat增值税号
vid印度虚拟标识
vn法罗群岛V-数量
vsk冰岛增值税
vsnr奥地利社会保障号码

许可证

麻省理工学院

版本与发布记录

@exodus/stdnum 共发布 9 个版本,首次发布于 2026/02/02;过去 12 个月发布了 9 个版本。

版本发布日期距今
1.6.0latest2026/10/3014 天前
1.5.12026/10/2717 天前
1.5.02026/10/2717 天前
1.4.12026/10/141 个月前
1.4.02026/07/024 个月前
1.3.12026/02/138 个月前

关于 @exodus/stdnum 的常见问题

@exodus/stdnum 是什么?

用于验证和格式化标准编号的库.

如何安装 @exodus/stdnum?

在项目目录运行 npm install @exodus/stdnum,或使用 pnpm add / yarn add / bun add。

@exodus/stdnum 支持 TypeScript 吗?

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

@exodus/stdnum 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@exodus/stdnum 可以商用吗?

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

@exodus/stdnum 的下载量有多少?

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

@exodus/stdnum 还在维护吗?

最新版本 1.6.0 发布于 2026/10/30(14 天前);至今共发布 9 个版本,其中过去 12 个月发布了 9 个;首次发布于 2026/02/02。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。