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 mozbrowserlocationchange event is fired when a browser <iframe>'s location changes — it is fired every time navigation occurs.
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? |
detail Read only |
DOMString |
The URL of the new location (Gecko) |
detail Read only |
object |
A custom object (Servo) |
detail (Servo only)
The details property returns an anonymous JavaScript object with the following properties:
- url
- The URL of the new location
- canGoBack
- Boolean. Whether it's possible to go back in the navigation history.
- canGoForward
- Boolean. Whether it's possible to go forward in the navigation history.
- Example
This example updates the URL bar so that it will always display the correct URL for the current location.
var browser = document.querySelector("iframe");
browser.addEventListener('mozbrowserlocationchange', function (event) {
urlBar.value = event.detail;
});
Related Events
mozbrowserasyncscrollmozbrowserclosemozbrowsercontextmenumozbrowsererrormozbrowsericonchangemozbrowserloadendmozbrowserloadstartmozbrowseropenwindowmozbrowsersecuritychangemozbrowsershowmodalpromptmozbrowsertitlechangemozbrowserusernameandpasswordrequired