add lambdatest example

Author: ptrthomas

README.md

@@ -40,12 +40,13 @@ This repository also contains examples of how to use Karate and demonstrates int
 * [GitHub Codespaces](https://github.com/karatelabs/karate/wiki/Get-Started:-GitHub-Codespaces) - open a GitHub project directly in a browser and run and edit Karate tests
 * [gRPC](grpc/README.md) - How to test gRPC services with Karate
 * [Gatling](https://github.com/karatelabs/karate/tree/master/karate-gatling) - Karate can re-use API functional tests as performance tests !
-* [Kafka](kafka/README.md) - Using the power of Karate Java interop to test Kafka and async flows
 * [JUnit](https://github.com/karatelabs/karate#junit-5) - There is also a [pure Java API](https://github.com/karatelabs/karate#parallel-execution) to run tests from any Java unit-testing framework such as TestNG
+* [Kafka](kafka/README.md) - Using the power of Karate Java interop to test Kafka and async flows
+* [Lambdatest](lambdatest/README.md) - How to configure Karate to run tests on Lambdatest
 * [NPM](https://github.com/karatelabs/karate-npm) - there is an option to install Karate as a NPM package and use it from Node / JS
 * [Quarkus](quarkus/README.md) - Karate is a good fit for integration testing Quarkus applications
 * [RabbitMQ](rabbitmq/README.md) - Using Java to send and receive messages with RabbitMQ
-* [Sauce Labs](sauce-labs/README.md) - How to configure Karate to run tests on Sauce Labs
+* [Sauce Labs](saucelabs/README.md) - How to configure Karate to run tests on Sauce Labs
 * [Spring Boot](spring-boot/README.md) - Resources on testing Spring Boot applications with Karate
 * [WebSockets](websockets/README.md) - Built-in support for WebSockets or you can use Java interop for very advanced scenarios
 * [Xray](https://docs.getxray.app/display/XRAYCLOUD/Testing+APIs+using+Karate+DSL) - Official documentation from the Xray team on how to integrate Karate

lambdatest/README.md

@@ -0,0 +1,32 @@
+# Karate and Lambdatest
+
+Karate supports the [W3C WebDriver protocol](https://www.w3.org/TR/webdriver) and can be used to run tests on [Lambdatest](https://www.lambdatest.com).
+
+The [example in this folder](lambdatest.feature) demonstrates how to run a test on Lambdatest using Karate. All you need is a Lambdatest account and values such as the URL, user, key etc.
+
+From your Lambdatest profile, you can get the values you need.
+
+There may be differences such as needing the "username" and "accessKey" instead of the user details encoded in the URL.
+
+All you need to do in Karate is perform the [`configure driver` step](https://github.com/karatelabs/karate/tree/master/karate-core/#configure-driver) as per the documentation. Note how `LT:Options` are added to the WebDriver "capabilities":
+
+```cucumber
+  * def session = { capabilities: { alwaysMatch: { browserName: 'chrome', browserVersion: 'latest', platformName: 'Windows 11', 'LT:Options': '#(lambdaTestOptions)' } } }
+  * configure driver = { type: 'chromedriver', start: false, webDriverSession: '#(session)', webDriverUrl: '#(lambdaTestUrl)' }
+```
+
+Of course you can change the `browserVersion` and `platformName` to suit your needs. You will have to ensure that the Karate driver type matches the `browserName`, for example `chromedriver` for `chrome`. Refer to the [Karate documentation](https://github.com/karatelabs/karate/tree/master/karate-core/#driver-types) for all possible types.
+
+Also refer to the documentation of [`webDriverSession`](https://github.com/karatelabs/karate/tree/master/karate-core/#webdriversession) and [`webDriverUrl`](https://github.com/karatelabs/karate/tree/master/karate-core/#webdriverurl) for more details.
+
+Note that for a typical test-suite, you will set variables via the [`karate-config.js`](https://github.com/karatelabs/karate/#karate-configjs) so you can switch browsers or between local and remote execution.
+
+## Further Reading
+
+* [Karate and Lambdatest on Stack Overflow](https://stackoverflow.com/search?q=%5Bkarate%5D+lambdatest)
+* [Running UI Tests in parallel](https://stackoverflow.com/a/60387907/143475)
+
+
+
+
+

lambdatest/lambdatest.feature

@@ -0,0 +1,17 @@
+Feature: lambdatest automation demo
+
+Background:
+  # enter the values for the next few lines from your lambatest account
+  * def lambdaTestUser = ''
+  * def lambdaTestKey = ''
+  * def lambdaTestUrl = 'https://hub.lambdatest.com/wd/hub'
+  * def lambdaTestOptions = { project: '#(karate.feature.prefixedPath)', username: '#(lambdaTestUser)', accessKey: '#(lambdaTestKey)' }
+  * def session = { capabilities: { alwaysMatch: { browserName: 'chrome', browserVersion: 'latest', platformName: 'Windows 11', 'LT:Options': '#(lambdaTestOptions)' } } }
+  * configure driver = { type: 'chromedriver', start: false, webDriverSession: '#(session)', webDriverUrl: '#(lambdaTestUrl)' }
+
+Scenario: try to login to github and check for expected error message
+  * driver 'https://github.com/login'
+  * input('#login_field', 'XXXX')
+  * input('#password', 'world')
+  * submit().click("input[name=commit]")
+  * match html('.flash-error') contains 'Incorrect username or password.'    

sauce-labs/README.md renamed to saucelabs/README.md

@@ -1,8 +1,8 @@
 # Karate and Sauce Labs
 
-Karate supports the [W3C WebDriver protocol](https://www.w3.org/TR/webdriver) and can be used to run tests on Sauce Labs.
+Karate supports the [W3C WebDriver protocol](https://www.w3.org/TR/webdriver) and can be used to run tests on [Sauce Labs](https://saucelabs.com).
 
-The [example in this folder](sauce-labs.feature) demonstrates how to run a test on Sauce Labs using Karate. All you need is a Sauce Labs account and the values of the Sauce Labs "build" and the URL to connect to.
+The [example in this folder](saucelabs.feature) demonstrates how to run a test on Sauce Labs using Karate. All you need is a Sauce Labs account and values such as the URL, user, key etc.
 
 From your Sauce Labs dashboard, you can get the values you need from the quickstart guide for Selenium / Java. Here is a screenshot showing which sections you can focus on:
 

sauce-labs/sauce-labs.feature renamed to saucelabs/saucelabs.feature

@@ -1,7 +1,7 @@
 Feature: sauce labs automation demo
 
 Background:
-  # enter the values for the next 2 lines from your sauce labs account
+  # enter the values for the next few lines from your sauce labs account
   * def sauceLabsBuild = ''
   * def sauceLabsUser = ''
   * def sauceLabsKey = ''