Unit Test

Vona strongly recommends test-driven development. Test-driven development can effectively accumulate development results and identify potential problems as soon as possible when code changes occur, thereby significantly improving the robustness of the code

Vona uses a parallel mechanism to run test files, thereby significantly improving test efficiency

Create test file

1. Cli command

$ vona :create:test student --module=demo-student

2. Menu command

TIP

Context menu - [Module Path]: Vona Create/Test

Execute unit tests

$ npm run test

When this command is executed, the system will perform the following steps:

1. Create a global app object
2. Clean up Redis data
3. Delete the old database and recreate a new database
4. Execute migration code
5. Parallel execute unit test files

$ npm run db:reset

Unlike the test command, db:reset only executes the first four steps and does not execute the unit test files

Test coverage

$ npm run cov

Example

1. Simulate the request context object

describe('student.test.ts', () => {
  it('action:student', async () => {
    await app.bean.executor.mockCtx(async () => {
      // do something
    });
  });
});

• Specify the current language for ctx

describe('student.test.ts', () => {
  it('action:student', async () => {
    await app.bean.executor.mockCtx(async () => {
      // do something
    }, { locale: 'zh-cn' });
  });
});

2. Get the module Scope object

await app.bean.executor.mockCtx(async () => {
  const scopeTest = app.scope('demo-student');
});

3. Use Service

const scopeTest = app.scope('demo-student');
const students = await scopeTest.service.student.findAll();

4. Use Model

const scopeTest = app.scope('demo-student');
const students = await scopeTest.model.student.select();

5. Using Entity

const scopeTest = app.scope('demo-student');
const tableName = scopeTest.entity.student.$table;
const fieldName = scopeTest.entity.student.name;

6. Access API to test Controller

await app.bean.executor.mockCtx(async () => {
  const students = await app.bean.executor.performAction('get', '/demo/student');
});

7. Simulate authentication

• Simulate login

await app.bean.executor.mockCtx(async () => {
await app.bean.passport.signinMock();
});

You can specify the login username, the default is admin

await app.bean.passport.signinMock('admin');

• Get current user information

await app.bean.passport.signinMock();
const passport = app.bean.passport.getCurrent();
const auth = app.bean.passport.getCurrentAuth();
const user = app.bean.passport.getCurrentUser();
const roles = app.bean.passport.getCurrentRoles();

• Simulate logout

await app.bean.passport.signinMock();
await app.bean.passport.signout();

8. Tools: assert

Vona uses Node's built-in assertion library

import assert from 'node:assert';

await app.bean.executor.mockCtx(async () => {
  assert.equal(app.config.server.listen.port, 7102);
});

9. Tool: catchError

catchError can capture error exception more elegantly

• General writing

await app.bean.executor.mockCtx(async () => {
  const scopeTest = app.scope('demo-student');
  try {
    const students = await scopeTest.service.student.findAll();
  } catch (err) {
    // do something
  }
});

• Use catchError

import { catchError } from '@cabloy/utils';

await app.bean.executor.mockCtx(async () => {
  const scopeTest = app.scope('demo-student');
  const [students, err] = await catchError(() => {
    return scopeTest.service.student.findAll();
  });
  // do somthing on err
});

10. Complete Crud test

describe('student.test.ts', () => {
  it('action:student', async () => {
    await app.bean.executor.mockCtx(async () => {
      // data
      const data: DtoStudentCreate = {
        name: '__Tom__',
        description: 'This is a test',
      };
      const dataUpdate: DtoStudentUpdate = {
        name: '__TomNew__',
        description: 'This is a test',
      };
      // login
      await app.bean.passport.signinMock();
      // create
      const studentId = await app.bean.executor.performAction('post', '/demo/student', { body: data });
      assert.equal(!!studentId, true);
      // findAll
      const students: EntityStudent[] = await app.bean.executor.performAction('get', '/demo/student');
      assert.equal(students.findIndex(item => item.name === data.name) > -1, true);
      // update
      await app.bean.executor.performAction('patch', '/demo/student/:id', {
        params: { id: studentId },
        body: dataUpdate,
      });
      // findOne
      const student: EntityStudent = await app.bean.executor.performAction('get', '/demo/student/:id', { params: { id: studentId } });
      assert.equal(student.name, dataUpdate.name);
      // delete
      await app.bean.executor.performAction('delete', '/demo/student/:id', { params: { id: student.id } });
      // findOne
      const [_, err] = await catchError(() => {
        return app.bean.executor.performAction('get', '/demo/student/:id', { params: { id: student.id } });
      });
      assert.equal(err?.code, 404);
      // logout
      await app.bean.passport.signout();
    });
  });
});