The Document.documentURIObject read-only property returns an nsIURI object representing the URI of the document.
This only works for privileged (UniversalXPConnect) scripts, including extension code. For web content this property doesn't have any special meaning and can be used just like any other custom property.
Privileged code must be careful not to try getting or setting this property on a non-wrapped content object (e.g. on a wrappedJSObject of an XPCNativeWrapper). See bug 324464's comments for details.
Syntax
var uri = doc.documentURIObject;
Example
// Check that the URI scheme of the current tab in Firefox is 'http',
// assuming this code runs in context of browser.xul
var uriObj = content.document.documentURIObject;
var uriPort = uriObj.port;
if (uriObj.schemeIs('http')) {
...
}
Specifications
Not part of any specification.