Перейти к основной части
Version: 25.x

Jest Platform

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

jest-changed-files#

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

  • getChangedFilesForRoots возвращает Promise, который в Resolve хранит объект с измененными файлами и репозиторием.
  • findRepos возвращает Promise, которое в Resolve передает набор репозиториев, содержащихся в указанном пути.

Образец#

// выводит набор измененных файлов с момента последнего коммита в выбранном репозитории
getChangedFilesForRoots(['./'], {
lastCommit: true,
}).then(result => console.log(result.changedFiles));

Вы можете прочитать о jest-Измененных файлах в readme файле.

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);
// print diff
console.log(result);

jest-docblock#

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

Образец#

const {parseWithComments} = require('jest-docblock');
const code = `
/**
* Это пример
*
* @flow
*/
console.log('Привет мир!');
`;
const parsed = parseWithComments(code);
// выводит пример с двумя аттрибутами: комментарии и pragma.
console.log(parsed);

Вы можете прочитать о jest-dockblock в readme файле.

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, логическое значение, указывающее, имеет ли представленная конфигурация предупреждение об использовании устаревшего принципа,
  • isValid, логическое значение, указывающее верна ли конфигурация или нет.

Образец#

const {validate} = require('jest-validate');
const configByUser = {
transform: '<rootDir>/node_modules/my-custom-transform',
};
const result = validate(configByUser, {
comment: ' Документация: http://custom-docs.com',
exampleConfig: {transform: '<rootDir>/node_modules/babel-jest'},
});
console.log(result);

Вы можете прочитать о jest-validate в readme файле.

jest-worker#

Модуль используется для распараллеливания задач. Exports a class Worker 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 => {
// большая задачи интенсивно использующая ЦП.
},
};
// 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();

Вы можете прочитать о jest-worker в readme файле.

pretty-format#

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

Образец#

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

Вы можете прочитать о jest-format в readme файле.