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(Fixed as of February 2021. See here)fetch
within click handlers for requesting WebAuthn registration and authentication options.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)