Node.js assert.rejects() Function Last Updated : 07 Aug, 2020 Comments Improve Suggest changes Like Article Like Report The assert module provides a set of assertion functions for verifying invariants. The assert.rejects() function awaits the asyncFn promise or if the asyncFn is a function then it immediately calls the function and awaits the returned promise to complete and after that it will then check that the promise is rejected. Syntax: assert.rejects(asyncFn[, error][, message]) Parameters: This function accepts following parameters as mentioned above and described below: asyncFn: This parameter is async function which throws an error synchronously. error: This parameter can be of type Class or a Regular expression or a validation function or an object where each property will be tested for. It is an optional parameter. message: This parameter will be the message provided by the AssertionError if the asyncFn fails to reject. It is an optional parameter. Return Value: This function returns assertion error of object type. Installation of assert module: You can visit the link to Install assert module. You can install this package by using this command. npm install assert Note: Installation is an optional step as it is inbuilt Node.js module. After installing the assert module, you can check your assert version in command prompt using the command. npm version assert After that, you can just create a folder and add a file for example, index.js as shown below. Example 1: Filename: index.js javascript // Requiring the module const assert = require('assert').strict; // Function call (async () => { assert.strictEqual(1,2) await assert.rejects( async () => { throw new TypeError('Wrong value'); }, (err) => { assert.strictEqual(err.name, 'TypeError'); assert.strictEqual(err.message, 'Wrong value'); return true; } ).then(() => { console.log("Reject Demo") }); })(); Steps to run the program: The project structure will look like this: Run index.js file using below command: node index.js Output: (node:12704) UnhandledPromiseRejectionWarning: AssertionError [ERR_ASSERTION]: Expected values to be strictly equal: 1 !== 2 at C:\Users\Lenovo\Downloads\Geeksforgeeks Internship\index.js:25:12 at Object. (C:\Users\Lenovo\Downloads\Geeksforgeeks Internship\NEW\Assert Function \index.js:38:3) at Module._compile (internal/modules/cjs/loader.js:1138:30) at Object.Module._extensions..js (internal/modules/cjs/loader.js:1158:10) at Module.load (internal/modules/cjs/loader.js:986:32) at Function.Module._load (internal/modules/cjs/loader.js:879:14) at Function.executeUserEntryPoint [as runMain] (internal/modules/run_main.js:71:12) at internal/main/run_main_module.js:17:47 (node:12704) UnhandledPromiseRejectionWarning: Unhandled promise rejection. This error originated either by throwing inside of an async function without a catch block, or by rejecting a promise which was not handled with .catch(). To terminate the node process on unhandled promise rejection, use the CLI flag `--unhandled-rejections=strict` (see https://nodejs.org/api/cli.html#cli_unhandled_rejections_mode). (rejection id: 1) Example 2: Filename: index.js javascript // Requiring the module const assert = require('assert').strict; // Function call (async () => { assert.strictEqual(1,1) await assert.rejects( async () => { throw new TypeError('Wrong value'); }, (err) => { assert.strictEqual(err.name, 'TypeError'); assert.strictEqual(err.message, 'Wrong value'); return true; } ).then(() => { console.log("Reject Demo Works Successfully") }); })(); Steps to run the program: The project structure will look like this: Run index.js file using below command: node index.js Output: Reject Demo Works Successfully Reference: https://nodejs.org/dist/latest-v12.x/docs/api/assert.html#assert_assert_rejects_asyncfn_error_message Comment More infoAdvertise with us G gouravhammad Follow Improve Article Tags : Web Technologies Node.js Node.js-Methods NodeJS-assert Similar Reads Node.js assert() Function The assert() function in Node.js is used for testing and verifying assumptions in your code. It is part of the built-in assert module, which provides a set of assertion functions to perform various checks and validations.Node assert FunctionIn assert() function, if the value is not truth, then a Ass 3 min read Node.js assert.deepStrictEqual() Function The assert module provides a set of assertion functions for verifying invariants. The assert.deepStrictEqual() function tests for deep equality between the actual and expected parameters. If the condition is true it will not produce an output else an assertion error is raised. Syntax: assert.deepStr 2 min read Node.js assert.doesNotThrow() Function The assert module provides a set of assertion functions for verifying invariants. The assert.doesNotThrow() function asserts that the function fn does not throw an error. Syntax: assert.doesNotThrow(fn[, error][, message]) Parameters: This function accepts the following parameters as mentioned above 3 min read Node.js assert.equal() Function The assert module provides a set of assertion functions for verifying invariants. The assert.equal() function tests for equality between the actual and the expected parameters. If the condition is true it will not produce an output else an assertion error is raised. Syntax: assert.equal(actual, exp 2 min read Node.js assert.fail() Function The assert module provides a set of assertion functions for verifying invariants. The assert.fail() function throws an AssertionError with the provided the error message or with a default error message. Syntax: assert.fail([message]) Parameters: This function accepts following parameters as mentione 2 min read Node.js assert.ifError() Function The assert module provides a set of assertion functions for verifying invariants. The assert.ifError() function throws value if value is not undefined or null. When testing the error argument in callbacks, this function is very useful.Syntax:  assert.ifError(value) value: This parameter holds the ac 2 min read Node.js assert.match() Function The assert module provides a set of assertion functions for verifying invariants. The assert.match() function expects the string input to match the regular expression. If the condition is true it will not produce an output else an assertion error is raised. Syntax: assert.match(string, regexp[, mes 2 min read Node.js assert.notDeepEqual() Function The assert module provides a set of assertion functions for verifying invariants. The assert.notDeepEqual() function tests deep strict inequality between the actual and the expected parameters. If the condition is true it will not produce an output else an assertion error is raised.Syntax: assert.no 2 min read Node.js assert.notDeepStrictEqual() Function The assert module provides a set of assertion functions for verifying invariants. The assert.notDeepStrictEqual() function tests for deep strict inequality. If the condition is true it will not produce an output else an assertion error is raised. Syntax: assert.notDeepStrictEqual(actual, expected[, 2 min read Node.js assert.notEqual() Function The assert module provides a set of assertion functions for verifying invariants. The assert.notEqual() function tests strict inequality between the actual and the expected parameters. If the condition is true it will not produce an output else an assertion error is raised. Syntax: assert.notEqual( 2 min read Like