Revision 699359 of encodeURI()

<div>
 <div>
  <div>
   {{jsSidebar("Objects")}}</div>
 </div>
</div>
<h2 id="Summary" name="Summary">Summary</h2>
<p>The <code><strong>encodeURI()</strong></code> method encodes a Uniform Resource Identifier (URI) by replacing each instance of certain characters by one, two, three, or four escape sequences representing the UTF-8 encoding of the character (will only be four escape sequences for characters composed of two "surrogate" characters).</p>
<h2 id="Syntax" name="Syntax">Syntax</h2>
<pre class="syntaxbox">
<code>encodeURI(<em>URI</em>)</code></pre>
<h3 id="Parameters" name="Parameters">Parameters</h3>
<dl>
 <dt>
  <code>URI</code></dt>
 <dd>
  A complete Uniform Resource Identifier.</dd>
</dl>
<h2 id="Description" name="Description">Description</h2>
<p>Assumes that the URI is a complete URI, so does not encode reserved characters that have special meaning in the URI.</p>
<p><code>encodeURI</code> replaces all characters except the following with the appropriate UTF-8 escape sequences:</p>
<table class="standard-table">
 <tbody>
  <tr>
   <td class="header">Type</td>
   <td class="header">Includes</td>
  </tr>
  <tr>
   <td>Reserved characters</td>
   <td><code>;</code> <code>,</code> <code>/</code> <code>?</code> <code>:</code> <code>@</code> <code>&amp;</code> <code>=</code> <code>+</code> <code>$</code></td>
  </tr>
  <tr>
   <td>Unescaped characters</td>
   <td>alphabetic, decimal digits, <code>-</code> <code>_</code> <code>.</code> <code>!</code> <code>~</code> <code>*</code> <code>'</code> <code>(</code> <code>)</code></td>
  </tr>
  <tr>
   <td>Score</td>
   <td><code>#</code></td>
  </tr>
 </tbody>
</table>
<p>Note that <code>encodeURI</code> by itself <em>cannot</em> form proper HTTP GET and POST requests, such as for XMLHTTPRequests, because "&amp;", "+", and "=" are not encoded, which are treated as special characters in GET and POST requests. {{jsxref("Global_Objects/encodeURIComponent", "encodeURIComponent")}}, however, does encode these characters.</p>
<p>Note that an {{jsxref("Global_Objects/URIError", "URIError")}} will be thrown if one attempts to encode a surrogate which is not part of a high-low pair, e.g.,</p>
<pre class="brush: js">
// high-low pair ok
alert(encodeURI('\uD800\uDFFF'));

// lone high surrogate throws "URIError: malformed URI sequence"
alert(encodeURI('\uD800'));

// lone low surrogate throws "URIError: malformed URI sequence"
alert(encodeURI('\uDFFF')); </pre>
<p>Also note that if one wishes to follow the more recent <a href="https://tools.ietf.org/html/rfc3986">RFC3986</a> for URLs, which makes square brackets reserved (for IPv6) and thus not encoded when forming something which could be part of a URL (such as a host), the following code snippet may help:</p>
<pre class="brush: js">
function fixedEncodeURI (str) {
    return encodeURI(str).replace(/%5B/g, '[').replace(/%5D/g, ']');
}</pre>
<h2 id="Specifications">Specifications</h2>
<table class="standard-table">
 <tbody>
  <tr>
   <th scope="col">Specification</th>
   <th scope="col">Status</th>
   <th scope="col">Comment</th>
  </tr>
  <tr>
   <td>ECMAScript 3rd Edition.</td>
   <td>Standard</td>
   <td>Initial definition.</td>
  </tr>
  <tr>
   <td>{{SpecName('ES5.1', '#sec-15.1.3.3', 'encodeURI')}}</td>
   <td>{{Spec2('ES5.1')}}</td>
   <td>&nbsp;</td>
  </tr>
  <tr>
   <td>{{SpecName('ES6', '#sec-encodeuri-uri', 'encodeURI')}}</td>
   <td>{{Spec2('ES6')}}</td>
   <td>&nbsp;</td>
  </tr>
 </tbody>
</table>
<h2 id="Browser_compatibility">Browser compatibility</h2>
<p>{{ CompatibilityTable() }}</p>
<div id="compat-desktop">
 <table class="compat-table">
  <tbody>
   <tr>
    <th>Feature</th>
    <th>Chrome</th>
    <th>Firefox (Gecko)</th>
    <th>Internet Explorer</th>
    <th>Opera</th>
    <th>Safari</th>
   </tr>
   <tr>
    <td>Basic support</td>
    <td>{{ CompatVersionUnknown() }}</td>
    <td>{{ CompatVersionUnknown() }}</td>
    <td>{{ CompatVersionUnknown() }}</td>
    <td>{{ CompatVersionUnknown() }}</td>
    <td>{{ CompatVersionUnknown() }}</td>
   </tr>
  </tbody>
 </table>
</div>
<div id="compat-mobile">
 <table class="compat-table">
  <tbody>
   <tr>
    <th>Feature</th>
    <th>Android</th>
    <th>Chrome for Android</th>
    <th>Firefox Mobile (Gecko)</th>
    <th>IE Mobile</th>
    <th>Opera Mobile</th>
    <th>Safari Mobile</th>
   </tr>
   <tr>
    <td>Basic support</td>
    <td>{{ CompatVersionUnknown() }}</td>
    <td>{{ CompatVersionUnknown() }}</td>
    <td>{{ CompatVersionUnknown() }}</td>
    <td>{{ CompatVersionUnknown() }}</td>
    <td>{{ CompatVersionUnknown() }}</td>
    <td>{{ CompatVersionUnknown() }}</td>
   </tr>
  </tbody>
 </table>
</div>
<h2 id="See_Also" name="See_Also">See also</h2>
<ul>
 <li>{{jsxref("Global_Objects/decodeURI", "decodeURI")}}</li>
 <li>{{jsxref("Global_Objects/encodeURIComponent", "encodeURIComponent")}}</li>
 <li>{{jsxref("Global_Objects/decodeURIComponent", "decodeURIComponent")}}</li>
</ul>
<!--languages({
	"fr": "fr/R\u00e9f\u00e9rence_de_JavaScript_1.5_Core/Fonctions_globales/encodeURI",
} ) -->