Test using passcode-protected devices

For certain use cases, you might need to perform tests on devices that are passcode-protected. Some apps that deal with sensitive data, such as banking apps, require devices to be protected with a passcode as a layer of security.

Since BrowserStack remote devices are not passcode-protected as a default, App Automate provides the capability to use in the test script for getting access to passcode-protected devices.

In this guide, you’ll learn:

• Supported OS versions
• How to set the browserstack.enablePasscode capability
• How to unlock device during test execution

Supported OS versions

Currently, this feature is supported on the following OS versions:

• Android: version 8.0 and above
• iOS: version 13.0 and above

Set the capability

Use the passcode capability to enable the passcode protection in your test scripts:

DesiredCapabilities capabilities = new DesiredCapabilities();
HashMap<String, Object> browserstackOptions = new HashMap<String, Object>();
browserstackOptions.put("enablePasscode", "true");

var capabilities = {
    'bstack:options' : {
        "enablePasscode" : "true",
    },
}

desired_cap = {
	'bstack:options' : {
		"enablePasscode" : "true",
	},
}

capabilities = {
    'bstack:options' => {
        "enablePasscode" => "true",
    },
}

AppiumOptions capabilities = new AppiumOptions();
Dictionary<string, object> browserstackOptions = new Dictionary<string, object>();
browserstackOptions.Add("enablePasscode", "true");

DesiredCapabilities desiredCapabilities = new DesiredCapabilities();
desiredCapabilities.setCapability("browserstack.enablePasscode", "true");

var capabilities = {
    "browserstack.enablePasscode" : "true"
}

desired_cap = {
	"browserstack.enablePasscode" : "true"
}

desired_caps = {
    "browserstack.enablePasscode" => "true"
}

DesiredCapabilities capability = new DesiredCapabilities();
desiredCapabilities.SetCapability("browserstack.enablePasscode", "true");

Sample code to unlock device

To unlock a device during testing, if required, use the information in the following tabs.

// your test script goes here

driver.unlockDevice();// to unlock the device

// your test script goes here

driver.unlockDevice(); // to unlock the device

# your test script goes here

driver.unlock();# to unlock the device

# your test script goes here
  
driver.unlock #to unlock the device

// your test script goes here
driver.Unlock();// to unlock the device

Need some help?

If you need any help with this feature, get in touch with us.