Table of Contents

• punycode
  • punycode.decode(string)
  • punycode.encode(string)
  • punycode.toUnicode(domain)
  • punycode.toASCII(domain)
  • punycode.ucs2
    • punycode.ucs2.decode(string)
    • punycode.ucs2.encode(codePoints)
  • punycode.version

punycode#

Stability: 2 - Unstable

Punycode.js は Node.js v0.6.2 以降に バンドルされています。 アクセスするには require('punycode') を使用します (他のバージョンの Node.js でこれを使用するには、先に npm を使用して punycode モジュールをインストールしてください)。

punycode.decode(string)#

ASCII 文字のみによる Punycode 文字列を Unicode 文字による文字列に変換します。

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

punycode.encode(string)#

Unicode 文字による文字列を ASCII 文字による Punycode 文字列に変換します。

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

punycode.toUnicode(domain)#

Punycode 文字列で表現されたドメイン名を Unicode に変換します。 ドメイン名の中の Punycode 化された文字列だけが変換されます。 そのため、すでに Unicode に変換された文字列でも気にせずに渡すことができます。

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

punycode.toASCII(domain)#

Unicode 文字列で表現されたドメイン名を Punycode に変換します。 ドメイン名の中の非 ASCII 文字だけが変換されます。 すなわち、すでに 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)#

文字列中の Unicode 文字のコードポイントに対応する数値を含む配列を作成します。 JavaScript uses UCS-2 internally のように、この関数はサロゲートペア (それぞれは 16bit の独立した文字) を 対応する Unicode の一つのコードポイントに変換します。

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 のバージョン番号を表す文字列です。