Hibakeresés

TIP

A tesztek hibakeresésekor használja a --test-timeout CLI argumentumot, hogy megakadályozza a tesztek időtúllépését a töréspontoknál történő megálláskor.

VS Code

A tesztek gyors hibakeresése VS Code-ban a JavaScript Debug Terminalon keresztül történik. Nyisson meg egy új JavaScript Debug Terminal-t, és futtassa az npm run test vagy közvetlenül a vitest parancsot. Ez a módszer bármilyen Node.js környezetben futó kóddal működik, így a legtöbb JS tesztelési keretrendszerrel is kompatibilis.

Létrehozhat egy külön indítási konfigurációt is egy tesztfájl hibakereséséhez a VS Code-ban:

{
  // További információkért látogasson el ide: https://go.microsoft.com/fwlink/?linkid=830387
  "version": "0.2.0",
  "configurations": [
    {
      "type": "node",
      "request": "launch",
      "name": "Jelenlegi tesztfájl hibakeresése",
      "autoAttachChildProcesses": true,
      "skipFiles": ["<node_internals>/**", "**/node_modules/**"],
      "program": "${workspaceRoot}/node_modules/vitest/vitest.mjs",
      "args": ["run", "${relativeFile}"],
      "smartStep": true,
      "console": "integratedTerminal"
    }
  ]
}

Ezután a hibakeresés fülön ellenőrizze, hogy a 'Jelenlegi tesztfájl hibakeresése' van kiválasztva. Nyissa meg a hibakeresni kívánt tesztfájlt, majd nyomja meg az F5 billentyűt a hibakeresés elindításához.

Böngésző mód

A Vitest Böngésző Mód hibakereséséhez használja a --inspect vagy --inspect-brk paramétert a CLI-ben, vagy definiálja a Vitest konfigurációjában:

CLI

vitest --inspect-brk --browser --no-file-parallelism

vitest.config.js

import { defineConfig } from 'vitest/config';

export default defineConfig({
  test: {
    inspectBrk: true,
    fileParallelism: false,
    browser: {
      name: 'chromium',
      provider: 'playwright',
    },
  },
});

Alapértelmezés szerint a Vitest a 9229-es portot használja hibakeresési portként. Ezt felülbírálhatja a --inspect-brk paraméter értékének megadásával:

vitest --inspect-brk=127.0.0.1:3000 --browser --no-file-parallelism

Az alábbi VSCode Összetett konfigurációt használja a Vitest indításához és a hibakereső csatlakoztatásához a böngészőben:

{
  "version": "0.2.0",
  "configurations": [
    {
      "type": "node",
      "request": "launch",
      "name": "Vitest böngésző futtatása",
      "program": "${workspaceRoot}/node_modules/vitest/vitest.mjs",
      "console": "integratedTerminal",
      "args": ["--inspect-brk", "--browser", "--no-file-parallelism"]
    },
    {
      "type": "chrome",
      "request": "attach",
      "name": "Csatlakozás Vitest böngészőhöz",
      "port": 9229
    }
  ],
  "compounds": [
    {
      "name": "Vitest böngésző hibakeresése",
      "configurations": ["Csatlakozás Vitest böngészőhöz", "Vitest böngésző futtatása"],
      "stopAll": true
    }
  ]
}

IntelliJ IDEA

Hozzon létre egy Vitest futtatási konfigurációt. Használja a következő beállításokat az összes teszt hibakeresési módban való futtatásához:

Beállítás	Érték
Munkakönyvtár	/path/to/your-project-root

Ezután futtassa ezt a konfigurációt hibakeresési módban. Az IDE megáll a szerkesztőben beállított JS/TS töréspontoknál.

Node Inspector, pl. Chrome DevTools

A Vitest támogatja a tesztek hibakeresését IDE-k nélkül is. Ehhez azonban szükséges, hogy a tesztek ne párhuzamosan fussanak. Használja az alábbi parancsok egyikét a Vitest elindításához:

# Egyetlen workerben való futtatáshoz
vitest --inspect-brk --pool threads --poolOptions.threads.singleThread

# Egyetlen gyermekfolyamatban való futtatáshoz
vitest --inspect-brk --pool forks --poolOptions.forks.singleFork

# Böngésző módban való futtatáshoz
vitest --inspect-brk --browser --no-file-parallelism

Ha Vitest 1.1 vagy újabb verziót használ, akkor egyszerűen megadhatja a --no-file-parallelism kapcsolót is:

# Ha a pool ismeretlen
vitest --inspect-brk --no-file-parallelism

Amint a Vitest elindul, leállítja a végrehajtást, és várja, hogy megnyissa a fejlesztői eszközöket, amelyek csatlakozni tudnak a Node.js inspectorhoz. Ehhez használhatja a Chrome DevTools-t a böngészőben a chrome://inspect megnyitásával.

Figyelő módban a hibakeresőt nyitva tarthatja a teszt újrafuttatások során a --poolOptions.threads.isolate false opció használatával.