Testing Guide

Unit Testing

We use vitest to run unit tests.

1. yarn run test to run all unit tests
2. yarn run test:ui enable UI to run tests
3. config launch.json in vscode https://vitest.dev/guide/debugging.html#vs-code to run single fi

{
  "version": "0.2.0",
  "configurations": [
    {
      "type": "node",
      "request": "launch",
      "name": "Debug Current Test File",
      "autoAttachChildProcesses": true,
      "skipFiles": ["<node_internals>/", "/node_modules/**"],
      "program": "${workspaceRoot}/node_modules/vitest/vitest.mjs",
      "args": ["dev", "${relativeFile}"],
      "smartStep": true,
      "console": "integratedTerminal"
    }
  ]
}

E2E Testing

We use playwright to run e2e tests for the web client. There are steps to run e2e:

1. start server to speed up
2. yarn run dev to run the web server if need
3. yarn workspace @affine/server dev to run the node server if need
4. enter the e2e directory
5. tests/affine-cloud e2e for web cloud features, with web client and node server
6. tests/affine-desktop e2e for electron client features
7. tests/affine-desktop-cloud e2e for electron cloud features, with electron client and node server
8. tests/affine-legacy e2e for legacy client to create data
9. tests/affine-local e2e for web client
10. tests/affine-migration e2e for migration, just in web environment
11. tests/storybook storybook for component
12. run e2e case
13. yarn run e2e run all e2e cases
14. yarn run e2e --ui use ui to run e2e cases
15. use https://marketplace.visualstudio.com/items?itemName=ms-playwright.playwright to run and debug single case.