AuthenticatorAttestationResponse: getTransports() method
Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.
The getTransports()
method of the AuthenticatorAttestationResponse
interface returns an array of strings describing the different transports which may be used by the authenticator.
Such transports may be USB, NFC, BLE, internal (applicable when the authenticator is not removable from the device), or a hybrid approach. Sites should not interpret this array but instead store it along with the rest of the credential information. In a subsequent navigator.credentials.get()
call, the transports
value(s) specified inside publicKey.allowCredentials
should be set to the stored array value. This provides a hint to the browser as to which types of authenticators to try when making an assertion for this credential.
Syntax
getTransports()
Parameters
None.
Return value
An Array
of strings representing the different transports supported by the authenticator, in lexicographical order. Values may include:
"ble"
: The authenticator may be used over BLE (Bluetooth Low Energy)."hybrid"
: The authenticator can be used over a combination of (often separate) data transport and proximity mechanisms. This supports, for example, authentication on a desktop computer using a smartphone."internal"
: The authenticator is specifically bound to the client device (cannot be removed)."nfc"
: The authenticator may be used over NFC (Near Field Communication)."usb"
: The authenticator can be contacted over USB.
Examples
See Creating a public key credential using the WebAuthn API for a detailed example.
Specifications
Specification |
---|
Web Authentication: An API for accessing Public Key Credentials - Level 3 # dom-authenticatorattestationresponse-gettransports |
Browser compatibility
BCD tables only load in the browser