Edit

Using Matchers

Jest использует «cопоставления» для тестирования значений разными способами. На этой странице будут представлены сопоставления, которые чаще всего используются. Полный список смотрите в описании expect API.

Общие вычислители

Самый простой способ проверить значение — при помощи точно равенства.

test('два плюс два равно четыре', () => {
  expect(2 + 2).toBe(4);
});

В этом коде expect(2+2) возвращает объект "ожиданий". Обычно вам не придется делать с этими объектами ожиданий ничего кроме как вызывать их вычислители. В этом примере кода .toBe(4) это вычислитель. При запуске, Jest отслеживает все провалившиеся вычислители для того, чтобы он мог напечатать для вас сообщения об ошибках.

toBe uses Object.is to test exact equality. If you want to check the value of an object, use toEqual instead:

test('присваивание объекту', () => {
  const data = {один: 1};
  data['два'] = 2;
  expect(data).toEqual({один: 1, два: 2});
});

toEqual рекурсивно проверяет каждое поле объекта или массива.

Вы также можете протестировать на противоположность вычислителю:

test('сложение положительных чисел не равно нулю', () => {
  for (let a = 1; a < 10; a++) {
    for (let b = 1; b < 10; b++) {
      expect(a + b).not.toBe(0);
    }
  }
});

Правдивость

In tests, you sometimes need to distinguish between undefined, null, and false, but you sometimes do not want to treat these differently. Jest содержит вспомогательные функции позволяющие явно указывать, что вам нужно.

• toBeNull соответствует только null
• toUndefined соответствует только undefined
• toBeDefined является противоположностью toBeUndefined
• toBeTruthy соответствует всему, что if инструкция рассматривает как true
• toBeFalsy соответствует всему, что if инструкция рассматривает как false

Например:

test('null', () => {
  const n = null;
  expect(n).toBeNull();
  expect(n).toBeDefined();
  expect(n).not.toBeUndefined();
  expect(n).not.toBeTruthy();
  expect(n).toBeFalsy();
});

test('ноль', () => {
  const z = 0;
  expect(z).not.toBeNull();
  expect(z).toBeDefined();
  expect(z).not.toBeUndefined();
  expect(z).not.toBeTruthy();
  expect(z).toBeFalsy();
});

Следует использовать вычислитель, который наиболее точно отражает то, что код должен делать.

Числа

Большинство способов сравнения чисел имеют эквивалентные вычислители.

test('два плюс два', () => {
  const value = 2 + 2;
  expect(value).toBeGreaterThan(3);
  expect(value).toBeGreaterThanOrEqual(3.5);
  expect(value).toBeLessThan(5);
  expect(value).toBeLessThanOrEqual(4.5);

  // toBe и toEqual эквивалентны по отношению к числам
  expect(value).toBe(4);
  expect(value).toEqual(4);
});

Для проверки равенства чисел с плавающей запятой, используйте toBeCloseTo вместо toEqual потому, что вы не хотите, чтобы тест полагался на небольшую ошибку округления.

test('сложение чисел с плавающей запятой', () => {
  const value = 0.1 + 0.2;
  //expect(value).toBe(0.3);         Это не будет работать из-за ошибки округления
  expect(value).toBeCloseTo(0.3); // А это сработает.
});

Строки

Для сопоставления строк с регулярными выражениями, используйте toMatch:

test('в команде нет места Я', () => {
  expect('команда').not.toMatch(/Я/);
});

test('но есть "ася" в Васе', () => {
  expect('Вася').toMatch(/ася/);
});

Массивы и перебираемые объекты

Вы можете проверить, содержит ли массив или итерируемый объект конкретное значение, используя toContain:

const shoppingList = [
  'diapers',
  'kleenex',
  'trash bags',
  'paper towels',
  'milk',
];

test('the shopping list has milk on it', () => {
  expect(shoppingList).toContain('milk');
  expect(new Set(shoppingList)).toContain('milk');
});

Исключения

If you want to test whether a particular function throws an error when it's called, use toThrow.

function compileAndroidCode() {
  throw new Error('you are using the wrong JDK');
}

test('compiling android goes as expected', () => {
  expect(() => compileAndroidCode()).toThrow();
  expect(() => compileAndroidCode()).toThrow(Error);

  // You can also use the exact error message or a regexp
  expect(() => compileAndroidCode()).toThrow('you are using the wrong JDK');
  expect(() => compileAndroidCode()).toThrow(/JDK/);
});

Note: the function that throws an exception needs to be invoked within a wrapping function otherwise the toThrow assertion will fail.

И многое другое

This is just a taste. Для полного списка матчеров, обратите внимание на справочную документацию.

После того как вы узнали о всех доступных сопоставлениях, следующим шагом взгляните на то, как Jest позволяет тестировать асинхронный код.