Webエンジニア向けプログラミング解説動画をYouTubeで配信中!
▶ チャンネル登録はこちら

【Node.js24.x】Object::domainToASCII()メソッドの使い方

domainToASCIIメソッドの使い方について、初心者にもわかりやすく解説します。

作成日: 更新日:

基本的な使い方

domainToASCIIメソッドは、国際化ドメイン名(IDN: Internationalized Domain Name)を、DNS(Domain Name System)で安全に扱えるASCII互換エンコーディング形式(Punycode)に変換する機能を提供します。Webサイトのアドレスなど、ドメイン名には日本語や中国語といったASCII以外の文字を含むものがありますが、DNSシステムは基本的にASCII文字しか処理できません。このため、多言語のドメイン名をネットワーク上で利用する際には、Punycodeという特定のルールに基づいたASCII文字列へと変換する必要があります。

具体的には、「ドメイン名.jp」のような国際化ドメイン名を、「xn--eckwfmb7a.jp」といった形式に変換します。この変換によって、世界中のDNSサーバーが認識できる標準的な形式となり、多言語ドメイン名を含むWebサイトへのアクセスやメールの送受信が可能になります。

このメソッドは、変換対象のドメイン名を文字列として受け取り、Punycode形式にエンコードされたASCII文字列を返します。もし入力されたドメイン名が無効な場合は、空の文字列が返されることがあります。システム開発において、国際化されたURLを扱う際や、特定のシステムでドメイン名をASCII形式に統一する必要がある場面で非常に役立ちます。Node.jsでURLを処理する際に、国際化ドメイン名の互換性を確保するために利用される重要なメソッドの一つです。

構文(syntax)

1Object.domainToASCII(domain)

引数(parameters)

input

  • input: string: ASCII形式に変換したい国際化ドメイン名(IDN)を指定する文字列

戻り値(return)

string

domainToASCII メソッドは、国際化ドメイン名(IDN)を Punycode 形式の ASCII 文字列に変換した結果を返します。

関連コンテンツ