知识共享许可协议
本作品采用知识共享署名-非商业性使用 3.0 未本地化版本许可协议进行许可。

Node.js v4.2.4 手册 & 文档


punycode#

稳定度: 2 - 不稳定

Punycode.js 自 Node.js v0.6.2+ 开始被内置,通过 require('punycode') 引入。(要在其它 Node.js 版本中使用它,请先使用 npm 安装 punycode 模块。)

punycode.decode(string)#

将一个纯 ASCII 符号的 Punycode 字符串转换为 Unicode 符号的字符串。

// 解码域名部分
punycode.decode('maana-pta'); // 'mañana'
punycode.decode('--dqo34k'); // '☃-⌘'

punycode.encode(string)#

将一个 Unicode 符号的字符串转换为纯 ASCII 符号的 Punycode 字符串。

// 编码域名部分
punycode.encode('mañana'); // 'maana-pta'
punycode.encode('☃-⌘'); // '--dqo34k'

punycode.toUnicode(domain)#

将一个表示域名的 Punycode 字符串转换为 Unicode。只有域名中的 Punycode 部分会转换,也就是说您在一个已经转换为 Unicode 的字符串上调用它也是没问题的。

// 解码域名
punycode.toUnicode('xn--maana-pta.com'); // 'mañana.com'
punycode.toUnicode('xn----dqo34k.com'); // '☃-⌘.com'

punycode.toASCII(domain)#

将一个表示域名的 Unicode 字符串转换为 Punycode。只有域名的非 ASCII 部分会被转换,也就是说您在一个已经是 ASCII 的域名上调用它也是没问题的。

// 编码域名
punycode.toASCII('mañana.com'); // 'xn--maana-pta.com'
punycode.toASCII('☃-⌘.com'); // 'xn----dqo34k.com'

punycode.ucs2#

punycode.ucs2.decode(string)#

创建一个数组,包含字符串中每个 Unicode 符号的数字编码点。由于 JavaScript 在内部使用 UCS-2, 该函数会按照 UTF-16 将一对代半数(UCS-2 暴露的单独的字符)转换为单独一个编码点。

punycode.ucs2.decode('abc'); // [0x61, 0x62, 0x63]
// surrogate pair for U+1D306 tetragram for centre:
punycode.ucs2.decode('\uD834\uDF06'); // [0x1D306]

punycode.ucs2.encode(codePoints)#

以数字编码点的值的数组创建一个字符串。

punycode.ucs2.encode([0x61, 0x62, 0x63]); // 'abc'
punycode.ucs2.encode([0x1D306]); // '\uD834\uDF06'

punycode.version#

表示当前 Punycode.js 版本号的字符串。