Skip to main content
Version: 6.0

Class: Device

Methods

getAvailableHardware

getAvailableHardware(): Promise<SupportedBiometricType[]>

Gets the types of biometrics the device supports.

Returns

Promise<SupportedBiometricType[]>

Usage


_10
const hardware = await Device.getAvailableHardware();
_10
hardware.forEach((biometricType) => console.log("Type: " + biometricType));


getBiometricStrengthLevel

getBiometricStrengthLevel(): Promise<BiometricSecurityStrength>

Checks the device biometric strength level.

On iOS this will always return 'strong'.

Returns

Promise<BiometricSecurityStrength>

Usage


_10
const biometricStrength = await Device.getBiometricStrengthLevel();


hasSecureHardware

hasSecureHardware(): Promise<boolean>

Check if the device has a secure hardware enclave.

Returns

Promise<boolean>

Usage


_10
const hasSecureHardware = await Device.hasSecureHardware();
_10
if (!hasSecureHardware) {
_10
// this device doesn't have secure hardware
_10
}


isBiometricsAllowed

isBiometricsAllowed(): Promise<BiometricPermissionState>

Returns the current state of biometric permissions.

On Android and iOS devices with TouchID, this always returns granted.

Returns

Promise<BiometricPermissionState>

Usage


_10
const permissions = await Device.isBiometricsAllowed();
_10
if (permissions === BiometricPermissionState.Denied) {
_10
// user must enable FaceID for the application...
_10
}


isBiometricsEnabled

isBiometricsEnabled(): Promise<boolean>

Check whether or not biometrics is supported by the device and has been configured by the current user of the device.

Returns

Promise<boolean>

Usage


_10
const biometricsEnabled = await Device.isBiometricsEnabled();
_10
if (!biometricsEnabled) {
_10
// biometrics not enabled on this device...
_10
}


isBiometricsSupported

isBiometricsSupported(): Promise<boolean>

Check whether or not biometrics is supported by the device.

Returns

Promise<boolean>

Usage


_10
const biometricsSupported = await Device.isBiometricsSupported();
_10
if (biometricsSupported) {
_10
// biometrics is supported on this device...
_10
}


isLockedOutOfBiometrics

isLockedOutOfBiometrics(): Promise<boolean>

Check whether biometrics are locked out on the device.

On Android, the locked out state will only known after an attempted biometric unlock.

Returns

Promise<boolean>

Usage


_10
const isLockedOut = await Device.isLockedOutOfBiometrics();
_10
if (isLockedOut) {
_10
// device is locked out ...
_10
}


isSystemPasscodeSet

isSystemPasscodeSet(): Promise<boolean>

Check whether the device OS-level passcode has been set.

Returns

Promise<boolean>

Usage


_10
const hasSystemPasscode = await Device.isSystemPasscodeSet();
_10
if (hasSystemPasscode) {
_10
// device has a system passcode
_10
}


showBiometricPrompt

showBiometricPrompt(config): Promise<void>

Show a biometric prompt.

Parameters

NameType
configPromptConfig

Returns

Promise<void>

Usage


_10
try {
_10
const promptConfig = {...};
_10
await Device.showBiometricPrompt(promptConfig);
_10
// biometric prompt succeeded successfully
_10
} catch (err) {
_10
// handle error
_10
}