Function runFuzz

packages/testkit/src/fuzz.ts:136–175

(options: FuzzRunOptions, body: FuzzBody)

}

export async function runFuzz(options: FuzzRunOptions, body: FuzzBody): Promise<FuzzRunSummary> {
  const label = options.label ?? "fuzz";
  assertUInt32("seed", options.seed);
  assertPositiveInteger("iterations", options.iterations);

  for (let iteration = 0; iteration < options.iterations; iteration++) {
    const caseSeed = deriveFuzzCaseSeed(options.seed, iteration);
    const notes: string[] = [];
    const ctx: FuzzIterationContext = Object.freeze({
      label,
      seed: options.seed >>> 0,
      iteration,
      caseSeed,
      rng: createRng(caseSeed),
      note(message: string): void {
        notes.push(message);
      },
      fail(message: string, cause?: unknown): never {
        throw new FuzzFailureError(
          { label, seed: options.seed >>> 0, iteration, caseSeed },
          cause === undefined ? new Error(message) : new Error(message, { cause }),
          notes,
        );
      },
    });

    try {
      await body(ctx);
    } catch (cause: unknown) {
      if (cause instanceof FuzzFailureError) throw cause;
      throw new FuzzFailureError(ctx, cause, notes);
    }
  }

  return Object.freeze({
    label,
    seed: options.seed >>> 0,
    iterations: options.iterations,
  });
}

export function fuzzTest(name: string, options: FuzzRunOptions, body: FuzzBody): void {
  const label = options.label ?? name;