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 этого сайта.
Автор статьи: Андрей Олегович