Vitest 2

Русский

English
简体中文
繁體中文
Español
Français
Português – Brasil
Deutsch
日本語
한국어
Italiano
Polski
Türkçe
čeština
magyar

Русский

English
简体中文
繁體中文
Español
Français
Português – Brasil
Deutsch
日本語
한국어
Italiano
Polski
Türkçe
čeština
magyar

Внешний вид

root ​

  • CLI: -r, --root <path>
  • Config: root

Корневой путь проекта.

config ​

  • CLI: -c, --config <path>

Путь к файлу конфигурации.

update ​

  • CLI: -u, --update
  • Config: update

Обновить моментальные снимки (snapshots).

watch ​

  • CLI: -w, --watch
  • Config: watch

Включить режим отслеживания изменений (watch mode).

testNamePattern ​

Запускать тесты, полные имена которых соответствуют указанному регулярному выражению.

dir ​

  • CLI: --dir <path>
  • Config: dir

Базовый каталог для сканирования тестовых файлов.

ui ​

  • CLI: --ui
  • Config: ui

Включить пользовательский интерфейс.

open ​

  • CLI: --open
  • Config: open

Автоматически открывать пользовательский интерфейс (по умолчанию: !process.env.CI).

api.port ​

  • CLI: --api.port [port]

Указать порт сервера. Обратите внимание, что если порт уже используется, Vite автоматически попытается использовать следующий доступный порт, поэтому это может быть не тот порт, на котором сервер в конечном итоге будет прослушивать. Если установлено в true, будет использоваться порт 51204.

api.host ​

  • CLI: --api.host [host]

Указать, какие IP-адреса должен прослушивать сервер. Установите значение 0.0.0.0 или true, чтобы прослушивать все адреса, включая локальные и публичные.

api.strictPort ​

  • CLI: --api.strictPort

Установите значение true, чтобы выйти, если порт уже занят, вместо автоматической попытки использовать следующий доступный порт.

silent ​

Отключить вывод в консоль из тестов.

hideSkippedTests ​

  • CLI: --hideSkippedTests

Скрыть логи пропущенных тестов.

reporters ​

Указать репортеры.

outputFile ​

Записывать результаты тестов в файл, если также указан поддерживаемый репортер. Используйте точечную нотацию cac для индивидуального вывода нескольких репортеров (пример: --outputFile.tap=./tap.txt).

coverage.all ​

Включать ли в отчет все файлы, включая непротестированные.

coverage.provider ​

Выбрать инструмент для сбора покрытия кода. Доступные значения: "v8", "istanbul" и "custom".

coverage.enabled ​

Включает сбор покрытия кода. Может быть переопределено с помощью опции CLI --coverage (по умолчанию: false).

coverage.include ​

Файлы, включенные в покрытие, в виде glob-шаблонов. Может быть указано несколько раз при использовании нескольких шаблонов (по умолчанию: **).

coverage.exclude ​

Файлы, исключаемые из покрытия. Может быть указано несколько раз при использовании нескольких шаблонов (по умолчанию: см. coverage.exclude).

coverage.extension ​

Расширение, которое будет включено в покрытие. Может быть указано несколько раз при использовании нескольких расширений (по умолчанию: [".js", ".cjs", ".mjs", ".ts", ".mts", ".tsx", ".jsx", ".vue", ".svelte"]).

coverage.clean ​

Очищать результаты покрытия перед запуском тестов (по умолчанию: true).

coverage.cleanOnRerun ​

Очищать отчет о покрытии при повторном запуске в режиме отслеживания изменений (по умолчанию: true).

coverage.reportsDirectory ​

Каталог для записи отчета о покрытии (по умолчанию: ./coverage).

coverage.reporter ​

Репортеры покрытия для использования. Дополнительную информацию см. на coverage.reporter (по умолчанию: ["text", "html", "clover", "json"]).

coverage.reportOnFailure ​

Генерировать отчет о покрытии, даже если тесты не пройдены (по умолчанию: false).

coverage.allowExternal ​

Собирать покрытие файлов вне корневого каталога проекта (по умолчанию: false).

coverage.skipFull ​

Не показывать файлы со 100% покрытием операторов, ветвей и функций (по умолчанию: false).

coverage.thresholds.100 ​

Ярлык для установки всех порогов покрытия на 100% (по умолчанию: false).

coverage.thresholds.perFile ​

