AuthenticatorAttestationResponse.getTransports()

Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.  getTransports() is a method of the AuthenticatorAttestationResponse interface that returns an Array containing strings describing the different transports which may be used by the authenticator.   Such transports may be USB, NFC, BLE or internal (applicable when the authenticator is not removable from the device).    Note: An AuthenticatorAttestationResponse instance is available on PublicKeyCredential.response after calling navigator.credentials.create().     Note: This method may only be used in top-level contexts and will not be available in an <iframe> for example.  

Syntax
getTransports()

Parameters
None.
Return value

 An Array containing the different transports supported by the authenticator or nothing if this information is not available. The elements of this array are supposed to be in lexicographical order. Their values may be :   
"usb": the authenticator can be contacted via a removable USB link 
"nfc": the authenticator may be used over NFC (Near Field Communication)
 
"ble": the authenticator may be used over BLE (Bluetooth Low Energy)
  "internal": the authenticator is specifically bound to the client device (cannot be removed).  

Examples
var publicKey = {
  challenge: /* from the server */,
  rp: {
    name: "Example CORP",
    id  : "login.example.com"
  },
  user: {
    id: new Uint8Array(16),
    name: "timothy23@example.com",
    displayName: "John Doe"
  },
  pubKeyCredParams: [
    {
      type: "public-key",
      alg: -7
    }
  ]
};

navigator.credentials.create({ publicKey })
  .then(function (newCredentialInfo) {
    var transports = newCredentialInfo.response.getTransports();
    console.table(transports); // may be something like ["internal", "nfc", "usb"]
  }).catch(function (err) {
     console.error(err);
  });

Specifications

Specification
Web Authentication: An API for accessing Public Key Credentials - Level 3 # dom-authenticatorattestationresponse-gettransports

Browser compatibility




Desktop
Mobile



Chrome
Edge
Firefox
Internet Explorer
Opera
Safari
WebView Android
Chrome Android
Firefox for Android
Opera Android
Safari on IOS
Samsung Internet



getTransports
74
79
No
No
62
No
No
74
No
53
No
No




Found a problem with this page?

Edit on GitHub
Source on GitHub
Report a problem with this content on GitHub
Want to fix the problem yourself? See our Contribution guide.


Last modified: Apr 16, 2022, by MDN contributors


    
{'path': 'public/docs/dom/authenticatorattestationresponse/gettransports.html', 'source': 'DevDocs.IO'}