Что такое assertions (утверждения) в тестировании?

Question

Accepted Answer

**Assertions** — это операторы в тесте, которые **проверяют, верно ли условие** — убеждаются, что фактический результат соответствует ожидаемому результату. Это основа того, как тесты определяют успех или неудачу: если assertion не срабатывает, тест не срабатывает.

## Что делают assertions

```text
An ASSERTION checks that something is as expected:
  → "assert that the actual value EQUALS the expected value"
  → if TRUE → the assertion passes; if FALSE → the assertion FAILS → the TEST FAILS
→ Assertions are how a test VERIFIES behavior (the "check" part of a test).
```

## Распространённые типы assertions

```js
// equality
expect(result).toBe(5);                  // strict equality
expect(obj).toEqual({ name: 'Ann' });    // deep/value equality (objects)

// truthiness / null
expect(value).toBeTruthy();
expect(value).toBeNull();
expect(value).toBeDefined();

// comparisons
expect(count).toBeGreaterThan(0);
expect(price).toBeLessThanOrEqual(100);

// collections / strings
expect(array).toContain('item');
expect(array).toHaveLength(3);
expect(text).toMatch(/pattern/);          // regex

// errors
expect(() => risky()).toThrow();          // expect a function to throw

// negation
expect(value).not.toBe(null);
```

## Хорошие assertions

```text
✓ Assert the SPECIFIC expected outcome (clear what's being checked)
✓ Use the RIGHT matcher (toBe vs toEqual; specific > generic)
✓ Clear FAILURE messages (good assertions/matchers explain what failed)
✓ Don't over-assert (test one behavior) or under-assert (verify the actual result)
```

## Почему это важно

Понимание assertions фундаментально, потому что это **основной механизм, с помощью которого тесты проверяют поведение** — определяет успех или неудачу — поэтому это необходимое, обязательное знание для написания любого теста.

Assertion **проверяет, что условие верно** (обычно что фактический результат соответствует ожидаемому), и это часть "проверки" теста: если assertion проходит, проверка выполняется, а если не проходит, то тест не срабатывает.

Без assertions тест на самом деле ничего не проверяет — поэтому понимание их фундаментально для написания значимых тестов.

Понимание **распространённых типов assertions** — равенство (строгое `toBe` vs глубокое/по значению `toEqual` для объектов, важное различие), проверки логических значений и null, сравнения, проверки коллекций и строк, проверки ошибок (убедиться, что функция выбрасывает исключение), и отрицание — это необходимое практическое знание для выражения того, что должен проверить тест.

Понимание **хороших практик assertions** — утверждение конкретного ожидаемого результата (ясное представление о том, что проверяется), использование правильного matcher (например `toEqual` для сравнения объектов, а не `toBe`), гарантирование чётких сообщений об ошибках (чтобы неудачный тест объяснял, что пошло не так), и баланс assertions (тестирование одного поведения, но проверка фактического результата) — отражает написание чётких, эффективных тестов.

Поскольку assertions — это то, как каждый тест проверяет поведение (фундаментальная проверка, которая делает тест значимым), и понимание их — типов, правильных matchers и хороших практик — необходимо для написания любого теста, который фактически что-то проверяет, понимание assertions является основополагающим тестовым знанием — основным строительным блоком тестов, необходимым для выражения и проверки ожидаемого поведения и фундаментальным для написания тестов, которые значимо проверяют корректность — базовой компетенцией для всех, кто пишет тесты.