Debugowanie

TIP

Podczas debugowania testów możesz użyć argumentu CLI --test-timeout, aby zapobiec przekroczeniu limitu czasu testów, gdy zatrzymasz się na punktach przerwania.

VSCode

Szybkim sposobem na debugowanie testów w VSCode jest użycie terminala debugowania JavaScript (JavaScript Debug Terminal). Otwórz nowy JavaScript Debug Terminal i uruchom npm run test lub bezpośrednio vitest. Ta metoda działa z dowolnym kodem uruchamianym w Node.js, a więc będzie kompatybilna z większością frameworków testowych JavaScript.

Możesz również dodać dedykowaną konfigurację uruchamiania, aby debugować pojedynczy plik testowy w VSCode:

{
  // Więcej informacji: https://go.microsoft.com/fwlink/?linkid=830387
  "version": "0.2.0",
  "configurations": [
    {
      "type": "node",
      "request": "launch",
      "name": "Debuguj bieżący plik testowy",
      "autoAttachChildProcesses": true,
      "skipFiles": ["<node_internals>/**", "**/node_modules/**"],
      "program": "${workspaceRoot}/node_modules/vitest/vitest.mjs",
      "args": ["run", "${relativeFile}"],
      "smartStep": true,
      "console": "integratedTerminal"
    }
  ]
}

Następnie w zakładce debugowania upewnij się, że wybrano konfigurację 'Debuguj bieżący plik testowy'. Otwórz plik testowy, który chcesz debugować, i naciśnij F5, aby rozpocząć debugowanie.

IntelliJ IDEA

Utwórz konfigurację uruchomieniową 'Node.js'. Użyj następujących ustawień, aby uruchomić wszystkie testy w trybie debugowania:

Ustawienie	Wartość
Katalog roboczy	/path/to/your-project-root
Plik JavaScript	./node_modules/vitest/vitest.mjs
Parametry aplikacji	run --pool forks

Następnie uruchom tę konfigurację w trybie debugowania. IDE zatrzyma wykonywanie na punktach przerwania JS/TS ustawionych w edytorze.

Node Inspector, np. Chrome DevTools

Vitest umożliwia debugowanie testów również bez użycia IDE. Wymaga to jednak, aby testy nie były uruchamiane równolegle. Użyj jednego z poniższych poleceń, aby uruchomić Vitest.

# Aby uruchomić w jednym workerze
vitest --inspect-brk --pool threads --poolOptions.threads.singleThread

# Aby uruchomić w jednym procesie potomnym
vitest --inspect-brk --pool forks --poolOptions.forks.singleFork

Jeśli używasz Vitest 1.1 lub nowszego, możesz po prostu użyć flagi --no-file-parallelism:

# Jeśli pula jest nieznana
vitest --inspect-brk --no-file-parallelism

Po uruchomieniu Vitest zatrzyma wykonywanie i poczeka, aż otworzysz narzędzia deweloperskie, które mogą połączyć się z inspektorem Node.js. Możesz użyć do tego Chrome DevTools, otwierając chrome://inspect w przeglądarce.

W trybie obserwacji możesz pozostawić debugger otwarty podczas ponownych uruchomień testów, używając opcji --poolOptions.threads.isolate false.