Foundry 中文文档

内联测试配置

Foundry 用户可以使用 foundry.toml 中的 ENV 变量和配置语句来指定整体测试配置。请查看Testing reference以获取详细描述。

尽管这在一般情况下可能有效，但某些测试可能需要对其配置进行更精细的控制。出于这样的原因，Forge 提供了一种方式来为不变和模糊测试场景指定每个测试的配置。

用户可以直接在 Solidity 注释中进行内联测试配置语句。这将影响 forge test 命令对特定测试实例的行为，如下例所示。

contract MyTest is Test {
  /// forge-config: default.fuzz.runs = 100
  /// forge-config: ci.fuzz.runs = 500
  function test_SimpleFuzzTest(uint256 x) public {
    // --- snip ---
  }
}

这里我们要求对 default 和 ci 配置分别运行我们的 fuzzer 100 和 500 次。有趣的是，这将覆盖全局级别现有的任何模糊 runs 设置。所有其他配置将从全局上下文中继承，使其作为所有可能配置的备份。

块注释

内联测试配置也可以在块注释中表示，如下例所示。

contract MyTest is Test {
  /**
   * forge-config: default.fuzz.runs = 1024
   * forge-config: default.fuzz.max-test-rejects = 500
   */
  function test_SimpleFuzzTest(uint256 x) public {
    // --- snip ---
  }
}

内联模糊配置

用户可以指定表中描述的配置。每个语句必须具有形式为 forge-config: ${PROFILE}.fuzz. 的前缀。

模糊配置示例

contract MyFuzzTest is Test {
  /// forge-config: default.fuzz.runs = 100
  /// forge-config: default.fuzz.max-test-rejects = 2
  function test_InlineConfig(uint256 x) public {
    // --- snip ---
  }
}

内联不变配置

用户可以指定表中描述的配置。每个语句必须具有形式为 forge-config: ${PROFILE}.invariant. 的前缀。

不变配置示例

contract MyInvariantTest is Test {
  /// forge-config: default.invariant.runs = 100
  /// forge-config: default.invariant.depth = 2
  /// forge-config: default.invariant.fail-on-revert = false
  /// forge-config: default.invariant.call-override = true
  function invariant_InlineConfig() public {
    // --- snip ---
  }
}