Document.domain

Résumé

Renvoie ou défini la partie "domain" de l'origine du document courant, comme usitée par la politique d'origine identique.

Syntaxe

var domainChaine = document.domain;
document.domain = chaine;

Exemple

// pour le document www.example.xxx/good.html,
// ce script ferme la fenêtre
var mauvaisDomain = "www.example.xxx";

if (document.domain == mauvaisDomain)
   window.close(); // Juste un example - window.close() n'a parfois aucun effet.

// Pour l'URI https://developer.mozilla.org/en-US/docs/Web ce qui
// suit définie la variable "domain" sur la chaîne "developer.mozilla.org"
var domain = document.domain;

Notes

Cette propriété renvoie null si le domaine du document ne peut pas être identifié.

Mozilla vous laissera la définir sur un superdomaine de la valeur courante, constrain par son domaine de base. Par exemple, pour developer.mozilla.org il est possible de régler la propriété avec la valeur "mozilla.org" mais pas avec "mozilla.com" ou "org".

Si cette propriété est définie avec succès, la partie "port" de l'origine est également réglée sur null.

Mozilla fait la distinction entre la propriété d'un document.domain qui n'a jamais été modifiée d'une explicitement définie avec le même domaine que l'URL du document, même si la propriété renvoie la même valeur dans chacun des cas. Un document est autorisé à accéder à un autre si il ont chacun défini document.domain avec la même valeur, indicant leur intention de cooperer, ou si ils ont défini document.domain et que les domaines dans les URLs sont les mêmes (implementation). Sans cette politique spéciale, chaque site serait sujet au Cross-Site-Scripting (XSS)  de ses sous-domaines (par exemple, https://bugzilla.mozilla.org pourraiêtre attaqué par des attachements de bugs sur https://bug*.bugzilla.mozilla.org).

Specification

• DOM Level 2 HTML: document.domain (le décrit en lecture-seule)
• HTML5: document.domain (décrit son comportement similaire à celui de Mozilla)

Voir aussi

• Same origin policy for JavaScriptHTML