Non-standard
This feature is non-standard and is not on a standards track. Do not use it on production sites facing the Web: it will not work for every user. There may also be large incompatibilities between implementations and the behavior may change in the future.
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 |
Whether the event normally bubbles or not |
cancelable Read only |
Boolean |
Whether the event is cancellable or not? |
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 theframeElement
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, seewindow.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 + "."); });
Related Events
mozbrowserasyncscroll
mozbrowserclose
mozbrowsercontextmenu
mozbrowsererror
mozbrowsericonchange
mozbrowserloadend
mozbrowserloadstart
mozbrowserlocationchange
mozbrowsersecuritychange
mozbrowsertitlechange
mozbrowserusernameandpasswordrequired