Repository files navigation

TestNG Integration with BrowserStack.

This repository showcases the use ofBrowserStack's Cross-Device Automation Agent for web automation using TestNG and Selenium. The key feature is the ability to write test steps inNatural Language (Plain English), moving away from explicit Selenium locators and actions.

It contains a demo script:

• BstackAIAuthoring.java: Runs complex test objectives (like selecting a product in a specific price range or navigating to a quote page) using simple English commands.

1. Enablement: The feature is enabled by declaring the capabilityaiAuthoring: true in yourbrowserstack.yml configuration file.
2. The Command: Inside the test script (BstackAIAuthoring.java), the test uses a standard SeleniumJavascriptExecutor to pass the Natural Language instruction to the BrowserStack environment:

   // Example Objective: Find Google Pixel 3 phone on the website and add 5 of them to the cartjse.executeScript("browserstack_executor: {\"action\":\"ai\",\"arguments\": [\" Click on the Google button and Add 5 Pixel 3 phones to cart\"]}");

3. Execution: The BrowserStack Cross-Device Automation Agent intercepts this command, interprets the natural language, and executes the equivalent low-level Selenium actions on the target web page.

• Clone the repository
• ReplaceYOUR_USERNAME andYOUR_ACCESS_KEY with your BrowserStack access credentials inbrowserstack.yml.
• Declare capabilityaiAuthoring: true inbrowserstack.yml file (if not already present).
• Install dependenciesmvn compile
• To run the test suite having cross-platform with parallelization, runmvn test -P sample-test.
• To run local tests, runmvn test -P sample-local-test.

Understand how many parallel sessions you need by using ourParallel Test Calculator.

• Add maven dependency ofbrowserstack-java-sdk in yourpom.xml file:

  <dependency>    <groupId>com.browserstack</groupId>    <artifactId>browserstack-java-sdk</artifactId>    <version>LATEST</version>    <scope>compile</scope></dependency>

• Modify your build plugin to run tests by addingargLine -javaagent:${com.browserstack:browserstack-java-sdk:jar} in the Surefire plugin configuration.
• Install dependenciesmvn compile.

• If using Gradle, Java v9+ is required.

• Clone the repository
• Install dependenciesgradle build
• To run the test suite having cross-platform with parallelization, rungradle sampleTest.
• To run local tests, rungradle sampleLocalTest.

• AddcompileOnly 'com.browserstack:browserstack-java-sdk:latest.release' in dependencies in yourgradle.build.
• Fetch Artifact Information and addjvmArgs property in tasksSampleTest andSampleLocalTest.
• Install dependenciesgradle build.

• You can view your test results on theBrowserStack Automate dashboard.
• For detailed documentation on general Selenium and Java setup with BrowserStack Automate, please refer to theofficial documentation.

If you are running into any issues or have any queries, please checkBrowserstack Support page orget in touch with us.