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 mozbrowserusernameandpasswordrequired event is fired when the content within a browser <iframe> requires an HTTP authentification.
The embedder is supposed to retrieve the necessary credentials, usually using a dialog or a database of username/passwords, and then call authenticate() or cancel() as appropriate.
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 members:
host- A
DOMStringrepresenting the host requesting the HTTP authentification. realm- A
DOMStringrepresenting the value of therealmHTTP header. isProxy- A
Booleanindicating whether the server dealing with the authentication is a proxy server (true) or not (false). authenticate()- A function that is called to enable the authentication to go ahead. It needs to take two parameters — the username and password to authenticate.
cancel()- A function that is called to cancel the authentication.
Example
var browser = document.querySelector("iframe[mozbrowser]");
browser.addEventListener("mozbrowserusernameandpasswordrequired", function( event ) {
console.log("The auth realm is:" + event.detail.realm);
});
Related Events
mozbrowserasyncscrollmozbrowserclosemozbrowsercontextmenumozbrowsererrormozbrowsericonchangemozbrowserloadendmozbrowserloadstartmozbrowserlocationchangemozbrowseropenwindowmozbrowsersecuritychangemozbrowsertitlechange