Проверять пороги для каждого файла. См. --coverage.thresholds.lines, --coverage.thresholds.functions, --coverage.thresholds.branches и --coverage.thresholds.statements для фактических порогов (по умолчанию: false).

coverage.thresholds.autoUpdate ​

Обновлять значения порогов: "lines", "functions", "branches" и "statements" в файле конфигурации, когда текущее покрытие выше настроенных порогов (по умолчанию: false).

coverage.thresholds.lines ​

  • CLI: --coverage.thresholds.lines <number>

Порог для строк. Дополнительную информацию см. на istanbuljs. Эта опция недоступна для пользовательских поставщиков.

coverage.thresholds.functions ​

  • CLI: --coverage.thresholds.functions <number>

Порог для функций. Дополнительную информацию см. на istanbuljs. Эта опция недоступна для пользовательских поставщиков.

coverage.thresholds.branches ​

  • CLI: --coverage.thresholds.branches <number>

Порог для ветвей. Дополнительную информацию см. на istanbuljs. Эта опция недоступна для пользовательских поставщиков.

coverage.thresholds.statements ​

  • CLI: --coverage.thresholds.statements <number>

Порог для операторов. Дополнительную информацию см. на istanbuljs. Эта опция недоступна для пользовательских поставщиков.

coverage.ignoreClassMethods ​

Массив имен методов класса, которые следует игнорировать при покрытии. Дополнительную информацию см. на istanbuljs. Эта опция доступна только для поставщиков istanbul (по умолчанию: []).

coverage.processingConcurrency ​

Лимит параллелизма, используемый при обработке результатов покрытия (по умолчанию: минимум из 20 и количества ЦП).

coverage.customProviderModule ​

Указывает имя модуля или путь к пользовательскому модулю поставщика покрытия. Дополнительную информацию см. на Custom Coverage Provider. Эта опция доступна только для пользовательских поставщиков.

coverage.watermarks.statements ​

  • CLI: --coverage.watermarks.statements <watermarks>

Высокие и низкие пороги для операторов в формате <high>,<low>.

coverage.watermarks.lines ​

  • CLI: --coverage.watermarks.lines <watermarks>

Высокие и низкие пороги для строк в формате <high>,<low>.

coverage.watermarks.branches ​

  • CLI: --coverage.watermarks.branches <watermarks>

Высокие и низкие пороги для ветвей в формате <high>,<low>.

coverage.watermarks.functions ​

  • CLI: --coverage.watermarks.functions <watermarks>

Высокие и низкие пороги для функций в формате <high>,<low>.

mode ​

  • CLI: --mode <name>
  • Config: mode

Переопределить режим Vite (по умолчанию: test или benchmark).

workspace ​

Путь к файлу конфигурации рабочего пространства.

isolate ​

Запускать каждый тестовый файл изолированно. Чтобы отключить изоляцию, используйте --no-isolate (по умолчанию: true).

globals ​

Внедрять API глобально.

dom ​

  • CLI: --dom

Моделировать API браузера с помощью happy-dom.

browser.enabled ​

Запускать тесты в браузере. Эквивалентно --browser (по умолчанию: false).

browser.name ​

Запускать все тесты в определенном браузере. Некоторые браузеры доступны только для определенных провайдеров (см. --browser.provider). Дополнительную информацию см. на browser.name.

browser.headless ​

Запускать браузер в безголовом режиме (т.е. без открытия графического пользовательского интерфейса). Если Vitest запускается в CI, этот режим будет включен по умолчанию (по умолчанию: process.env.CI).

browser.api.port ​

Указать порт сервера. Обратите внимание, что если порт уже используется, Vite автоматически попытается использовать следующий доступный порт, поэтому это может быть не тот порт, на котором сервер в конечном итоге будет прослушивать. Если установлено в true, будет использоваться порт 63315.

browser.api.host ​

Указать, какие IP-адреса должен прослушивать сервер. Установите значение 0.0.0.0 или true, чтобы прослушивать все адреса, включая локальные и публичные.

browser.api.strictPort ​

Установите значение true, чтобы выйти, если порт уже занят, вместо автоматической попытки использовать следующий доступный порт.

browser.provider ​

Поставщик, используемый для запуска тестов в браузере. Некоторые браузеры доступны только для определенных поставщиков. Может быть "webdriverio", "playwright", "preview" или путь к пользовательскому поставщику. Дополнительную информацию см. на browser.provider (по умолчанию: "preview").

