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

mozbrowseropenwindow

Non-standard
This feature is not on a current W3C standards track, but it is supported on the Firefox OS platform. Although implementations may change in the future and it is not supported widely across browsers, it is suitable for use in code dedicated to Firefox OS apps.

The mozbrowseropenwindow event is fired when a new window is required — usually when the content of a browser <iframe> successfully calls the window.open() method, or the user clicks on a link with an unknown target.

The embedder must use the <iframe> passed in the event.details.frameElement property as the new window content.

General info

Specification
Non standard
Interface
CustomEvent
Bubbles
Yes
Cancelable
Yes
Target
<iframe>
Default Action
None

Properties

Property Type Description
target Read only EventTarget The browser iframe
type Read only DOMString The type of event.
bubbles Read only boolean Does the event normally bubble?
cancelable Read only boolean Is it possible to cancel the event?
details Read only object A custom object

details

The details property returns an anonymous JavaScript object with the following properties:

url
A DOMString representing the URL of the document loaded within the frameElement property.
name
A DOMString representing the name of the new browser window.
features
A DOMString containing features represented by a list of names and values separated by commas. For a complete list of possible features, see window.open().
frameElement
An object representing the new browser <iframe> that will embed the new content.

Example

var browser = document.querySelector("iframe");

browser.addEventListener("mozbrowseropenwindow", function( event ) {
  console.log("A new window has opened containing the content at " + event.details.url + ".");
});

See also

Document Tags and Contributors

 Contributors to this page: wbamberg, chrisdavidmills, teoli, kscarfone, Jeremie
 Last updated by: wbamberg,