跳到主要内容

使用 Blueprint 编写测试

概览​

测试工具包（通常是沙盒）已经包含在名为Blueprint的TypeScript SDK中。您可以创建一个演示项目并通过两个步骤启动默认测试：

  1. 创建一个新的Blueprint项目：
npm create ton@latest MyProject
  1. 运行测试：
cd MyProject
npx blueprint test

然后，您将在终端窗口中看到相应的输出：

% npx blueprint test

> [email protected] test
> jest

 PASS  tests/Main.spec.ts
  Main
    ✓ should deploy (127 ms)

Test Suites: 1 passed, 1 total
Tests:       1 passed, 1 total
Snapshots:   0 total
Time:        1.224 s, estimated 2 s
Ran all test suites.

基本用法​

测试智能合约可以涵盖安全性、优化Gas支出和检查极端情况。 在Blueprint（基于Sandbox）中编写测试是通过定义与合约的任意操作并将测试结果与预期结果进行比较来实现的，例如：

it('should execute with success', async () => {                              // description of the test case
    const res = await main.sendMessage(sender.getSender(), toNano('0.05'));  // performing an action with contract main and saving result in res

    expect(res.transactions).toHaveTransaction({                             // configure the expected result with expect() function
        from: main.address,                                                  // set expected sender for transaction we want to test matcher properties from
        success: true                                                        // set the desirable result using matcher property success
    });

    printTransactionFees(res.transactions);                                  // print table with details on spent fees
});

编写复杂Assertion的测试​

创建测试的基本流程是：

  1. 使用blockchain.openContract()创建特定的wrappedContract实体。
  2. 描述您的Contract应执行的操作并将执行结果保存在res变量中。
  3. 使用expect()函数和匹配器toHaveTransaction()验证属性。

toHaveTransaction匹配器所期望的对象包含以下属性中的任意组合，这些属性来自FlatTransaction类型

名称类型描述
fromAddress?消息发送者的合约地址
onAddress消息目的地的合约地址 （属性to的替代名称）。
value消息中Toncoin的数量，以nanotons计算
bodyCell定义为Cell的消息体
opnumber?op是操作标识符号码（通常为TL-B的crc32）。在消息体的前32位中。
successboolean?自定义沙盒标志，定义特定交易的结果状态。如果计算和行动阶段都成功，则为True。否则为False。

您可以省略您不感兴趣的字段，并传递接受类型并返回布尔值的函数（true表示可以），以检查例如数字范围、消息操作码等。请注意，如果字段是可选的（如from?: Address），那么函数也需要接受可选类型。

提示

您可以从Sandbox文档中查看所有匹配器字段的完整列表。

特定测试套件​

提取发送模式​

要提取发送消息的发送模式，您可以使用以下代码：

const re = await blockchain.executor.runTransaction({
    message: beginCell().endCell(),
    config: blockchain.configBase64,
    libs: null,
    verbosity: 'short',
    shardAccount: beginCell().storeAddress(address).endCell().toBoc().toString('base64'),
    now: Math. floor (Date.now()) / 1000,
    lt: BigInt(Date.now()),
    randomSeed: null,
    ignoreChksig: false,
    debugEnabled: true
});

if (!re.result.success || !re.result.actions) {
    throw new Error('fail');
}

const actions = loadOutList(Cell.fromBase64(re.result.actions).beginParse());
for (const act of actions) {
    if (act.type === "sendMsg") {
        // process action
        console.log(act.mode)
    }
}

教程​

从TON社区最有价值的教程中了解更多关于测试的信息：

示例​

查看用于TON生态系统合约的测试套件，并通过示例进行学习。

参阅​