【Node.js24.x】Object::encodeURI()メソッドの使い方
encodeURIメソッドの使い方について、初心者にもわかりやすく解説します。
基本的な使い方
encodeURIメソッドは、与えられた文字列をURI（Uniform Resource Identifier）として安全に扱えるようにエンコード（符号化）を実行するメソッドです。ウェブサイトのアドレスやリソースの場所を示すURIには、半角スペースや日本語などの特殊な文字が含まれると、ウェブブラウザやサーバーが正しく解釈できず、リンクが機能しなかったり、エラーが発生したりする原因となることがあります。このメソッドは、そのような問題を避けるために、URIの構文として特別な意味を持たない文字を、パーセント（%）記号と16進数による形式（パーセントエンコーディング）に変換します。
具体的には、URIとして予約されている「; , / ? : @ & = + $ - _ . ! ~ * ' ( ) #」などの文字は、URIの構造を維持するためにエンコードされずにそのまま残されます。これにより、完全なURI全体をエンコードする際に、URIのパス構造やクエリパラメータの区切りなどの意味を損なうことなく、安全にネットワーク上で利用可能な形式に変換できます。例えば、ユーザーが入力した検索語句を含むURLを生成する際や、特定のファイルへのリンクを動的に作成する際などに利用することで、文字化けやリンク切れといった予期せぬ問題を効果的に防ぎ、安定したシステムの動作に貢献します。このメソッドは、JavaScriptのグローバルオブジェクトの組み込み機能として提供されており、Node.jsの環境においても直接呼び出して使用することが可能です。
構文(syntax)
encodeURI("https://example.com/my page?name=値¶m=その他");
引数(parameters)
URIString
- URIString: string: エンコードするURI文字列
戻り値(return)
String
URIエンコードされた文字列を返します。この文字列は、URLの構成要素として安全に使用できるように、特殊文字がエスケープされています。