feat(runtime): add noThrow property

src/runtime/process.ts

@@ -20,6 +20,7 @@ export class Process implements Promise<ProcessOutput> {
   #baseError: ProcessError;
   #maxRetries = 0;
   #retries = 0;
+  #throwErrors = true;
 
   constructor(cmd: string, { errorContext }: ProcessOptions = {}) {
     this.#cmd = cmd;
@@ -50,6 +51,11 @@ export class Process implements Promise<ProcessOutput> {
     return this.#process.pid;
   }
 
+  get noThrow(): this {
+    this.#throwErrors = false;
+    return this;
+  }
+
   retry(retries: number): this {
     this.#maxRetries = retries;
     return this;
@@ -117,21 +123,31 @@ export class Process implements Promise<ProcessOutput> {
       });
 
       if (!status.success) {
-        throw ProcessError.merge(
+        const error = ProcessError.merge(
           this.#baseError,
           new ProcessError(output),
         );
+
+        if (this.#throwErrors) {
+          throw error;
+        }
+        this.#close();
+
+        return error;
       }
       this.#close();
 
       return output;
     } catch (error) {
       this.#close();
+
       if (this.#retries < this.#maxRetries) {
         this.#retries++;
         this.#proc = null;
+
         return this.#run();
       }
+
       throw error;
     }
   }

test.ts

@@ -122,3 +122,9 @@ Deno.test("markdown files can be executed as scripts", async () => {
   assertStringIncludes(output.stdout, `$ echo "Hello World!"`);
   assertStringIncludes(output.stdout, `$ echo "Hello again World!"`);
 });
+
+Deno.test("$ should not throw with noThrow", async () => {
+  const result = await $`exit 1`.noThrow;
+
+  assertEquals(result.status.code, 1);
+});