在此页

• 句法
• 规范
• 浏览器兼容性
• 另请参阅
• 相关话题

这是 实验性技术
检查 浏览器兼容性表格 要小心谨慎在生产中使用这之前。

get() 方法在 CredentialsContainer interface returns a Promise to a single Credential instance that matches the provided parameters. If no match is found the Promise will resolve to null.

This method first collects all credentials in the CredentialsContainer that meet the necessary criteria (defined in the 选项 argument). From the resulting set of credentials, it then selects the best one. Depending on the options, it may display a dialog to the user and ask the user to make the selection.

This method collects credentials by calling the "CollectFromCredentialStore" method for each credential type allowed by the 选项 argument. For example: if options.password exists, then the PasswordCredential .[[CollectFromCredentialStore]] is called.

This method is restricted to top-level contexts. Calls to it within an <iframe> element will resolve without effect.

句法

var promise = CredentialsContainer.get([options])
					

参数

选项 可选

An object of type CredentialRequestOptions that contains options for the request. The options include criteria that the credentials are required or allowed to have, and options for interacting with the user. It can contain the following properties:

• password ： 布尔 indicating that returned Credential instances should include user (as opposed to federated) credentials.
• federated : A FederatedCredentialRequestOptions object containing requirements for returned federated credentials. The available options are:
  • providers : An array of DOMString instances of identity providers to search for.
  • protocols An array of DOMString instances of federation protocols to search for.
• publicKey : An PublicKeyCredentialRequestOptions object containing requirements for returned WebAuthn credentials.
• mediation : A 字符串 indicating whether the user will be required to log on for every visit to the website. Valid values are "silent" , "optional" ，或 "required" .
• unmediated : A 布尔 indicating the returned Credential instance should not require user mediation.
• signal : An instance of AbortSignal that can indicate that an ongoing get() operation should be halted. An aborted operation may complete normally (generally if the abort was received after the operation finished) or reject with an " AbortError " DOMException .

返回

A Promise that resolves with a Credential instance that matches the provided parameters. If a single Credential cannot be unambigiously obtained, the Promise will resolve to null.

规范

规范	状态	注释
Credential Management Level 1 The definition of 'get()' in that specification.	工作草案	初始定义。
Web Authentication: An API for accessing Public Key Credentials Level 1	推荐	初始定义。

浏览器兼容性

The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request. 更新 GitHub 上的兼容性数据

	桌面						移动
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	Android webview	Chrome for Android	Firefox for Android	Opera for Android	Safari on iOS	Samsung Internet
get	Chrome 51	Edge 18	Firefox Yes	IE ?	Opera 不支持 No	Safari 13	WebView Android 51	Chrome Android 51	Firefox Android Yes	Opera Android 不支持 No	Safari iOS 13.3	Samsung Internet Android 5.0

图例

完整支持

完整支持

不支持

不支持

兼容性未知 ?

兼容性未知

实验。期望将来行为有所改变。

实验。期望将来行为有所改变。

另请参阅

• Feature-Policy directive publickey-credentials-get

元数据

• 最后修改： Jul 7, 2020

相关话题

1. CredentialsContainer
2. 方法

   1. create()
   2. get()
   3. preventSilentAccess()
   4. store()