This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
The get()
method of the CredentialsContainer
interface returns a Promise
to a Credential
instance that matches the provided parameters.
This method is restricted to top-level contexts. Calls to it within an <iframe>
element will resolve without effect.
Syntax
var promise = CredentialsContainer.get([options])
Parameters
- options Optional
- An object that sets options to look for among the credentials in the
CredentialsContainer
. The available options are:password
: aBoolean
indicating that returnedCredential
instances should include user (as opposed to federated) credentials.federated
: An object containing requirements for returned federated credentials. The available options are:mediation
: AString
indicating whether the user will be required to log on for every visit to the website. Valid values are"silent"
,"optional"
, or"required"
.unmediated
: ABoolean
indicating the returnedCredential
instance should not require user mediation.
Returns
A Promise
that resolves with a Credential
instance that matches the provided parameters.
Specifications
Specification | Status | Comment |
---|---|---|
Credential Management Level 1 The definition of 'get()' in that specification. |
Editor's Draft | Initial definition. |
Browser compatibility
Feature | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari (WebKit) |
---|---|---|---|---|---|
Basic support | 51 | ? | ? | No support | ? |
options.mediation |
60 | ? | ? | No support | ? |
Feature | Android Webview | Chrome for Android | Firefox Mobile (Gecko) | Firefox OS | IE Mobile | Opera Mobile | Safari Mobile |
---|---|---|---|---|---|---|---|
Basic support | 51 | 51 | ? | ? | ? | No support | ? |
options.mediation |
60 | 60 | ? | ? | ? | No support | ? |