Skip to main content

[Mobile] Use Fingerprint

  • Katalon Studio version 8.3.0 onwards.


Simulate a fingerprint touch event on Android emulators.

  • To enable this keyword, at least one fingerprint must be enrolled on the emulator via Android Debug Bridge (adb).
  • To learn more about adb, refer to this document on the Android developer site: Android Debug Bridge.
  • To learn how to enroll a fingerprint with adb, please refer to the following Android developer guide: Fingerprint Authentication.


ParameterParameter TypeMandatoryDescription
fingerprintIdIntYesAn Android fingerprint ID (from 1 to 10).
flowControlFailureHandlingNoSpecify failure handling schema to determine whether the execution should be allowed to continue or stop. Refer to: Failure Handling.


IllegalArgumentExceptionIf the input value for Android fingerprint ID is invalid.Please enter a valid Android fingerprint ID (from 1 to 10).
StepFailedExceptionIf the useFingerprint keyword is not performed on an Android emulator.The useFingerprint keyword supports Android emulators only.
WarningIf the useFingerprint keyword is run on unsupported environments.The useFingerprint keyword is not available for physical mobile devices.


import static com.kms.katalon.core.checkpoint.CheckpointFactory.findCheckpoint 
import static com.kms.katalon.core.testcase.TestCaseFactory.findTestCase
import static com.kms.katalon.core.testdata.TestDataFactory.findTestData
import static com.kms.katalon.core.testobject.ObjectRepository.findTestObject
import static com.kms.katalon.core.testobject.ObjectRepository.findWindowsObject
import com.kms.katalon.core.checkpoint.Checkpoint as Checkpoint
import com.kms.katalon.core.cucumber.keyword.CucumberBuiltinKeywords as CucumberKW
import as Mobile
import com.kms.katalon.core.model.FailureHandling as FailureHandling
import com.kms.katalon.core.testcase.TestCase as TestCase import com.kms.katalon.core.testdata.TestData as TestData
import com.kms.katalon.core.testng.keyword.TestNGBuiltinKeywords as TestNGKW
import com.kms.katalon.core.testobject.TestObject as TestObject
import com.kms.katalon.core.webservice.keyword.WSBuiltInKeywords as WS
import com.kms.katalon.core.webui.keyword.WebUiBuiltInKeywords as WebUI
import as Windows
import internal.GlobalVariable as GlobalVariable import org.openqa.selenium.Keys as Keys

'Start application on the current selected Android emulator'
Mobile.startApplication('/Users/katalon/Downloads/Fingerprint.apk', true)

'Simulate fingerprint touch with the desired fingerprint ID'

'Authentication is valid, do some actions'

'Close application on the current selected Android emulator'