CredentialsContainer

This is an experimental technology
Check the Browser compatibility table carefully before using this in production.

Secure context
This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.

The CredentialsContainer interface of the the Credential Management API exposes methods to request credentials and notify the user agent when events such as successful sign in or sign out happen. This interface is accessible from Navigator.credentials.

Properties

None.

Event handlers

None.

Methods

CredentialsContainer.create()Secure context
Returns a Promise that resolves with a new Credential instance based on the provided options, or null if no Credential object can be created. In exceptional circumstances, the Promise may reject.
CredentialsContainer.get()Secure context
Returns a Promise that resolves with the Credential instance that matches the provided parameters.
CredentialsContainer.preventSilentAccess()Secure context
Sets a flag that specifies whether automatic log in is allowed for future visits to the current origin, then returns an empty Promise. For example, you might call this, after a user signs out of a website to ensure that he/she isn't automatically signed in on the next site visit. Earlier versions of the spec called this method requireUserMediation(). See Browser compatibility for support details.
CredentialsContainer.store()Secure context
Stores a set of credentials for a user, inside a provided Credential instance and returns that instance in a Promise.

Examples

// TBD

Specifications

Specification Status Comment
Credential Management Level 1 Working Draft Initial definition.
Web Authentication: An API for accessing Public Key Credentials Level 1 Recommendation Initial definition.

Browser compatibility

DesktopMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome for AndroidFirefox for AndroidOpera for AndroidSafari on iOSSamsung Internet
CredentialsContainer
Experimental
Chrome Full support 51Edge Full support 18Firefox Full support YesIE ? Opera No support NoSafari Full support 13WebView Android Full support 51Chrome Android Full support 51Firefox Android Full support YesOpera Android No support NoSafari iOS Full support 13.3Samsung Internet Android Full support 5.0
create
Experimental
Chrome Full support 60Edge Full support 18Firefox Full support YesIE ? Opera No support NoSafari Full support 13WebView Android Full support 60Chrome Android Full support 60Firefox Android Full support YesOpera Android No support NoSafari iOS Full support 13.3Samsung Internet Android Full support 8.0
get
Experimental
Chrome Full support 51Edge Full support 18Firefox Full support YesIE ? Opera No support NoSafari Full support 13WebView Android Full support 51Chrome Android Full support 51Firefox Android Full support YesOpera Android No support NoSafari iOS Full support 13.3Samsung Internet Android Full support 5.0
preventSilentAccess
Experimental
Chrome Full support 60
Full support 60
No support 51 — 60
Alternate Name
Alternate Name Uses the non-standard name: requireUserMediation
Edge Full support ≤79Firefox Full support YesIE ? Opera No support NoSafari ? WebView Android Full support 60
Full support 60
No support 51 — 60
Alternate Name
Alternate Name Uses the non-standard name: requireUserMediation
Chrome Android Full support 60
Full support 60
No support 51 — 60
Alternate Name
Alternate Name Uses the non-standard name: requireUserMediation
Firefox Android Full support YesOpera Android No support NoSafari iOS ? Samsung Internet Android Full support 8.0
Full support 8.0
No support 5.0 — 8.0
Alternate Name
Alternate Name Uses the non-standard name: requireUserMediation
store
Experimental
Chrome Full support 51Edge Full support ≤79Firefox Full support YesIE ? Opera No support NoSafari ? WebView Android Full support 51Chrome Android Full support 51Firefox Android Full support YesOpera Android No support NoSafari iOS ? Samsung Internet Android Full support 5.0

Legend

Full support
Full support
No support
No support
Compatibility unknown
Compatibility unknown
Experimental. Expect behavior to change in the future.
Experimental. Expect behavior to change in the future.
Uses a non-standard name.
Uses a non-standard name.