- assert 断言
- async_hooks 异步钩子
- async_hooks/context 异步上下文
- buffer 缓冲区
- C++插件
- C/C++插件(使用Node-API)
- C++嵌入器
- child_process 子进程
- cluster 集群
- CLI 命令行
- console 控制台
- Corepack 核心包
- crypto 加密
- crypto/webcrypto 网络加密
- debugger 调试器
- deprecation 弃用
- dgram 数据报
- diagnostics_channel 诊断通道
- dns 域名服务器
- domain 域
- Error 错误
- events 事件触发器
- fs 文件系统
- global 全局变量
- http 超文本传输协议
- http2 超文本传输协议2.0
- https 安全超文本传输协议
- inspector 检查器
- Intl 国际化
- module 模块
- module/cjs CommonJS模块
- module/esm ECMAScript模块
- module/package 包模块
- net 网络
- os 操作系统
- path 路径
- perf_hooks 性能钩子
- permission 权限
- process 进程
- punycode 域名代码
- querystring 查询字符串
- readline 逐行读取
- repl 交互式解释器
- report 诊断报告
- sea 单个可执行应用程序
- stream 流
- stream/web 网络流
- string_decoder 字符串解码器
- test 测试
- timers 定时器
- tls 安全传输层
- trace_events 跟踪事件
- tty 终端
- url 网址
- util 实用工具
- v8 引擎
- vm 虚拟机
- wasi 网络汇编系统接口
- worker_threads 工作线程
- zlib 压缩
Node.js v18.16.0 文档
- Node.js v18.16.0
- ► 目录
-
►
导航
- assert 断言
- async_hooks 异步钩子
- async_hooks/context 异步上下文
- buffer 缓冲区
- C++插件
- C/C++插件(使用Node-API)
- C++嵌入器
- child_process 子进程
- cluster 集群
- CLI 命令行
- console 控制台
- Corepack 核心包
- crypto 加密
- crypto/webcrypto 网络加密
- debugger 调试器
- deprecation 弃用
- dgram 数据报
- diagnostics_channel 诊断通道
- dns 域名服务器
- domain 域
- Error 错误
- events 事件触发器
- fs 文件系统
- global 全局变量
- http 超文本传输协议
- http2 超文本传输协议2.0
- https 安全超文本传输协议
- inspector 检查器
- Intl 国际化
- module 模块
- module/cjs CommonJS模块
- module/esm ECMAScript模块
- module/package 包模块
- net 网络
- os 操作系统
- path 路径
- perf_hooks 性能钩子
- permission 权限
- process 进程
- punycode 域名代码
- querystring 查询字符串
- readline 逐行读取
- repl 交互式解释器
- report 诊断报告
- sea 单个可执行应用程序
- stream 流
- stream/web 网络流
- string_decoder 字符串解码器
- test 测试
- timers 定时器
- tls 安全传输层
- trace_events 跟踪事件
- tty 终端
- url 网址
- util 实用工具
- v8 引擎
- vm 虚拟机
- wasi 网络汇编系统接口
- worker_threads 工作线程
- zlib 压缩
- ► 其他版本
- 云服务器
目录
国际化支持#
Node.js 有很多特性可以让编写国际化程序变得更容易。 它们之中有一些是:
- ECMAScript 语言规范 中的语言环境敏感或 Unicode 感知函数:
- ECMAScript 国际化 API 规范(又名 ECMA-402)中描述的所有功能:
Intl
对象- 像
String.prototype.localeCompare()
和Date.prototype.toLocaleString()
这样的区域敏感方法
- WHATWG URL 解析器 的 国际化域名 (IDNs) 支持
require('node:buffer').transcode()
- 更准确的 REPL 行编辑
require('node:util').TextDecoder
RegExp
Unicode 属性转义
Node.js 和底层 V8 引擎使用 Unicode 国际组件 (ICU) 在原生 C/C++ 代码中实现这些功能。 默认情况下,Node.js 提供了完整的 ICU 数据集。 但是,由于 ICU 数据文件的大小,在构建或运行 Node.js 时提供了几个用于自定义 ICU 数据集的选项。
构建 Node.js 的选项#
为了控制在 Node.js 中如何使用 ICU,在编译期间提供了四个 configure
选项。 BUILDING.md 中记录了有关如何编译 Node.js 的其他详细信息。
--with-intl=none
/--without-intl
--with-intl=system-icu
--with-intl=small-icu
--with-intl=full-icu
(默认)
每个 configure
选项的可用 Node.js 和 JavaScript 特性概述:
特征 | none | system-icu | small-icu | full-icu |
---|---|---|---|---|
String.prototype.normalize() | 无(函数是空操作) | 满的 | 满的 | 满的 |
String.prototype.to*Case() | 满的 | 满的 | 满的 | 满的 |
Intl | 无(对象不存在) | 部分/全部(取决于操作系统) | 部分(仅限英文) | 满的 |
String.prototype.localeCompare() | 部分(不识别区域设置) | 满的 | 满的 | 满的 |
String.prototype.toLocale*Case() | 部分(不识别区域设置) | 满的 | 满的 | 满的 |
Number.prototype.toLocaleString() | 部分(不识别区域设置) | 部分/全部(取决于操作系统) | 部分(仅限英文) | 满的 |
Date.prototype.toLocale*String() | 部分(不识别区域设置) | 部分/全部(取决于操作系统) | 部分(仅限英文) | 满的 |
旧版 URL 解析器 | 部分(不支持 IDN) | 满的 | 满的 | 满的 |
WHATWG URL 解析器 | 部分(不支持 IDN) | 满的 | 满的 | 满的 |
require('node:buffer').transcode() | 无(函数不存在) | 满的 | 满的 | 满的 |
REPL | 部分(行编辑不准确) | 满的 | 满的 | 满的 |
require('node:util').TextDecoder | 部分(基本编码支持) | 部分/全部(取决于操作系统) | 部分(仅限 Unicode) | 满的 |
RegExp Unicode 属性转义 | 无(无效的 RegExp 错误) | 满的 | 满的 | 满的 |
"(不识别区域设置)" 标志表示该函数执行其操作就像该函数的非 Locale
版本(如果存在)一样。 比如在 none
模式下,Date.prototype.toLocaleString()
的操作和 Date.prototype.toString()
是一样的。
禁用所有国际化功能 (none
)#
如果选择此选项,则 ICU 将被禁用,并且上述大多数国际化特性在生成的 node
二进制文件中将不可用。
使用预装的 ICU (system-icu
) 构建#
Node.js 可以链接到系统上已安装的 ICU。 事实上,大多数 Linux 发行版已经安装了 ICU,这个选项可以复用操作系统中其他组件使用的相同数据集。
system-icu
完全支持仅需要 ICU 库本身的功能,例如 String.prototype.normalize()
和 WHATWG URL 解析器。 另外需要 ICU 区域设置数据的功能,例如 Intl.DateTimeFormat
,可能会得到完全或部分支持,具体取决于安装在系统上的 ICU 数据的完整性。
嵌入一组有限的 ICU 数据 (small-icu
)#
此选项静态地生成针对 ICU 库的二进制链接,并在 node
可执行文件中包含 ICU 数据的子集(通常只有英文区域设置)。
small-icu
完全支持仅需要 ICU 库本身的功能,例如 String.prototype.normalize()
和 WHATWG URL 解析器。 另外需要 ICU 语言环境数据的特性,比如 Intl.DateTimeFormat
,一般只适用于英文语言环境:
const january = new Date(9e8);
const english = new Intl.DateTimeFormat('en', { month: 'long' });
const spanish = new Intl.DateTimeFormat('es', { month: 'long' });
console.log(english.format(january));
// Prints "January"
console.log(spanish.format(january));
// Prints either "M01" or "January" on small-icu, depending on the user’s default locale
// Should print "enero"
此模式提供了特性和二进制大小之间的平衡。
在运行时提供 ICU 数据#
如果使用 small-icu
选项,则仍然可以在运行时提供额外的语言环境数据,以便 JS 方法适用于所有 ICU 语言环境。 假设数据文件存储在 /some/directory
,它可以通过以下任一方式提供给 ICU:
-
NODE_ICU_DATA
环境变量:env NODE_ICU_DATA=/some/directory node
-
--icu-data-dir
命令行参数:node --icu-data-dir=/some/directory
(如果两者都指定,则 --icu-data-dir
命令行参数优先。)
ICU 能够自动查找和加载多种数据格式,但数据必须适合 ICU 版本,并且文件命名正确。
数据文件最常见的名称是 icudt6X[bl].dat
,其中 6X
表示预期的 ICU 版本,而 b
或 l
表示系统的字节序。
查看 ICU 用户指南中的 "ICU Data" 文章,了解其他支持的格式以及有关 ICU 数据的更多详细信息。
full-icu npm 模块可以通过检测正在运行的 node
可执行文件的 ICU 版本并下载适当的数据文件来极大地简化 ICU 数据安装。 通过 npm i full-icu
安装模块后,数据文件将在 ./node_modules/full-icu
可用。 然后可以将此路径传给 NODE_ICU_DATA
或 --icu-data-dir
,如上所示以启用完整的 Intl
支持。
嵌入整个 ICU (full-icu
)#
此选项使生成的二进制链接与 ICU 静态地关联并包含全套 ICU 数据。 以这种方式创建的二进制文件没有进一步的外部依赖项并支持所有语言环境,但可能相当大。 如果没有传入 --with-intl
标志,则这是默认行为。 官方的二进制文件也是以这种模式构建的。
检测国际化支持#
要验证是否启用了 ICU(system-icu
、small-icu
或 full-icu
),只需检查 Intl
是否存在就足够了:
const hasICU = typeof Intl === 'object';
或者,检查 process.versions.icu
,一个仅在启用 ICU 时定义的属性,也可以工作:
const hasICU = typeof process.versions.icu === 'string';
要检查对非英语语言环境(即 full-icu
或 system-icu
)的支持,Intl.DateTimeFormat
可能是一个很好的区分因素:
const hasFullICU = (() => {
try {
const january = new Date(9e8);
const spanish = new Intl.DateTimeFormat('es', { month: 'long' });
return spanish.format(january) === 'enero';
} catch (err) {
return false;
}
})();
有关 Intl
支持的更详细的测试,以下资源可能会有所帮助: