Початок роботи
Встановіть Jest за допомогою yarn
:
Або npm
:
Примітка: документація Jest використовує команди yarn
, проте npm
також спрацює. Ви можете порівняти команди yarn
та npm
в в документації yarn.
Let's get started by writing a test for a hypothetical function that adds two numbers. First, create a sum.js
file:
Then, create a file named sum.test.js
. This will contain our actual test:
Додайте наступну секцію до вашого package.json
:
І, нарешті, запустіть yarn test
і Jest виведе це повідомлення:
Ви тільки що успішно написали свій перший тест, використовуючи Jest!
Цей тест використовує expect
and toBe
для перевірки, що два значення абсолютно ідентичні. Щоб дізнатися про інші речі, які Jest може тестувати, перегляньте Використання Matchers.
#
Запуск з командного рядкаВи можете запустити Jest безпосередньо з командного рядка (якщо він доступний глобально у вашому PATH
, наприклад yarn global add jest
або npm install jest --global
) з широким набором корисних параметрів.
Ось як можна запустити Jest для файлів, назва яких відповідає шаблону my-test
, використовуючи config.json
як файл конфігурації та з відображенням нативних сповіщень ОС після запуску:
Щоб дізнатися більше про запуск jest
з командного рядка, відвідайте сторінку параметри командного рядка Jest.
#
Додаткові налаштування#
Згенеруйте основний файл конфігураціїBased on your project, Jest will ask you a few questions and will create a basic configuration file with a short description for each option:
#
Високристання BabelЩоб використовувати Babel, встановіть необхідні залежності за допомогою yarn
:
Налаштуйте Babel відповідно до вашої версії Node, створивши файл babel.config.js
в кореневому каталозі проекту:
The ideal configuration for Babel will depend on your project. See Babel's docs for more details.
Making your Babel config jest-aware
Jest will set process.env.NODE_ENV
to 'test'
if it's not set to something else. You can use that in your configuration to conditionally setup only the compilation needed for Jest, e.g.
Примітка:
babel-jest
автоматично встановлюється під час встановлення Jest і буде автоматично транслювати файли, якщо конфігурація Babel існує у вашому проекті. Щоб відключити цю поведінку, ви можете явно очистити конфігураційни параметрtransform
:
Babel 6 support
Jest 24 dropped support for Babel 6. We highly recommend you to upgrade to Babel 7, which is actively maintained. However, if you cannot upgrade to Babel 7, either keep using Jest 23 or upgrade to Jest 24 with babel-jest
locked at version 23, like in the example below:
While we generally recommend using the same version of every Jest package, this workaround will allow you to continue using the latest version of Jest with Babel 6 for now.
#
Використання webpackJest може застосовуватися в проектах, які використовують webpack для керування ресурсами, стилями та компіляції коду. webpack кидає певні унікальні виклики для використання інших інструментів. Перегляньте посібник по роботі з webpack щоб почати його використовувати.
#
Using parcelJest може використовуватись в проектах, що використовують parsel-bundler для керування ресурсами, стилями та компіляції, подібної до webpack. Parcel вимагає нульову конфігурацію. Зверніться до офіційної документації , щоб розпочати роботу.
#
Використання TypeScriptJest supports TypeScript, via Babel. По-перше, переконайтеся, що ви дотримувались інструкцій використовуючи Babel вище. Далі, встановіть @babel/preset-typescript
через yarn
:
Then add @babel/preset-typescript
to the list of presets in your babel.config.js
.
Проте, є деякі застереження щодо використання TypeScript з Babel. Оскільки TypeScript в Babel є суто транспіляцією, Jest не буде перевіряти ваші тести, коли вони будуть запущені. Якщо вам це потрібно, ви можете використовувати ts-jest , або просто запустіть компілятор TypeScript tsc окремо (або до вашої частини процесу збірки).
Ви також можете встановити модуль @types/jest
для версії Jest, яку ви використовуєте. Це допоможе забезпечити повним набором під час написання тестів з TypeScript.
Для
@types/*
модулів рекомендується спробувати встановити відповідність версії відповідного модуля. Наприклад, якщо ви використовуєте26.4.0
версіюjest
, тоді використання26.4.x
версії@types/jest
є ідеальним. Взагалі, спробуйте поєднати мажорні (26
) та другорядну (4
) версію якомога точніше.