Debugging

TIP

Durante il debug dei test, puoi utilizzare l'argomento CLI --test-timeout per evitare che i test scadano quando ti fermi ai breakpoint.

VSCode

Un modo rapido per eseguire il debug dei test in VSCode è utilizzare il JavaScript Debug Terminal. Apri un nuovo JavaScript Debug Terminal ed esegui npm run test o vitest direttamente. Questo metodo funziona con qualsiasi codice eseguito in Node, quindi è compatibile con la maggior parte dei framework di test JS.

Puoi anche aggiungere una configurazione di avvio specifica per eseguire il debug di un singolo file di test in VSCode:

{
  // For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
  "version": "0.2.0",
  "configurations": [
    {
      "type": "node",
      "request": "launch",
      "name": "Debug del file di test corrente",
      "autoAttachChildProcesses": true,
      "skipFiles": ["<node_internals>/**", "**/node_modules/**"],
      "program": "${workspaceRoot}/node_modules/vitest/vitest.mjs",
      "args": ["run", "${relativeFile}"],
      "smartStep": true,
      "console": "integratedTerminal"
    }
  ]
}

Successivamente, nella scheda Debug, assicurati che sia selezionato 'Debug Current Test File'. Apri il file di test di cui desideri eseguire il debug e premi F5 per avviare il debug.

IntelliJ IDEA

Crea una configurazione di esecuzione 'Node.js'. Utilizza le seguenti impostazioni per eseguire tutti i test in modalità debug:

Impostazione	Valore
Working directory	/path/to/your-project-root
JavaScript file	./node_modules/vitest/vitest.mjs
Application parameters	run --pool forks

Quindi, esegui questa configurazione in modalità debug. L'IDE si fermerà sui breakpoint JS/TS impostati nell'editor.

Node Inspector, ad esempio Chrome DevTools

Vitest supporta anche il debug dei test senza un IDE. Tuttavia, questo richiede che i test non vengano eseguiti in parallelo. Utilizza uno dei seguenti comandi per avviare Vitest.

# Per eseguire in un singolo worker
vitest --inspect-brk --pool threads --poolOptions.threads.singleThread

# Per eseguire in un singolo processo figlio
vitest --inspect-brk --pool forks --poolOptions.forks.singleFork

Se stai usando Vitest 1.1 o superiore, puoi anche semplicemente fornire il flag --no-file-parallelism:

# Se il pool è sconosciuto
vitest --inspect-brk --no-file-parallelism

Una volta avviato, Vitest interromperà l'esecuzione e attenderà che tu apra gli strumenti di sviluppo che possono connettersi all'ispettore Node.js. Puoi usare Chrome DevTools aprendo chrome://inspect nel browser.

In modalità watch puoi mantenere aperto il debugger durante le riesecuzioni dei test usando le opzioni --poolOptions.threads.isolate false.