Skip to main content

Safari Browser

When adding support for WebAuthn, special considerations must be made for the Safari browser on both iOS and macOS:

  • @simplewebauthn/browser's startRegistration() must be called in a native click listener. Some JS UI libraries, like VueJS, may not use native click handling without the use of framework-specific functionality like Vue's .native modifier.
  • Safari only supports the use of XHR and fetch within click handlers for requesting WebAuthn registration and authentication options. (Fixed as of February 2021. See here)
  • Not all browsers on iOS or macOS support Touch ID or Face ID. Check Supported Devices for more information on which iOS and macOS browsers support which Apple-specific hardware authenticator. (Fixed as of iOS 14.5. See here)