From 35f12ded428e57cae1cfa0e0c84b789eb44a4fda Mon Sep 17 00:00:00 2001
From: "Michael B. Gale" <mbg@github.com>
Date: Tue, 6 Oct 2026 16:10:21 +0100
Subject: [PATCH] Add utility for assertions on sinon stubs with better output
 by default

---
 src/testing-utils.ts | 28 ++++++++++++++++++++++++++++
 1 file changed, 28 insertions(+)

diff --git a/src/testing-utils.ts b/src/testing-utils.ts
index df81f51bb..2b188857a 100644
--- a/src/testing-utils.ts
+++ b/src/testing-utils.ts
@@ -163,6 +163,34 @@ export function setupTests(testFn: TestFn<any>) {
   });
 }
 
+export interface AvaSinonAssertions {
+  /**
+   * Asserts that `stub` must have been called once with at least the `expected` arguments.
+   */
+  onceWith: <TArgs extends readonly any[]>(
+    stub: sinon.SinonStub<TArgs>,
+    ...expected: sinon.MatchPartialArguments<TArgs>
+  ) => boolean;
+}
+
+/** Adds additional assertions for use with `sinon` to `t`. */
+export function addSinonAssertions(
+  t: ExecutionContext<unknown>,
+): ExecutionContext<unknown> & AvaSinonAssertions {
+  return {
+    ...t,
+    onceWith: (stub, ...expected) => {
+      if (stub.callCount > 0) {
+        // Reduce the arguments of the first call to the same number that was provided,
+        // so that extra arguments don't lead to a failure.
+        return t.deepEqual(stub.args[0].slice(0, expected.length), expected);
+      } else {
+        return t.fail("The stub wasn't called.");
+      }
+    },
+  };
+}
+
 /**
  * Declare a reusable test implementation, with better type safety than `test.macro`.
  */