A Complete Guide on how to run Mocha npm Testing with Node.js
Kayode Oluwasegun
Posted On: January 16, 2023
226124 Views
16 Min Read
This article is a part of our Content Hub. For more in-depth resources, check out our content hub on Mocha JS Tutorial and Mocha Unit Testing Tutorial.
Software testing is integral to software engineering. Tests are created as key checkpoints to verify whether objectives are being met or not. For instance, you are building a web chat application and need to add a new feature to the app. Testing gives you the confidence to be able to refactor and add new features with the assurance that the app’s old verifiable functions are tested.
In this Mocha NodeJS tutorial, you will get in-depth insights on how to write assertions using the NodeJS assert module while performing Selenium automation testing with Mocha framework.
So let’s begin this Mocha NodeJS tutorial with a cup of coffee! If you are preparing for an interview you can learn more through Mocha interview questions.
TABLE OF CONTENTS
What are Assertions?
Assertions are test conditions that must be verified to determine whether certain software development objectives are being met. The inclusion of “conditions” in this definition indicates that it encapsulates some testable logic that should be verified as specified about a target under the test.

So to verify a particular behavior, we can assert a series of logical conditions that satisfy the design of that behavior.
For instance, to verify the behavior of a carting system, we may simply assert:
- that adding a product to the cart increases the total price of the cart by the amount of the product added.
- that removing a product from the cart reduces the cart’s total price by the amount of the product removed.
To verify that the function conforms to the requirement of adding two numbers.
Common Asserts with NodeJS assert module
The assert
module provides a set of assertion functions to verify testing expressions. If the functions provided by this module evaluate to 0
or false
, the function raises an exception, AssertionError, which might cause the program to terminate if not handled.
assert.equal
It tests the shallow, coercive equality between two parameters using the == operator.
Syntax:
Example:
assert.notEqual
It tests the shallow, coercive inequality between two parameters using the != operator.
Syntax:
Example:
assert.deepEqual
It tests for deep equality between the actual and expected arguments.
Syntax:
Example:
assert.notDeepEqual
It verifies that deep equality exists between the actual and expected arguments.
Syntax:
Example:
assert.match
It tests for a regular expression match between the actual and expected arguments.
Syntax:
Example:
assert.doesNotMatch
It tests that there’s no regular expression match between the actual and expected arguments.
Syntax:
Example:
assert.ok
It tests if a value is truthy.
Syntax:
Example:
assert.throws
It expects a function to throw an error.
Syntax:
Example:
assert.doesNotThrow
It verifies that a function does not throw an error.
Syntax:
Example:
What is Mocha framework?
Mocha is a feature-rich JavaScript test framework running on NodeJS and the browser. With Mocha, you can label test cases and group them in test suites, allowing for flexible and accurate reporting while mapping uncaught exceptions to the correct test cases.

