encodeURI()
BaselineWidely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
encodeURI() 関数は、URI (Uniform Resource Identifier; 統一資源識別子) をエンコードし、各文字のインスタンスをそれぞれUTF-8 符号の文字を表す 1 個から 4 個のエスケープシーケンスに置き換えます (サロゲート文字のペアのみ 4 個のエスケープシーケンスになります)。
試してみましょう
const uri = "https://mozilla.org/?x=шеллы";const encoded = encodeURI(uri);console.log(encoded);// Expected output: "https://mozilla.org/?x=%D1%88%D0%B5%D0%BB%D0%BB%D1%8B"try { console.log(decodeURI(encoded)); // Expected output: "https://mozilla.org/?x=шеллы"} catch (e) { // Catches a malformed URI console.error(e);}構文
encodeURI(URI)
引数
URI完全 URI です。
返値
URI (Uniform Resource Identifier) としてエンコードされた指定された文字列を表す新しい文字列です。
解説
encodeURI() 関数では、 URI において特別な意味を持つ文字 (予約文字) はエンコードされません。下記の例は URI "scheme" に含まれる可能性がある全ての箇所を示しています。特定の文字がどのように特殊な意味を表すために使われているかに注意してください。
http://username:password@www.example.com:80/path/to/file.php?foo=316&bar=this+has+spaces#anchor
したがって、encodeURI() は完全な URI を表すのに必要な文字はエンコードしません。また、encodeURI() は "unreserved marks" (予約されていないが "そのまま" URI に使用できる) 文字をエンコードしません。 (RFC2396 を確認してください。)
encodeURI() は下記以外の全ての文字をエスケープします。
エスケープされないもの: A-Z a-z 0-9 ; , / ? : @ & = + $ - _ . ! ~ * ' ( ) #
例
encodeURI と encodeURIComponent
encodeURI() は以下のようにencodeURIComponent() とは異なります。
var set1 = ";,/?:@&=+$#"; // 予約文字var set2 = "-_.!~*'()"; // 予約されていない記号var set3 = "ABC abc 123"; // 英数字 + 空白console.log(encodeURI(set1)); // ;,/?:@&=+$#console.log(encodeURI(set2)); // -_.!~*'()console.log(encodeURI(set3)); // ABC%20abc%20123 (空白は %20 にエンコードされる)console.log(encodeURIComponent(set1)); // %3B%2C%2F%3F%3A%40%26%3D%2B%24%23console.log(encodeURIComponent(set2)); // -_.!~*'()console.log(encodeURIComponent(set3)); // ABC%20abc%20123 (空白は %20 にエンコードされる)なお、encodeURI() のみでは、 HTTP のGET およびPOST リクエストをXMLHttpRequest のように適切に構成できません。なぜなら、 "&", "+", "=" はGET およびPOST リクエストにおいて特別な文字であり、それらがエンコードされないからです。encodeURIComponent() の場合、それらがエンコードされます。
単独のサロゲート文字のエンコード
サロゲートペアになっていない 1 個のサロゲート文字をエンコードしようとするとURIError が発生することに注意してください。例えば、
// サロゲートペアは OKconsole.log(encodeURI("\uD800\uDFFF"));// 上位サロゲートのみだと "URIError: malformed URI sequence" エラーが発生console.log(encodeURI("\uD800"));// 下位サロゲートのみだと "URIError: malformed URI sequence" エラーが発生console.log(encodeURI("\uDFFF"));IPv6 のエンコード
仕様書
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-encodeuri-uri |