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

mozbrowserlocationchange

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;
});

See also

Document Tags and Contributors

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