AuthenticatorAttestationResponse: getTransports() method
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since October 2023.
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 for a detailed example.
Specifications
| Specification |
|---|
| Web Authentication: An API for accessing Public Key Credentials - Level 3 # dom-authenticatorattestationresponse-gettransports |
Browser compatibility
| desktop | mobile | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
getTransports
|
|
|
|
|
|
|
|
|
|
|
|
|
Legend
Tip: you can click/tap on a cell for more information.
- Full support
- Full support
- No support
- No support