browser.providerOptions ​

Опции, которые передаются поставщику браузера. Дополнительную информацию см. на browser.providerOptions.

browser.isolate ​

Запускать каждый файл браузерного теста изолированно. Чтобы отключить изоляцию, используйте --browser.isolate=false (по умолчанию: true).

browser.ui ​

Показывать пользовательский интерфейс Vitest при запуске тестов (по умолчанию: !process.env.CI).

browser.fileParallelism ​

Должны ли файлы браузерных тестов запускаться параллельно. Используйте --browser.fileParallelism=false для отключения (по умолчанию: true).

pool ​

  • CLI: --pool <pool>
  • Config: pool

Указать пул, если тесты не запускаются в браузере (по умолчанию: threads).

poolOptions.threads.isolate ​

Изолировать тесты в пуле потоков (по умолчанию: true).

poolOptions.threads.singleThread ​

Запускать тесты в одном потоке (по умолчанию: false).

poolOptions.threads.maxThreads ​

Максимальное количество или процент потоков для запуска тестов.

poolOptions.threads.minThreads ​

Минимальное количество или процент потоков для запуска тестов.

poolOptions.threads.useAtomics ​

Использовать Atomics для синхронизации потоков. Это может улучшить производительность в некоторых случаях, но может вызвать segfault в старых версиях Node (по умолчанию: false).

poolOptions.vmThreads.isolate ​

Изолировать тесты в пуле потоков VM (по умолчанию: true).

poolOptions.vmThreads.singleThread ​

Запускать тесты в одном потоке (по умолчанию: false).

poolOptions.vmThreads.maxThreads ​

Максимальное количество или процент потоков для запуска тестов.

poolOptions.vmThreads.minThreads ​

Минимальное количество или процент потоков для запуска тестов.

poolOptions.vmThreads.useAtomics ​

Использовать Atomics для синхронизации потоков. Это может улучшить производительность в некоторых случаях, но может вызвать segfault в старых версиях Node (по умолчанию: false).

poolOptions.vmThreads.memoryLimit ​

Лимит памяти для пула потоков VM. Если наблюдаются утечки памяти, попробуйте скорректировать это значение.

poolOptions.forks.isolate ​

Изолировать тесты в пуле форков (по умолчанию: true).

poolOptions.forks.singleFork ​

Запускать тесты в одном дочернем процессе (по умолчанию: false).

poolOptions.forks.maxForks ​

Максимальное количество или процент процессов для запуска тестов.

poolOptions.forks.minForks ​

Минимальное количество или процент процессов для запуска тестов.

poolOptions.vmForks.isolate ​

Изолировать тесты в пуле форков VM (по умолчанию: true).

poolOptions.vmForks.singleFork ​

Запускать тесты в одном дочернем процессе (по умолчанию: false).

poolOptions.vmForks.maxForks ​

Максимальное количество или процент процессов для запуска тестов.

poolOptions.vmForks.minForks ​

Минимальное количество или процент процессов для запуска тестов.

poolOptions.vmForks.memoryLimit ​

Лимит памяти для пула форков VM. Если наблюдаются утечки памяти, попробуйте скорректировать это значение.

fileParallelism ​

Должны ли все тестовые файлы запускаться параллельно. Используйте --no-file-parallelism для отключения этой опции (по умолчанию: true).

maxWorkers ​

Максимальное количество или процент воркеров для запуска тестов.

minWorkers ​

Минимальное количество или процент воркеров для запуска тестов.

environment ​

Указать среду выполнения, если тесты не запускаются в браузере (по умолчанию: node).

passWithNoTests ​

Считать успешным, если тесты не найдены.

logHeapUsage ​

Показывать размер кучи для каждого теста при запуске в Node.js.

allowOnly ​

Разрешить тесты и наборы, помеченные как "only" (по умолчанию: !process.env.CI).

dangerouslyIgnoreUnhandledErrors ​

Игнорировать любые необработанные ошибки.

sequence.shuffle.files ​

Запускать файлы в случайном порядке. Длительные тесты не начнутся раньше, если вы включите эту опцию (по умолчанию: false).

sequence.shuffle.tests ​

Запускать тесты в случайном порядке (по умолчанию: false).

sequence.concurrent ​

Запускать тесты параллельно (по умолчанию: false).

sequence.seed ​

