punycode

Stability: 2 - Stable

Punycode.js在io.js v1.0.0+ 和 Node.js v0.6.2+ 中被內(nèi)置。通過require('punycode')來獲取它（若要在其他版本的io.js中使用它，需要先通過 npm 來安裝punycode模塊）。

punycode.decode(string)

轉(zhuǎn)換一個(gè)純 ASCII 符號(hào) Punycode字符串為一個(gè)Unicode符號(hào)的字符串。

// decode domain name parts
punycode.decode('maana-pta'); // 'ma?ana'
punycode.decode('--dqo34k'); // '?-?'

punycode.encode(string)

轉(zhuǎn)換一個(gè)Unicode符號(hào)的字符串為一個(gè)純 ASCII 符號(hào) Punycode字符串。

// encode domain name parts
punycode.encode('ma?ana'); // 'maana-pta'
punycode.encode('?-?'); // '--dqo34k'

punycode.toUnicode(domain)

轉(zhuǎn)換一個(gè)代表了一個(gè)域名的Punycode字符串為一個(gè)Unicode字符串。只有代表了域名的部分的Punycode字符串會(huì)被轉(zhuǎn)換。也就是說，如果你調(diào)用了一個(gè)已經(jīng)被轉(zhuǎn)換為Unicode的字符串，也是沒有問題的。

// decode domain names
punycode.toUnicode('xn--maana-pta.com'); // 'ma?ana.com'
punycode.toUnicode('xn----dqo34k.com'); // '?-?.com'

punycode.toASCII(domain)

轉(zhuǎn)換一個(gè)代表了一個(gè)域名的Unicode字符串為一個(gè)Unicode字符串。只有代表了域名的部分的非ASCII 字符串會(huì)被轉(zhuǎn)換。也就是說，如果你調(diào)用了一個(gè)已經(jīng)被轉(zhuǎn)換為 ASCII 的字符串，也是沒有問題的。

// encode domain names
punycode.toASCII('ma?ana.com'); // 'xn--maana-pta.com'
punycode.toASCII('?-?.com'); // 'xn----dqo34k.com'

punycode.ucs2

punycode.ucs2.decode(string)

創(chuàng)建一個(gè)包含了 字符串中的每個(gè)Unicode符號(hào)的數(shù)字編碼點(diǎn) 的數(shù)組。由于JavaScript在內(nèi)部使用UCS-2，這個(gè)函數(shù)會(huì)將一對(duì)代理部分（surrogate halves）（UCS-2 暴露的單獨(dú)字符）轉(zhuǎn)換為一個(gè)單獨(dú)的編碼點(diǎn) 來匹配 UTF-16。

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)

基于數(shù)字編碼點(diǎn)的數(shù)組，創(chuàng)建一個(gè)字符串。

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

punycode.version

一個(gè)代表了當(dāng)前Punycode.js版本號(hào)的數(shù)字。