--- title: Document.location slug: Web/API/Document/location tags: - API - Document - HTML DOM - Propriété - Reference - lecture seule translation_of: Web/API/Document/location --- <p><span style="font-size: 14px; line-height: 1.5;">La propriété en lecture seule </span><strong style="font-size: 14px; line-height: 1.5;"><code>Document.location</code></strong><code style="font-size: 14px;"> renvoie un objet</code><span style="font-size: 14px; line-height: 1.5;"> {{domxref("Location")}}, contenant les informations sur l'URL du document et fournit des moyens pour modifier cette URL ou charger une autre URL.</span></p> <p><span style="font-size: 14px; line-height: 1.5;">Bien que </span><code style="font-size: 14px;">Document.location</code><span style="font-size: 14px; line-height: 1.5;"> soit un objet </span><span style="font-size: 14px; line-height: 1.5;"> </span><code style="font-size: 14px;">Location</code><span style="font-size: 14px; line-height: 1.5;"> en <em>lecture seule</em>, vous pouvez lui assigner un</span><span style="font-size: 14px; line-height: 1.5;"> {{domxref("DOMString")}}. Cela signifie que vous pouvez dans la plupart des cas utiliser document.location comme s'il s'agissait d'une chaîne de caractères: </span><code style="font-size: 14px;">document.location = 'http://www.example.com'</code><span style="font-size: 14px; line-height: 1.5;"> est un synonyme de </span><code style="font-size: 14px;">document.location.href = 'http://www.example.com'</code><span style="font-size: 14px; line-height: 1.5;">.</span></p> <p><span style="font-size: 14px; line-height: 1.5;">Pour récupérer uniquement l'URL en tant que chaîne de caractères, la propriété </span><span style="font-size: 14px; line-height: 1.5;">{{domxref("document.URL")}} peut également être utilisée.</span></p> <p><span style="font-size: 14px; line-height: 1.5;">Si le document courant n'est pas un contexte de navigation, la valeur renvoyée est <em>null</em>.</span></p> <h2 id="Syntax" name="Syntax">Syntaxe</h2> <pre class="syntaxbox notranslate"><em>locationObj</em> = document.location document.location = 'http://www.mozilla.org' // équivalent à document.location.href = 'http://www.mozilla.org' </pre> <h2 id="Example" name="Example">Exemple</h2> <pre class="brush: js notranslate">console.log(document.location); // Affiche un string-like // "http://www.example.com/juicybits.html" dans la console </pre> <h2 id="Spécification">Spécification</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>{{SpecName('HTML WHATWG', "history.html#the-location-interface", "Document.location")}}</td> <td>{{Spec2('HTML WHATWG')}}</td> <td>Pas de changement avec {{SpecName("HTML5 W3C")}}.</td> </tr> <tr> <td>{{SpecName('HTML5 W3C', "browsers.html#the-location-interface", "Document.location")}}</td> <td>{{Spec2('HTML5 W3C')}}</td> <td>Définition initiale.</td> </tr> </tbody> </table> <h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> <p>{{Compat("api.Document.location")}}</p> <h2 id="Voir_également">Voir également</h2> <ul> <li>L'interface de la valeur renvoyée, {{domxref("Location")}}.</li> <li>Une information similaire mais attachée au contexte de navigation, {{domxref("Window.location")}}</li> </ul>