PublicKeyCredential: rawId-Eigenschaft

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2021.

Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.

Die schreibgeschützte rawId-Eigenschaft des PublicKeyCredential-Interfaces ist ein ArrayBuffer-Objekt, das die Kennung der Anmeldeinformationen enthält.

Die PublicKeyCredential.id-Eigenschaft ist eine base64url kodierte Version dieser Kennung.

Hinweis: Diese Eigenschaft kann nur in obersten Kontexten verwendet werden und ist zum Beispiel in einem <iframe> nicht verfügbar.

Wert

Ein ArrayBuffer, der die Kennung der Anmeldeinformationen enthält. Diese Kennung soll global eindeutig sein und ist für die aktuelle PublicKeyCredential und ihre zugehörige AuthenticatorAssertionResponse bestimmt.

Beispiele

js
const options = {
  challenge: new Uint8Array(26) /* from the server */,
  rp: {
    name: "Example CORP",
    id: "login.example.com",
  },
  user: {
    id: new Uint8Array(26) /* To be changed for each user */,
    name: "canand@example.com",
    displayName: "Carina Anand",
  },
  pubKeyCredParams: [
    {
      type: "public-key",
      alg: -7,
    },
  ],
};

navigator.credentials
  .create({ publicKey: options })
  .then((pubKeyCredential) => {
    const rawId = pubKeyCredential.rawId;
    // Do something with rawId
  })
  .catch((err) => {
    // Deal with any error
  });

Spezifikationen

Specification
Web Authentication: An API for accessing Public Key Credentials - Level 3
# ref-for-dom-publickeycredential-rawid

Browser-Kompatibilität

BCD tables only load in the browser