Please note, this is a STATIC archive of website developer.mozilla.org from 03 Nov 2016, cach3.com does not collect or store any user information, there is no "phishing" involved.

mozbrowserusernameandpasswordrequired

この記事はまだボランティアによって 日本語 に翻訳されていません。ぜひ MDN に参加して翻訳を手伝ってください!

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

See also

ドキュメントのタグと貢献者

 このページの貢献者: chrisdavidmills, wbamberg, teoli, kscarfone, Jeremie
 最終更新者: chrisdavidmills,