← Cloudflare Workers / workers / testing / vitest-integration

Отладка

В этом руководстве показано, как отлаживать тесты Workers с помощью Vitest и @cloudflare/vitest-plugin.

Открыть inspector с Vitest

Чтобы начать отладку, запустите Vitest следующей командой и подключите отладчик к порту 9229:

vitest --inspect --no-file-parallelism

Настроить порт инспектора

По умолчанию inspector открывается на порту 9229. Если нужно использовать другой порт (например, 3456), можно выполнить следующую команду:

vitest --inspect=3456 --no-file-parallelism

Также вы можете определить это в файле конфигурации Vitest:

import { cloudflareTest } from "@cloudflare/vitest-plugin";
import { defineConfig } from "vitest/config";

export default defineConfig({
	plugins: [
		cloudflareTest({
			// ...
		}),
	],
	test: {
		inspector: {
			port: 3456,
		},
	},
});

Настройка VS Code для использования точек останова

Чтобы настроить VS Code для отладки с точками останова в тестах Worker, создайте .vscode/launch.json файл, содержащий следующую конфигурацию:

{
	"configurations": [
		{
			"type": "node",
			"request": "launch",
			"name": "Open inspector with Vitest",
			"program": "${workspaceRoot}/node_modules/vitest/vitest.mjs",
			"console": "integratedTerminal",
			"args": ["--inspect=9229", "--no-file-parallelism"]
		},
		{
			"name": "Attach to Workers Runtime",
			"type": "node",
			"request": "attach",
			"port": 9229,
			"cwd": "/",
			"resolveSourceMapLocations": null,
			"attachExistingChildren": false,
			"autoAttachChildProcesses": false
		}
	],
	"compounds": [
		{
			"name": "Debug Workers tests",
			"configurations": [
				"Open inspector with Vitest",
				"Attach to Workers Runtime"
			],
			"stopAll": true
		}
	]
}

Выберите Отладка тестов Workers в верхней части Запуск и отладка панели, чтобы открыть инспектор с Vitest и подключить отладчик к среде выполнения Workers. После этого можно добавлять точки останова в файлы тестов и начинать отладку.