Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.

View in English Always switch to English

Document : propriété location

Baseline Widely available

Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis juillet 2015.

La propriété en lecture seule location de l'interface Document retourne un objet Location, qui contient des informations sur l'URL du document et fournit des méthodes pour modifier cette URL et charger une autre URL.

Pour récupérer uniquement l'URL sous forme de chaîne de caractères, la propriété en lecture seule document.URL peut également être utilisée.

Valeur

Un objet Location. Si le document actuel n'est pas dans un contexte de navigation, la valeur retournée est null.

Bien que la propriété location elle-même soit en lecture seule dans le sens où vous ne pouvez pas remplacer l'objet Location, vous pouvez toujours affecter directement à la propriété location, ce qui équivaut à affecter à sa propriété href. Vous pouvez également modifier l'objet Location en utilisant les méthodes assign() et replace().

Exemples

js
console.log(document.location);
// Affiche un objet Location dans la console

Spécifications

Specification
HTML
# the-location-interface

Compatibilité des navigateurs

Voir aussi