特定の文字を1文字～4文字のUTF-8文字エンコーディングで表されるエスケープシーケンス(特殊文字)に置き換えることで、URIをエンコードします。 (2つの"サロゲート"文字から構成される文字は、4文字のエスケープシーケンスになります)

エスケープシーケンスとは、例えばHTMLのエスケープシーケンスであれば、 <を表す<のような特殊な文字の並びのことを指します。

文法

encodeURI(URI)

URIが完全なURIであることを前提に、 URIにとって特別な意味を持つ予約文字をエンコードしません。

encodeURIは、下記の一覧の文字を除く全ての文字を、適切なUTF-8のエスケープシーケンスに置換します。

encodeURIだけでは、GETとPOSTのリクエストで特別な文字として扱われる"&"、"+"、"="の文字がエンコード出来ないため、 XMLHTTPRequestの用途などで、HTTPのGETとPOSTのリクエストを形成できない事に注意してください。 ただし、encodeURIComponentであれば、これらの文字をエンコードします。

上位・下位のペアになっていないサロゲートのエンコードを試みると、 URIErrorがスローされることに注意してください。(下記例を参照)

// 上位・下位のペアOK
alert(encodeURI('\uD800\uDFFF'));

// 孤立した上位サロゲートのため、
// "URIError: malformed URI sequence"をスロー
alert(encodeURI('\uD800'));

// 孤立した下位サロゲートのため、
// "URIError: malformed URI sequence"をスロー
alert(encodeURI('\uDFFF'));

また、(IPv6用に)角括弧([])を予約した、 URLのより新しいRFC3986に準拠したいのであれば、 そのままでは角括弧はURLの一部(ホストなど)として形成時にエンコードされないため、 下記のような関数を使用すると良いかもしれません。(翻訳に自信なし)

function fixedEncodeURI (str) {
    return encodeURI(str).replace(/%5B/g, '[').replace(/%5D/g, ']');
}

仕様

ブラウザ互換性

関連項目

• decodeURI
• encodeURIComponent
• decodeURIComponent

 Back to top