mozbrowserusernameandpasswordrequired 编辑

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 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

details

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

host

A DOMString representing the host requesting the HTTP authentification.

realm

A DOMString representing the value of the realm HTTP header.

isProxy

A Boolean indicating 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

• mozbrowserasyncscroll
• mozbrowserclose
• mozbrowsercontextmenu
• mozbrowsererror
• mozbrowsericonchange
• mozbrowserloadend
• mozbrowserloadstart
• mozbrowserlocationchange
• mozbrowseropenwindow
• mozbrowsersecuritychange
• mozbrowsertitlechange

See also

• Using the Browser API