feat(testing): add context to beforeEach and afterEach hooks

testing/_test_suite.ts

@@ -25,12 +25,12 @@ export interface DescribeDefinition<T> extends Omit<Deno.TestDefinition, "fn"> {
     | ((this: T) => void | Promise<void>)[];
   /** Run some shared setup before each test in the suite. */
   beforeEach?:
-    | ((this: T) => void | Promise<void>)
-    | ((this: T) => void | Promise<void>)[];
+    | ((this: T, context: Deno.TestContext) => void | Promise<void>)
+    | ((this: T, context: Deno.TestContext) => void | Promise<void>)[];
   /** Run some shared teardown after each test in the suite. */
   afterEach?:
-    | ((this: T) => void | Promise<void>)
-    | ((this: T) => void | Promise<void>)[];
+    | ((this: T, context: Deno.TestContext) => void | Promise<void>)
+    | ((this: T, context: Deno.TestContext) => void | Promise<void>)[];
 }
 
 /** The options for creating an individual test case with the it function. */
@@ -368,21 +368,21 @@ export class TestSuiteInternal<T> implements TestSuite<T> {
       if (activeIndex === 0) context = { ...context };
       const { beforeEach } = testSuite.describe;
       if (typeof beforeEach === "function") {
-        await beforeEach.call(context);
+        await beforeEach.call(context, t);
       } else if (beforeEach) {
         for (const hook of beforeEach) {
-          await hook.call(context);
+          await hook.call(context, t);
         }
       }
       try {
         await TestSuiteInternal.runTest(t, fn, context, activeIndex + 1);
       } finally {
         const { afterEach } = testSuite.describe;
         if (typeof afterEach === "function") {
-          await afterEach.call(context);
+          await afterEach.call(context, t);
         } else if (afterEach) {
           for (const hook of afterEach) {
-            await hook.call(context);
+            await hook.call(context, t);
           }
         }
       }

testing/bdd_test.ts

@@ -2,6 +2,8 @@
 import {
   assert,
   assertEquals,
+  assertExists,
+  assertMatch,
   assertObjectMatch,
   assertRejects,
   assertStrictEquals,
@@ -2059,4 +2061,29 @@ Deno.test("describe()", async (t) => {
       );
     },
   );
+
+  await t.step("context for beforeEach and afterEach", async (t) => {
+    await t.step(
+      "test context names",
+      async () =>
+        await assertOptions({}, (fns) => {
+          const suite = describe({
+            // deno-lint-ignore no-explicit-any
+            afterEach(this: any, ctx: Deno.TestContext) {
+              assertExists(ctx);
+              assertMatch(ctx.name, /^(a|b)/);
+            },
+            // deno-lint-ignore no-explicit-any
+            beforeEach(this: any, ctx: Deno.TestContext) {
+              assertExists(ctx);
+              assertMatch(ctx.name, /^(a|b)/);
+            },
+          }, function example() {
+            assertEquals(it({ name: "a", fn: fns[0] }), undefined);
+          });
+          assert(suite && typeof suite.symbol === "symbol");
+          assertEquals(it({ suite, name: "b", fn: fns[1] }), undefined);
+        }),
+    );
+  });
 });