Join MDN and developers like you at Mozilla's View Source conference, 12-14 September in Berlin, Germany. Learn more at https://viewsourceconf.org

nsIXULBrowserWindow

Provides methods that may be called from the internals of the browser area to tell the containing XUL window to update its user interface.
Inherits from: nsISupports Last changed in Gecko 2.0 (Firefox 4 / Thunderbird 3.3 / SeaMonkey 2.1)

The XULBrowserWindow attribute exists on the nsIXULWindow interface although both Firefox and SeaMonkey also store their nsIXULBrowserWindow reference in the global XULBrowserWindow object accessible from JavaScript code.

Note: The XULBrowserWindow object offered to JavaScript code provides a great many more methods and attributes than those listed here, which are only the ones available to C++ code. See the documentation for XULBrowserWindow for details.

Method overview

AString onBeforeLinkTraversal(in AString originalTarget, in nsIURI linkURI, in nsIDOMNode linkNode, in PRBool isAppTab);
void setJSDefaultStatus(in AString status);
void setJSStatus(in AString status);
void setOverLink(in AString link, in nsIDOMElement element);

Methods

Requires Gecko 2.0 (Firefox 4 / Thunderbird 3.3 / SeaMonkey 2.1)

onBeforeLinkTraversal()

Called before traversing a link to determine the appropriate target into which to load the link. This may be used, for example, to redirect links into new tabs or windows when it's not desirable to replace the content in the current tab (such as when the link is clicked in an app tab).

AString onBeforeLinkTraversal(
  in AString originalTarget,
  in nsIURI linkURI,
  in nsIDOMNode linkNode,
  in PRBool isAppTab
);
Parameters
originalTarget
The specified target for the link.
linkURI
The URI of the link that is about to be traversed.
linkNode
The nsIDOMNode representing the DOM node in which the link is located.
isAppTab
Whether or not the link being clicked is in an app tab.
Return value

A string indicating the revised target for the link.

setJSDefaultStatus()

Sets the default status according to JavaScript's version of the default status.

void setJSDefaultStatus(
  in AString status
);
Parameters
status
The status string.

setJSStatus()

Sets the status according to JavaScript's version of the status.

void setJSStatus(
  in AString status
);
Parameters
status
The status string.

setOverLink()

Tells the object implementing this function what link we are currently over.

void setOverLink(
  in AString link,
  in nsIDOMElement element
);
Parameters
link
The link string.
element
The currently targeted link element.

Document Tags and Contributors

 Contributors to this page: Sheppy, Neil
 Last updated by: Sheppy,