Bug 1220602 - Make the documentation for nsIPrincipal.domain useful. r=bholley IGNORE IDL
authorJonathan Watt <jwatt@jwatt.org>
Thu, 24 Sep 2015 00:36:04 +0100
changeset 306823 f060c88927d1bc7f6d2f2521eb6fe36f172bb747
parent 306822 0f09e1b4ef1d656eff1859fc8c029c17c0b05822
child 306824 6d65e95193c98311e6f4a33c1c7a27eb4f0f766c
push id1040
push userraliiev@mozilla.com
push dateMon, 29 Feb 2016 17:11:22 +0000
treeherdermozilla-release@8c3167321162 [default view] [failures only]
perfherder[talos] [build metrics] [platform microbench] (compared to previous push)
reviewersbholley
bugs1220602
milestone45.0a1
first release with
nightly linux32
nightly linux64
nightly mac
nightly win32
nightly win64
last release without
nightly linux32
nightly linux64
nightly mac
nightly win32
nightly win64
Bug 1220602 - Make the documentation for nsIPrincipal.domain useful. r=bholley IGNORE IDL
caps/nsIPrincipal.idl
--- a/caps/nsIPrincipal.idl
+++ b/caps/nsIPrincipal.idl
@@ -55,18 +55,20 @@ interface nsIPrincipal : nsISerializable
     /**
      * The codebase URI to which this principal pertains.  This is
      * generally the document URI.
      */
     readonly attribute nsIURI URI;
 
     /**
      * The domain URI to which this principal pertains.
-     * This is congruent with HTMLDocument.domain, and may be null.
+     * This is null unless script successfully sets document.domain to our URI
+     * or a superdomain of our URI.
      * Setting this has no effect on the URI.
+     * See https://developer.mozilla.org/en-US/docs/Web/Security/Same-origin_policy#Changing_origin
      */
     [noscript] attribute nsIURI domain;
 
     /**
      * Returns whether the other principal is equal to or weaker than this
      * principal. Principals are equal if they are the same object or they
      * have the same origin.
      *