Использование сопоставлений

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

Стандартные сопоставления

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

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

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

toBe использует Object.is для проверки точного совпадения. Если же вам нужно проверить значение объекта, воспользуйтесь toEqual:

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);
    }
  }
});

Правдивость

При тестировании иногда необходимо различать undefined, null и false, но в некоторых ситуациях это не требуется. Jest содержит вспомогательные функции позволяющие явно указывать, что вам нужно.

• toBeNull соответствует только null
• toBeUndefined соответствует только 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');
});

Исключения

Для проверки возврата ошибки конкретной функцией при её вызове, используйте 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/);
});

Примечание: функция, которая выбрасывает исключение должна быть вызвана внутри функции-обертки expect, иначе утверждение toThrow не будет работать.

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

Это лишь проба пера. Для ознакомления с полным списком сопоставлений, обратите внимание на справочную документацию.

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