feat: stabilize test steps API (#13400)

cli/dts/lib.deno.ns.d.ts

@@ -113,8 +113,40 @@ declare namespace Deno {
    * See: https://no-color.org/ */
   export const noColor: boolean;
 
-  /** **UNSTABLE**: New option, yet to be vetted. */
   export interface TestContext {
+    /** Run a sub step of the parent test or step. Returns a promise
+     * that resolves to a boolean signifying if the step completed successfully.
+     * The returned promise never rejects unless the arguments are invalid.
+     * If the test was ignored the promise returns `false`.
+     */
+    step(t: TestStepDefinition): Promise<boolean>;
+
+    /** Run a sub step of the parent test or step. Returns a promise
+     * that resolves to a boolean signifying if the step completed successfully.
+     * The returned promise never rejects unless the arguments are invalid.
+     * If the test was ignored the promise returns `false`.
+     */
+    step(
+      name: string,
+      fn: (t: TestContext) => void | Promise<void>,
+    ): Promise<boolean>;
+  }
+
+  export interface TestStepDefinition {
+    fn: (t: TestContext) => void | Promise<void>;
+    name: string;
+    ignore?: boolean;
+    /** Check that the number of async completed ops after the test step is the same
+     * as number of dispatched ops. Defaults to the parent test or step's value. */
+    sanitizeOps?: boolean;
+    /** Ensure the test step does not "leak" resources - ie. the resource table
+     * after the test has exactly the same contents as before the test. Defaults
+     * to the parent test or step's value. */
+    sanitizeResources?: boolean;
+    /** Ensure the test step does not prematurely cause the process to exit,
+     * for example via a call to `Deno.exit`. Defaults to the parent test or
+     * step's value. */
+    sanitizeExit?: boolean;
   }
 
   export interface TestDefinition {

cli/dts/lib.deno.unstable.d.ts

@@ -934,43 +934,6 @@ declare namespace Deno {
    */
   export function sleepSync(millis: number): void;
 
-  /** **UNSTABLE**: New option, yet to be vetted. */
-  export interface TestContext {
-    /** Run a sub step of the parent test with a given name. Returns a promise
-     * that resolves to a boolean signifying if the step completed successfully.
-     * The returned promise never rejects unless the arguments are invalid.
-     * If the test was ignored, the promise returns `false`.
-     */
-    step(t: TestStepDefinition): Promise<boolean>;
-
-    /** Run a sub step of the parent test with a given name. Returns a promise
-     * that resolves to a boolean signifying if the step completed successfully.
-     * The returned promise never rejects unless the arguments are invalid.
-     * If the test was ignored, the promise returns `false`.
-     */
-    step(
-      name: string,
-      fn: (t: TestContext) => void | Promise<void>,
-    ): Promise<boolean>;
-  }
-
-  /** **UNSTABLE**: New option, yet to be vetted. */
-  export interface TestStepDefinition {
-    fn: (t: TestContext) => void | Promise<void>;
-    name: string;
-    ignore?: boolean;
-    /** Check that the number of async completed ops after the test is the same
-     * as number of dispatched ops. Defaults to true. */
-    sanitizeOps?: boolean;
-    /** Ensure the test case does not "leak" resources - ie. the resource table
-     * after the test has exactly the same contents as before the test. Defaults
-     * to true. */
-    sanitizeResources?: boolean;
-    /** Ensure the test case does not prematurely cause the process to exit,
-     * for example via a call to `Deno.exit`. Defaults to true. */
-    sanitizeExit?: boolean;
-  }
-
   /** **UNSTABLE**: new API, yet to be vetted.
    *
    * A generic transport listener for message-oriented protocols. */

cli/tests/integration/test_tests.rs

@@ -222,37 +222,31 @@ itest!(aggregate_error {
 });
 
 itest!(steps_passing_steps {
-  args: "test --unstable test/steps/passing_steps.ts",
+  args: "test test/steps/passing_steps.ts",
   exit_code: 0,
   output: "test/steps/passing_steps.out",
 });
 
 itest!(steps_passing_steps_concurrent {
-  args: "test --unstable --jobs=2 test/steps/passing_steps.ts",
+  args: "test --jobs=2 test/steps/passing_steps.ts",
   exit_code: 0,
   output: "test/steps/passing_steps.out",
 });
 
 itest!(steps_failing_steps {
-  args: "test --unstable test/steps/failing_steps.ts",
+  args: "test test/steps/failing_steps.ts",
   exit_code: 1,
   output: "test/steps/failing_steps.out",
 });
 
 itest!(steps_ignored_steps {
-  args: "test --unstable test/steps/ignored_steps.ts",
+  args: "test test/steps/ignored_steps.ts",
   exit_code: 0,
   output: "test/steps/ignored_steps.out",
 });
 
 itest!(steps_invalid_usage {
-  args: "test --unstable test/steps/invalid_usage.ts",
+  args: "test test/steps/invalid_usage.ts",
   exit_code: 1,
   output: "test/steps/invalid_usage.out",
 });
-
-itest!(steps_no_unstable_flag {
-  args: "test test/steps/no_unstable_flag.ts",
-  exit_code: 1,
-  output: "test/steps/no_unstable_flag.out",
-});

cli/tests/testdata/test/steps/no_unstable_flag.out

@@ -1,13 +0,0 @@
-[WILDCARD]
-running 1 test from [WILDCARD]/no_unstable_flag.ts
-test description ... FAILED ([WILDCARD])
-
-failures:
-
-description
-Error: Test steps are unstable. The --unstable flag must be provided.
-    at [WILDCARD]
-
-failures:
-
-[WILDCARD]

cli/tests/testdata/test/steps/no_unstable_flag.ts

@@ -1,4 +0,0 @@
-Deno.test("description", async (t) => {
-  // deno-lint-ignore no-explicit-any
-  await (t as any).step("step", () => {});
-});

runtime/js/40_testing.js

@@ -29,7 +29,6 @@
     RegExpPrototypeTest,
     SymbolToStringTag,
   } = window.__bootstrap.primordials;
-  let testStepsEnabled = false;
 
   const opSanitizerDelayResolveQueue = [];
 
@@ -746,12 +745,6 @@ finishing test case.`;
        * @param fn {(t: TestContext) => void | Promise<void>}
        */
       async step(nameOrTestDefinition, fn) {
-        if (!testStepsEnabled) {
-          throw new Error(
-            "Test steps are unstable. The --unstable flag must be provided.",
-          );
-        }
-
         if (parentStep.finalized) {
           throw new Error(
             "Cannot run test step after parent scope has finished execution. " +
@@ -890,14 +883,9 @@ finishing test case.`;
     return value == null ? defaultValue : value;
   }
 
-  function enableTestSteps() {
-    testStepsEnabled = true;
-  }
-
   window.__bootstrap.internals = {
     ...window.__bootstrap.internals ?? {},
     runTests,
-    enableTestSteps,
   };
 
   window.__bootstrap.testing = {

runtime/js/99_main.js

@@ -214,9 +214,6 @@ delete Object.prototype.__proto__;
       runtimeOptions.v8Version,
       runtimeOptions.tsVersion,
     );
-    if (runtimeOptions.unstableFlag) {
-      internals.enableTestSteps();
-    }
     build.setBuildInfo(runtimeOptions.target);
     util.setLogDebug(runtimeOptions.debugFlag, source);
     const prepareStackTrace = core.createPrepareStackTrace(