Mocha: тестирование JavaScript

Mocha — это фреймворк для тестирования кода на JavaScript. Он работает в Node.js и в браузере, а его тестовые файлы — обычный JavaScript: группа проверок называется describe, одна проверка — it. Mocha выполняет проверки одну за другой и печатает один отчёт, поэтому неперехваченное исключение остаётся привязанным к тесту, который его вызвал. Проект живёт на GitHub, а репозиторий — mochajs/mocha.

Своей библиотеки проверок у Mocha нет. В Node.js достаточно встроенного node:assert, а примеры для браузера ниже берут assert из chai.

Первый тест в Node.js

Создайте проект и установите Mocha как зависимость для разработки:

npm init -y

npm install --save-dev mocha

В проекте один модуль и одна папка с тестом:

mocha-demo/ ├── package.json ├── sum.js └── test/ └── sum.test.js

sum.js

function sum(a, b) { return a + b; } module.exports = { sum };

test/sum.test.js

const assert = require('node:assert/strict'); const { sum } = require('../sum.js'); describe('sum', function () { it('adds two numbers', function () { assert.equal(sum(1, 2), 3); }); it('adds negative numbers', function () { assert.equal(sum(-2, 5), 3); }); });

Файлы в test/ Mocha находит сама, поэтому команда короткая:

npx mocha

sum
✔ adds two numbers
✔ adds negative numbers

2 passing (15ms)

Каждый it — одна строка со своим результатом, а последние две строки считают проверки и показывают время запуска. У проверки во вложенной папке в отчёте видно полное имя, поэтому упавшую строку сразу находят в файле.

Когда проверка падает

Неверное ожидаемое значение превращает тот же файл в падение. Здесь второй аргумент первой проверки — 5:

const assert = require('node:assert/strict'); const { sum } = require('../sum.js'); describe('sum', function () { it('adds two numbers', function () { assert.equal(sum(2, 2), 5); }); });

npx mocha

sum
1) adds two numbers

0 passing (25ms)
1 failing

1) sum
adds two numbers:

AssertionError [ERR_ASSERTION]: Expected values to be strictly equal:

4 !== 5

+ expected - actual

-4
+5

Пара 4 !== 5 — это фактическое значение и ожидаемое, а строки ниже повторяют их со знаками - и +. В отчёте есть файл и строка проверки, поэтому следующий шаг — исправить эту строку или функцию, которую она вызывает.

Запуск Mocha в браузере

На странице в браузере Mocha нужен её файл стилей в <head>:

<link rel="stylesheet" href="https://unpkg.com/mocha/mocha.css" />

Отчёт рисуется в div с идентификатором mocha:

<div id="mocha"></div>

Дальше идут скрипты: chai, сама Mocha, вызов настройки, тестовый файл и запуск.

<script src="https://unpkg.com/chai/chai.js"></script> <script src="https://unpkg.com/mocha/mocha.js"></script> <script> mocha.setup('bdd'); mocha.checkLeaks(); </script> <script src="mocha_first_test.js"></script> <script> mocha.run(); </script>

Тот же порядок описан в руководстве Mocha. Страница ниже — рабочий пример: она загружает библиотеки с unpkg, объявляет две проверки для функции и запускает их.

function double(n) { return n * 2; } describe('double', function () { it('doubles a number', function () { assert.equal(double(3), 6); }); it('doubles a negative number', function () { assert.equal(double(-2), -4); }); });

У примера с sum есть своя страница, а рядом с ней — тестовая HTML-страница: Тестовая страница Mocha: запуск тестов в браузере.

Что дальше

Mocha проверяет функции и небольшие единицы кода. Целым браузером управляет Playwright, а пакеты для команды запуска тестов ставят через npm. Оба инструмента есть в разделе QA этого сайта.

Автор статьи: Андрей Олегович