PublicKeyCredentialRequestOptions

Baseline 广泛可用 *

此功能已成熟，并可在多种设备和浏览器版本上使用。自 2019 年 9 月以来，它已在各种浏览器中可用。

* 此特性的某些部分可能存在不同级别的支持。

安全上下文： 此功能仅在安全上下文（HTTPS）中可用，且支持此功能的浏览器数量有限。

PublicKeyCredentialRequestOptions 字典表示传递给 CredentialsContainer.get() 的 `publicKey` 选项的值的对象。

实例属性

一个用于限制可接受凭据列表的对象数组。空数组表示任何凭据均可接受。

数组中的每个对象将包含以下属性

id: 一个 ArrayBuffer、TypedArray 或 DataView，表示要检索的公钥凭据的 ID。此值与成功的 `get()` 调用返回的 PublicKeyCredential 对象的 rawId 属性相对应。
transports 可选: 一个字符串数组，提供有关客户端可以用来与要检索的公钥凭据的相关身份验证器通信的方法的提示。可能的传输方式有："ble"、"hybrid"、"internal"、"nfc" 和 "usb"。

注意：此值与原始创建凭据的 `create()` 调用返回的 PublicKeyCredential 对象的 PublicKeyCredential.response.getTransports() 方法的返回值相对应。此时，应用程序应将其存储以备后用。
type: 一个字符串，定义了要检索的公钥凭据的类型。目前只能取一个值 "public-key"，但未来可能会添加更多值。此值与成功的 `get()` 调用返回的 PublicKeyCredential 对象的 type 属性相对应。

此值默认为空数组。

一个 ArrayBuffer、TypedArray 或 DataView，源自信赖方服务器，并用作加密挑战。此值将被身份验证器签名，签名将作为 AuthenticatorAssertionResponse.signature 的一部分（可在成功的 `get()` 调用返回的 PublicKeyCredential 对象的 response 属性中找到）。

一个对象，包含表示任何请求扩展的输入值的属性。这些扩展用于在身份验证过程中对客户端或身份验证器进行特定的附加处理。示例包括处理旧的 FIDO API 凭据以及评估与凭据关联的伪随机函数 (PRF) 的输出。

扩展是可选的，不同的浏览器可能识别不同的扩展。客户端始终可以忽略扩展的处理：如果浏览器不识别给定的扩展，它将仅忽略它。有关使用扩展以及哪些扩展受哪些浏览器支持的信息，请参阅 Web Authentication 扩展。

一个字符串数组，提供有关浏览器应为用户提供何种 UI 以便使用现有公钥凭据进行身份验证的提示。

字符串可以是以下任意一种

"security-key": UI 应建议从单独的物理安全密钥（如 YubiKey）请求凭据。
"client-device": UI 应建议从用户正在使用的 RP 客户端所在的同一设备上可用的身份验证器请求凭据。
"hybrid": UI 应建议从通用身份验证器（如基于智能手机的身份验证器应用程序）请求凭据。这有利于使用跨设备处理身份验证的方法，例如结合使用笔记本电脑和智能手机。