Mocha is a test runner similar to Jasmine. Mocha was created 11 years ago, three years before Jasmine. With higher downloads over Jasmine for the past year. Mocha has a large number of community members who regularly contribute to making the project better.
This package fits perfectly into the AAA (Arrange, Act, Assert) practice which is a common practice for writing unit tests:
- Arrange – This section describes the setup required to execute the test. With Mocha, we can arrange and label different test cases, teardowns, setup mocks, etc.
- Act – This section executes the unit being tested, with the output being a store for evaluation. Mocha can run operations like UI interactions, running functions, mocks, etc.
- Assert – This section verifies whether the tests behaved as per expectations. This is where we use the NodeJS assert library.
Mocha allows us to use any library of our choice for assertions, so we use the NodeJS assert
module. As of the time of writing this Mocha NodeJS tutorial, the version of Mocha is v10.2.0
. If you are looking to run unit tests with Mocha, You can refer to our guide on Mocha unit testing.
Accelerate JavaScript Automation with Mocha. Try LambdaTest Now!
Installing Mocha and Running a Sample Test
To install Mocha, you will first need to have NodeJS and npm (Node Package Manager) installed on your computer.
Prerequisites
- NodeJS: This can be downloaded from here. We can verify if NodeJS is installed on our machine by running this command (
node --version
) in our terminal: - IDE: Although I will be using Visual Studio Code, you can use any code editor of your choice.
Once you have those installed, you can install Mocha globally by running the following command in your terminal:
The -g
flag will install the package globally so that you can use the package as an executable command in your terminal.
We will write a function, sum
to add two numbers, and export it from an app.js
file.
Next, we define the test structure in app.test.js
as below.
The describe
and it
functions are globals provided by Mocha used to set up test suites and also for preconditions and clean-ups after tests. If we run the test, Mocha would pass it because Mocha would not fail unless it gets an exception.
Now, the assert library can help us test some conditions and throw an exception if the results are false. So we will update the test.
Run the test by running this command in our terminal.
Add we get a result as such:
Writing a cross browser test using NodeJS Asserts
In this section of the Mocha NodeJS tutorial, we will look at how to write a cross browser test using NodeJS asserts.
Having the setups required for this Mocha NodeJS tutorial, we can write a cross browser test using Selenium to run on a Cloud Grid infrastructure.
We verify the behaviors of an eCommerce web application by running tests that match the test scenarios listed below.
Test Scenario 1 (Add product to cart)
- Go to https://ecommerce-playground.lambdatest.io/.
- Click on the MacBook Pro product.
- Add the product to the cart.
- Verify that the number on the cart icon is 1.
Test Scenario 2 (Not Register Account With Existing Account)
- Go to https://ecommerce-playground.lambdatest.io/index.php?route=account/login.
- Click on the Register button.
- Fill out the registration form.
- Check the terms and conditions checkbox.
- Submit the registration form.
- Verify that no account successful creation message is displayed.
Test Scenario 3 (Register Account With Existing Account)
- Go to https://ecommerce-playground.lambdatest.io/index.php?route=account/login.
- Click on the Register button.
- Fill out the registration form.
- Check the terms and conditions checkbox.
- Submit the registration form.
- Verify that an account is created.
Test Setup
For this Mocha NodeJS tutorial, we will create a new directory called ecommerce_test
in any directory of your choice by running the command below in your terminal:
To use the cloud Selenium Grid provided by LambdaTest, we need an access key from the LambdaTest Dashboard.
With LambdaTest continuous quality cloud platform, you can run Selenium automation scripts over an online Selenium Grid of 3000+ real desktop and mobile browsers. It helps you test on a wide range of Windows and macOS platforms, along with legacy and latest browsers.

