Touca is available on NPM:
npm install --save-dev @touca/node
This package is pure ESM and works with Node 14 or newer.
For a more thorough guide of how to use Touca SDK for JavaScript, see our documentation website.
Let us imagine that we want to test a software workflow that takes the username of a student and provides basic information about them.
import { find_student } from "code_under_test";
test("test_find_student", () => {
const alice = find_student("alice");
expect(alice.fullname).toEqual("Alice Anderson");
expect(alice.dob).toEqual({2006, 3, 1});
expect(alice.gpa).toEqual(3.9);
});
We can use unit testing in which we hard-code expected values for each input. But real-world software is complex:
Touca is effective in testing software workflows that need to handle a large variety of inputs or whose expected behavior is difficult to hard-code.
import { touca } from '@touca/node';
import { find_student } from './students';
touca.workflow('students_test', async (username: string) => {
const student = await find_student(username);
touca.assume('username', student.username);
touca.check('fullname', student.fullname);
touca.check('birth_date', student.dob);
touca.check('gpa', student.gpa);
});
touca.run();
This is slightly different from a typical unit test:
With Touca, we describe how we run our code under test for any given test case. We can capture values of interesting variables and runtime of important functions to describe the behavior and performance of our workflow for that test case.
Now if we make changes to our workflow under test, we can rerun this test and let Touca automatically compare our captured data points against those of a previous baseline version and report any difference in behavior or performance.
We hang on Discord. Come say hi! We love making new friends. If you need help, have any questions, or like to contribute or provide feedback, that's the best place to be.
We welcome all forms of contributions, from adding new features to improving documentation and sharing feedback.
This repository is released under the Apache-2.0 License. See
LICENSE
.