Change device date and time on BrowserStack real devices

You can change the date or time on BrowserStack devices while running an appium test session to test functionalities such as timers, timed notifications or alerts, and more present in your app. App Automate supports this feature through an automated test script.

In this guide, you will learn about

• Supported functionalities on devices and OS
• How to set the device date and time via custom BrowserStack javascript executor

Supported functionalities on devices and OS

The following table lists the devices and OS versions on which different functionalities are currently supported:

Set the device date and time using custom BrowserStack executor

iOS

Set the action type as updateIosDeviceSettings and provide the desired device time as input to the argument customTime in the BrowserStack JavaScript executor to change the device time while running the test sessions.

The following table lists the allowed input values for customTime argument:

As an example, the following code snippet demonstrates how to use the BrowserStack JavaScript executor to change the device time to 14:05:

JavascriptExecutor jse = (JavascriptExecutor)driver;
jse.executeScript("browserstack_executor: {
          \"action\":\"updateIosDeviceSettings\", 
          \"arguments\": {
            \"customTime\" : \"14:05\"
         }
     }"
);

await driver.execute("browserstack_executor: {
          \"action\":\"updateIosDeviceSettings\", 
          \"arguments\": {
            \"customTime\" : \"14:05\"
         }
     }"
);

driver.execute_script("browserstack_executor: {
           \"action\":\"updateIosDeviceSettings\", 
          \"arguments\": {
            \"customTime\" : \"14:05\"
         }
     }"
);

caps["javascriptEnabled"] = "true" #include this capability for JavaScript executors to work
driver.execute_script("browserstack_executor: {
          \"action\":\"updateIosDeviceSettings\", 
          \"arguments\": {
            \"customTime\" : \"14:05\"
         }
     }"
);

((IJavaScriptExecutor)driver).ExecuteScript("browserstack_executor: {
          \"action\":\"updateIosDeviceSettings\", 
          \"arguments\": {
            \"customTime\" : \"14:05\"
         }
     }"
);

Android

Set the action type as updateAndroidDeviceSettings and provide the desired device date and time as input to the argument customDate and customTime respectively in the BrowserStack JavaScript executor to change the device date and time while running the test sessions.

The following table lists the allowed input values for customDate and customTime arguments:

As an example, the following code snippet demonstrates how to use the BrowserStack JavaScript executor to change the device date to Sep 15 2023 and time to 14:05:

JavascriptExecutor jse = (JavascriptExecutor)driver;
jse.executeScript("browserstack_executor: {
          \"action\":\"updateAndroidDeviceSettings\", 
          \"arguments\": {
            \"customDate\" : \"Sep 15 2023\",
            \"customTime\" : \"14:05\"
         }
     }"
);

await driver.execute("browserstack_executor: {
          \"action\":\"updateAndroidDeviceSettings\", 
          \"arguments\": {
            \"customDate\" : \"Sep 15 2023\",
            \"customTime\" : \"14:05\"
         }
     }"
);

driver.execute_script("browserstack_executor: {
           \"action\":\"updateAndroidDeviceSettings\", 
          \"arguments\": {
            \"customDate\" : \"Sep 15 2023\",
            \"customTime\" : \"14:05\"
         }
     }"
);

caps["javascriptEnabled"] = "true" #include this capability for JavaScript executors to work
driver.execute_script("browserstack_executor: {
          \"action\":\"updateAndroidDeviceSettings\", 
          \"arguments\": {
            \"customDate\" : \"Sep 15 2023\",
            \"customTime\" : \"14:05\"
         }
     }"
);

((IJavaScriptExecutor)driver).ExecuteScript("browserstack_executor: {
          \"action\":\"updateAndroidDeviceSettings\", 
          \"arguments\": {
            \"customDate\" : \"Sep 15 2023\",
            \"customTime\" : \"14:05\"
         }
     }"
);

Related topics

Check this page for a list of various JavaScript Executors that BrowserStack offers.