Please subscribe to the LambdaTest YouTube Channel and stay updated with the latest tutorials on Selenium testing, Cypress testing, CI/CD, and more.
However, it’s not recommended to keep secret keys tracked by Git, so we would create a .env
file in the root of ecommerce_test/
by running the command below:
Copy the code below to the .env
file replacing
and
with the credentials you got from LambdaTest.
To embed the value from .env
as an environment variable, we would use the package dotenv
by running the commands below:
The command above creates a package.json
in our root directory while the -y flag accepts the defaults for the command’s prompt. check this software testing question to update dependencies in package.json.
Then we will install dotenv
by running the command:
We also need to install selenium-webdriver
, which we will use to interact with a web application we are testing. Install the package by running the command:
The file structure of the project should look similar to this:
Implementation
In this Mocha NodeJS tutorial, we will run the tests directly using a Selenium Cloud Grid to take advantage of using the benefits of cross browser testing on the cloud.
First, we’d create a single.conf.js
file to configure how the cloud grid would run our tests to utilize its features. Then copy the code below into the single.conf.js
file:
Then using the design pattern of the Page Object Model, we will create a class that can create an object repository of all web UI elements. In this object, methods are named according to the operation they are performing.
In the root of ecommerce_test
, create a file called homepage.js
and a directory named pageobject
by running the command:
The project directory should look similar to this:
Then copy the code below into the homepage.js
.
Next in this Mocha NodeJS tutorial, we will create a new file, named ecommerce.test.js
in a folder named __tests__
, then copy the code below into the ecommerce.test.js
file:
Code Walkthrough
The ./single.conf.js
file is used to set up the configuration of our cloud grid, LambdaTest. We can utilize the various features of our cloud grid provider using the configuration file.
In this Mocha NodeJS tutorial, we leave it at a simple configuration running on a single process with a Chrome browser on a Windows 10 machine.
To learn more about LambdaTest configuration, you can check this document on Desired Capabilities.
The ./pageobject/homepage.js
exports a ECommerceHomePage
class, which is designed as a pattern of the Page Object Model. The class constructor initializes properties that are selectors for elements in the website we are testing together with asynchronous methods that perform very specific operations.
We got the selectors used in the test by inspecting the elements on our browser and selecting them using the webdriver.By.css()
method. The webdriver.By.css()
method takes a string argument similar to document.querySelector()
.
To get the selectors of the element:
- Right-click on the element and select Inspect.
- In the Element tab on Chrome DevTools, right-click on the HTML tag of the elements you are targeting.
- Hover over Copy option.
- Click on Copy selector to copy the selector of the particular element.
If you have control over the web application, I’d recommend passing a special attribute solely for testing. For instance;
Then in tests, get the element using the attribute data-testid
:
The ECommerceHomePage
constructor takes a Selenium WebDriver as an argument which provides methods, such as findElement()
and click()
, used to interact with the website under test.
To pass a Selenium WebDriver to ECommerceHomePage
, we created a function in the file ./__tests__/ecommerce.test.js
and created a function called buildDriver
:
buildDriver
takes a capability object exported from a single.conf.js
file and then uses the WebDriver Builder
function to build the driver.
The pageobject/
directory contains files that export a class that implements Page Object Model.
Running the Test
Run the test using Mocha by running the command below in your terminal.
Then we can see the result in our terminal as such:
The tests labeled can add to shopping cart and should not register when username is taken passed while the last test failed because of an AssertError
exception from the line below:
Because we are trying to create another account with the same user credentials used from the second test, the third test will fail to create an account causing the assert
to fail.
Checking the test on LambdaTest
- Login to your LambdaTest Dashboard.
- Go to the Automate tab to view your tests.
You can see the status of each test case that ran and its duration:
Click on a test case to further reveal more metrics and a video about the test.
In addition, you can also evaluate high-impact quality issues with the LambdaTest Test Analytics platform – a detailed test analytics and observation suite. LambdaTest makes it fast and easier to unify all test data on a centralized analytics platform to help you make an informed decision.
If you want to excel in any JavaScript automation role, this certification will give you the in-depth knowledge and essential skills needed to be successful in automation testing as a JavaScript developer.
Conclusion
Assertions are integral to software testing. They constitute the third A in the triple-A(AAA) mechanism which stands for assertions. Assertions verify the logical conformance to software requirements.
At the end of this Mocha NodeJS tutorial, we explored what assertions are, wrote simple assertions using the NodeJS assert
module, and learned some of the common NodeJS assert
methods.
Then we wrote some automated UI tests using Selenium, performed operations, verified the result using some NodeJS assert
methods, and ran the tests on a LambdaTest – our Selenium cloud grid provider.

2M+ Devs and QAs rely on LambdaTest
Deliver immersive digital experiences with Next-Generation Mobile Apps and Cross Browser Testing Cloud
Frequently Asked Questions (FAQs)
What is Mocha in NodeJS?
Mocha is a JavaScript test framework for NodeJS. It provides a simple and flexible interface for testing code and can be used to test both synchronous and asynchronous code. Mocha allows you to write test suites and test cases and provides various functions and hooks for running and reporting on those tests.
Which is better jest or Mocha?
Both Jest and Mocha are popular JavaScript testing frameworks, and they have similar functionality for running tests, creating test suites and test cases, and generating test reports. Jest might be the better choice if you’re looking for a complete testing solution that’s easy to set up and use. If you want a more flexible, customizable testing setup, Mocha might be the way to go. Ultimately, the choice between Jest and Mocha will depend on the specific needs of your project and your personal preference.
Got Questions? Drop them on LambdaTest Community. Visit now