webauthn

Register and authenticate passkeys via the Credential Management / WebAuthn API (navigator.credentials).

Import: @rtorcato/browser-common/webauthn

📖 MDN: Web Authentication API · 📊 caniuse: webauthn

createCredential/getCredential need a secure context and throw where Credential Management is unsupported — guard with isWebAuthnAvailable().

Browser support

API	Chrome	Edge	Firefox	Safari	iOS Safari	Baseline
PublicKeyCredential	✅ 67+	✅ 18+	✅ 60+ [1]	✅ 13+	✅ 13+	Widely available
CredentialsContainer.create	✅ 60+	✅ 18+	✅ 60+	✅ 13+	✅ 13+	Widely available

1. Firefox: Only supports USB U2F tokens.

✅ supported · ◐ partial · ❌ not supported · [n] see note. Generated from MDN browser-compat-data and web-features. caniuse: PublicKeyCredential · CredentialsContainer.create

Example

import {
  isWebAuthnAvailable,
  createCredential,
  getCredential,
} from '@rtorcato/browser-common/webauthn'

if (isWebAuthnAvailable()) {
  const credential = await createCredential({ publicKey })
  const assertion = await getCredential({ publicKey })
}

Exports

• isWebAuthnAvailable() — feature check
• createCredential(options?) — registers a new credential via navigator.credentials.create
• getCredential(options?) — retrieves an existing credential via navigator.credentials.get

See the API reference for full signatures.