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 應建議從通用身份驗證器（如基於智慧手機的身份驗證器應用程式）請求憑據。這有利於使用跨裝置處理身份驗證的方法，例如結合使用筆記型電腦和智慧手機。