This package contains useful testing utilities, such as unit test matchers (for jest, chai, and bun) and other useful functions, such as randomAddress.

yarn add @ton/test-utils -D

or

npm i --save-dev @ton/test-utils

To use the test matchers, just install either jest, chai, or bun and import this package like so:

import "@ton/test-utils";

import { expect } from '@jest/globals';
import "@ton/test-utils";

test('cell comparison', () => {
    expect(cell1).toEqualCell(cell2);
});

import { expect } from 'chai';
import "@ton/test-utils";

it('cell comparison', () => {
    expect(cell1).to.equalCell(cell2);
});

import { expect, test } from 'bun:test';
import "@ton/test-utils";

test('cell comparison', () => {
    expect(cell1).toEqualCell(cell2);
});

The transaction matcher (.toHaveTransaction) can only perform matching on transactions with descriptions of type generic. When matching an array of transactions, all transactions of other types will be filtered out. When matching a single transaction of non-generic type, an exception will be thrown.

This package is released under the MIT License.