Установить начальное значение для рандомизации. Эта опция не будет иметь эффекта, если --sequence.shuffle имеет ложное значение. Дополнительную информацию см. на странице "Random Seed".

sequence.hooks ​

Изменяет порядок выполнения хуков. Принимаемые значения: "stack", "list" и "parallel". Дополнительную информацию см. на sequence.hooks (по умолчанию: "parallel").

sequence.setupFiles ​

Изменяет порядок выполнения файлов настройки. Принимаемые значения: "list" и "parallel". Если установлено "list", файлы настройки будут запускаться в порядке их определения. Если установлено "parallel", файлы настройки будут запускаться параллельно (по умолчанию: "parallel").

inspect ​

  • CLI: --inspect [[host:]port]
  • Config: inspect

Включить инспектор Node.js (по умолчанию: 127.0.0.1:9229).

inspectBrk ​

Включить инспектор Node.js и приостановить выполнение перед началом теста.

testTimeout ​

Таймаут по умолчанию для теста в миллисекундах (по умолчанию: 5000).

hookTimeout ​

Таймаут по умолчанию для хука в миллисекундах (по умолчанию: 10000).

bail ​

  • CLI: --bail <number>
  • Config: bail

Остановить выполнение тестов, когда заданное количество тестов завершится неудачей (по умолчанию: 0).

retry ​

  • CLI: --retry <times>
  • Config: retry

Повторить тест указанное количество раз, если он не пройден (по умолчанию: 0).

diff ​

  • CLI: --diff <path>
  • Config: diff

Путь к конфигурации diff, которая будет использоваться для генерации интерфейса diff.

exclude ​

  • CLI: --exclude <glob>
  • Config: exclude

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

expandSnapshotDiff ​

Показывать полный diff при неудачном создании моментального снимка.

disableConsoleIntercept ​

Отключить автоматический перехват вывода консоли (по умолчанию: false).

typecheck.enabled ​

Включить проверку типов вместе с тестами (по умолчанию: false).

typecheck.only ​

Запускать только тесты проверки типов. Это автоматически включает проверку типов (по умолчанию: false).

typecheck.checker ​

Указать средство проверки типов для использования. Доступные значения: "tsc", "vue-tsc", а также путь к исполняемому файлу (по умолчанию: "tsc").

typecheck.allowJs ​

Разрешить проверку типов файлов JavaScript. По умолчанию значение берется из tsconfig.json.

typecheck.ignoreSourceErrors ​

Игнорировать ошибки типов в исходных файлах.

typecheck.tsconfig ​

Путь к пользовательскому файлу tsconfig.

project ​

  • CLI: --project <name>
  • Config: project

Имя проекта для запуска, если вы используете функцию рабочего пространства Vitest. Эту опцию можно повторять для нескольких проектов: --project=1 --project=2. Вы также можете фильтровать проекты с помощью подстановочных знаков, таких как --project=packages*.

slowTestThreshold ​

Порог в миллисекундах, при превышении которого тест считается медленным (по умолчанию: 300).

teardownTimeout ​

Таймаут по умолчанию для функции teardown в миллисекундах (по умолчанию: 10000).

maxConcurrency ​

Максимальное количество параллельных тестов в наборе (по умолчанию: 5).

expect.requireAssertions ​

Требовать, чтобы все тесты содержали хотя бы одно утверждение.

expect.poll.interval ​

Интервал опроса в миллисекундах для утверждений expect.poll() (по умолчанию: 50).

expect.poll.timeout ​

Таймаут опроса в миллисекундах для утверждений expect.poll() (по умолчанию: 1000).

printConsoleTrace ​

Всегда выводить трассировку стека в консоль.

run ​

  • CLI: --run

Отключить режим отслеживания изменений.

color ​

  • CLI: --no-color

Удаляет цвета из вывода в консоль.

clearScreen ​

  • CLI: --clearScreen

Очищать экран терминала при повторном запуске тестов в режиме отслеживания изменений (по умолчанию: true).

standalone ​

  • CLI: --standalone

Запустить Vitest без выполнения тестов. Файловые фильтры будут игнорироваться, тесты будут запускаться только при изменении файлов (по умолчанию: false).

Выпущено на условиях лицензии MIT.

Авторские права (c) 2021-Present Vitest Team

https://v2.vitest.dev/guide/cli-generated

Выпущено на условиях лицензии MIT.

Авторские права (c) 2021-Present Vitest Team