tr46

中文文档
7.0.0发布于 2026/10/04MITCommonJS构建来源已验证近 30 天下载 9.2亿

Unicode uts46的实现:Unicode IDNA兼容性处理

中文使用文档
文档目录11 节
  1. API
  2. toASCII(domainName[, options])
  3. toUnicode(domainName[, options])
  4. 选项
  5. checkBidi
  6. checkHyphens
  7. checkJoiners
  8. ignoreInvalidPunycode
  9. transitionalProcessing
  10. useSTD3ASCIIRules
  11. verifyDNSLength

tr46

的JavaScript实现 Unicode技术标准#46:Unicode IDNA兼容性处理。

API

toASCII(domainName[, options])

将Unicode符号字符串转换为大小写折叠的ASCII符号Punycode字符串。

可用的选项:

toUnicode(domainName[, options])

将由ASCII符号组成的大小写折叠的Punycode字符串转换为由Unicode符号组成的字符串。

可用的选项:

选项

checkBidi

类型: boolean 默认值: false 当设置为 true,将检查输入中的任何双向文本以进行验证。

checkHyphens

类型: boolean 默认值: false 当设置为 true,将检查输入中任何连字符的位置以进行验证。

checkJoiners

类型: boolean 默认值: false 当设置为 true,将检查输入中的任何单词连接字符以进行验证。

ignoreInvalidPunycode

类型: boolean 默认值: false 当设置为 true,则允许输入中存在无效的Punycode字符串。

transitionalProcessing

类型: boolean 默认值: false 当设置为 true,使用 过渡(兼容性)处理 偏差字符的。

useSTD3ASCIIRules

类型: boolean 默认值: false 当设置为 true,输入将根据 STD3规则。

verifyDNSLength

类型: boolean 默认值: false 当设置为 true,将检查输入中的每个DNS标签的长度以进行验证。

版本与发布记录

tr46 共发布 18 个版本,首次发布于 2015/06/06;过去 12 个月发布了 1 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
7.0.0latest2026/10/041 个月前
6.0.02025/09/181.1 年前
5.1.12025/04/171.6 年前
5.1.02025/03/151.6 年前
5.0.02023/11/053 年前
4.1.12023/03/083 年前

关于 tr46 的常见问题

tr46 是什么?

Unicode uts46的实现:Unicode IDNA兼容性处理

如何安装 tr46?

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

tr46 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/tr46 是否存在。

tr46 支持 ESM 还是 CommonJS?

以 CommonJS 形式发布,可以直接 require();在 ES Module 项目中也可以用 import 引入(Node.js 会把 module.exports 作为默认导出)。

tr46 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js ^22.14.0 || >=24.0.0。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

tr46 可以商用吗?

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

tr46 的下载量有多少?

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

tr46 还在维护吗?

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