Jest Platform

Вы можете выбрать специфические функции Jest и использовать их в качестве отдельных пакетов. Вот список доступных пакетов:

jest-changed-files

Инструмент для определения измененных файлов в git/hg репозитории. Экспортирует две функции:

• getChangedFilesForRoots returns a promise that resolves to an object with the changed files and repos.
• findRepos returns a promise that resolves to a set of repositories contained in the specified path.

Образец

const {getChangedFilesForRoots} = require('jest-changed-files');

// print the set of modified files since last commit in the current repo
getChangedFilesForRoots(['./'], {
  lastCommit: true,
}).then(result => console.log(result.changedFiles));

You can read more about jest-changed-files in the readme file.

jest-diff

Инструмент для визуализации изменений данных. Экспортирует функцию, которая сравнивает два значения любого типа и возвращает строку "pretty-printed", иллюстрирующую разницу между двумя аргументами.

Образец

const {diff} = require('jest-diff');

const a = {a: {b: {c: 5}}};
const b = {a: {b: {c: 6}}};

const result = diff(a, b);

// выводит разницу
console.log(result);

jest-docblock

Инструмент для разбора и парсинга комментариев в верхней части JavaScript-файла. Экспортирует различные функции для управления данными внутри блочных комментариев.

Образец

const {parseWithComments} = require('jest-docblock');

const code = `
/**
 * This is a sample
 *
 * @flow
 */

 console.log('Hello World!');
`;

const parsed = parseWithComments(code);

// prints an object with two attributes: comments and pragmas.
console.log(parsed);

You can read more about jest-docblock in the readme file.

jest-get-type

Модуль, который определяет примитивный тип любого значения JavaScript. Экспортирует функцию, которая возвращает строку с типом передаваемого значения в качестве аргумента.

Образец

const {getType} = require('@jest/get-type');

const array = [1, 2, 3];
const nullValue = null;
const undefinedValue = undefined;

// prints 'array'
console.log(getType(array));
// prints 'null'
console.log(getType(nullValue));
// prints 'undefined'
console.log(getType(undefinedValue));

jest-validate

Инструмент для проверки конфигураций, представленных пользователями. Экспортирует функцию, которая принимает два аргумента: конфигурацию пользователя и объект, содержащий пример конфигурации и другие параметры. Возвращаемым значением является объект с двумя атрибутами:

• hasDeprecationWarnings, a boolean indicating whether the submitted configuration has deprecation warnings,
• isValid, a boolean indicating whether the configuration is correct or not.

Образец

const {validate} = require('jest-validate');

const configByUser = {
  transform: '<rootDir>/node_modules/my-custom-transform',
};

const result = validate(configByUser, {
  comment: '  Documentation: http://custom-docs.com',
  exampleConfig: {transform: '<rootDir>/node_modules/babel-jest'},
});

console.log(result);

You can read more about jest-validate in the readme file.

jest-worker

Модуль используется для распараллеливания задач. Exports a class JestWorker that takes the path of Node.js module and lets you call the module's exported methods as if they were class methods, returning a promise that resolves when the specified method finishes its execution in a forked process.

Образец

heavy-task.js

module.exports = {
  myHeavyTask: args => {
    // long running CPU intensive task.
  },
};

main.js

async function main() {
  const worker = new Worker(require.resolve('./heavy-task.js'));

  // Запускаем параллельно две задачи с различными параметрами
  const results = await Promise.all([
    worker.myHeavyTask({foo: 'bar'}),
    worker.myHeavyTask({bar: 'foo'}),
  ]);

  console.log(results);
}

main();

You can read more about jest-worker in the readme file.

pretty-format

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

Образец

const {format: prettyFormat} = require('pretty-format');

const val = {object: {}};
val.circularReference = val;
val[Symbol('foo')] = 'foo';
val.map = new Map([['prop', 'value']]);
val.array = [-0, Infinity, NaN];

console.log(prettyFormat(val));

You can read more about pretty-format in the readme file.