Skip to main content

Quick Guide To Run Node.js Tests On Cloud Selenium Grid

LambdaTest’s Selenium grid enables you to perform end-to-end automation tests on a secure, reliable, and scalable Selenium cloud infrastructure. You can run your Node.js automation test scripts on 2000+ browser and operating system environments giving you higher test coverage and significantly less built times. This document will help you quickly get started with running your Node.js test scripts on the LambdaTest Selenium automation grid.


  • The first step is to download and install Node.js and node package manager or npm. We recommend using the latest version of node.js.

  • You can download it from here.

  • If you have npm already installed, you may want to upgrade it to the latest version. Here the code you can run in your terminal to upgrade npm.

      npm install [email protected] -g

Installing Selenium Dependencies For Node.js#

The next step is to install Selenium dependencies for Node.js using npm. Here’s the command that you can run:

    npm i selenium-webdriver

Sample Node.js & Selenium Test To Get You Started#

Once you have installed the necessary dependencies, you are all set to run your Node.js automation scripts on the LambdaTest Selenium grid. To get started, you can try out the code below. It’s a simple Node.js script that opens up, searches LambdaTest in Google search, and then outputs the search result page's title. You can also fork it from our Node.js GitHub repository. Make sure to create the JS file in the same folder where you have downloaded Selenium.

Sample Node.js & Selenium Automation Script#

Do make sure to add the Username and Key in the code below. You can find your username and access key using the key icon on the Automation dashboard or in your Profile section.

/*    LambdaTest selenium automation sample example    Configuration    ----------    username: Username can be found at automation dashboard    accessKey:  AccessKey can be generated from automation dashboard or profile section     Result    -------    Execute NodeJS Automation Tests on LambdaTest Distributed Selenium Grid*/const webdriver = require('selenium-webdriver'); /*    Setup remote driver    Params    ----------    platform : Supported platform - (Windows 10, Windows 8.1, Windows 8, Windows 7,  macOS High Sierra, macOS Sierra, OS X El Capitan, OS X Yosemite, OS X Mavericks)    browserName : Supported platform - (chrome, firefox, Internet Explorer, MicrosoftEdge, Safari)    version :  Supported list of version can be found at*/ // username: Username can be found at automation dashboardconst USERNAME = '{YOUR_LAMBDATEST_USERNAME}'; // AccessKey:  AccessKey can be generated from automation dashboard or profile sectionconst KEY = '{YOUR_LAMBDATEST_ACCESS_KEY}'; // gridUrl: gridUrl can be found at automation dashboardconst GRID_HOST = ''; function searchTextOnGoogle() {    // Setup Input capabilities    const capabilities = {        platform: 'windows 10',        browserName: 'chrome',        version: '67.0',        resolution: '1280x800',        network: true,        visual: true,        console: true,        video: true,        name: 'Test 1', // name of the test        build: 'NodeJS build' // name of the build    }     // URL: https://{username}:{accessKey}    const gridUrl = 'https://' + USERNAME + ':' + KEY + '@' + GRID_HOST;     // setup and build selenium driver object    const driver = new webdriver.Builder()        .usingServer(gridUrl)        .withCapabilities(capabilities)        .build();     // navigate to a url, search for a text and get title of page    driver.get('').then(function() {        driver.findElement('q')).sendKeys('LambdaTest\n').then(function() {            driver.getTitle().then(function(title) {                setTimeout(function() {                    console.log(title);                    driver.quit();                }, 5000);            });        });    });}searchTextOnGoogle();

You can execute the test from your terminal through this command.

    node index.js

Do note the use of the remote webdriver here. We have passed browser environment configurations through the capabilities class. You can set the environment details as per your requirements.

To set up your own choice of environment for the test in the code, you can leverage our Capability Generator tool.

Tear Down: The tear down method helps the LambdaTest platform understand when the test’s execution is finished. It’s important to tear down each test, or else it will give timeout errors.

Last updated on