fix: add WouldBlock error (#17339)

cli/tests/unit/error_test.ts

@@ -15,6 +15,7 @@ Deno.test("Errors work", () => {
   assert(new Deno.errors.InvalidData("msg") instanceof Error);
   assert(new Deno.errors.TimedOut("msg") instanceof Error);
   assert(new Deno.errors.Interrupted("msg") instanceof Error);
+  assert(new Deno.errors.WouldBlock("msg") instanceof Error);
   assert(new Deno.errors.WriteZero("msg") instanceof Error);
   assert(new Deno.errors.UnexpectedEof("msg") instanceof Error);
   assert(new Deno.errors.BadResource("msg") instanceof Error);

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

@@ -219,6 +219,12 @@ declare namespace Deno {
      *
      * @category Errors */
     export class Interrupted extends Error {}
+    /**
+     * Raised when the underlying operating system would need to block to
+     * complete but an asynchronous (non-blocking) API is used.
+     *
+     * @category Errors */
+    export class WouldBlock extends Error {}
     /**
      * Raised when expecting to write to a IO buffer resulted in zero bytes
      * being written.

core/error_codes.rs

@@ -56,6 +56,7 @@ fn get_io_error_code(err: &std::io::Error) -> &'static str {
     // ErrorKind::ExecutableFileBusy => "ETXTBSY",
     // ErrorKind::CrossesDevices => "EXDEV",
     ErrorKind::PermissionDenied => "EACCES", // NOTE: Collides with EPERM ...
+    ErrorKind::WouldBlock => "EWOULDBLOCK",  // NOTE: Collides with EAGAIN ...
     _ => "",
   }
 }

runtime/errors.rs

@@ -58,7 +58,7 @@ fn get_io_error_class(error: &io::Error) -> &'static str {
     WriteZero => "WriteZero",
     UnexpectedEof => "UnexpectedEof",
     Other => "Error",
-    WouldBlock => unreachable!(),
+    WouldBlock => "WouldBlock",
     // Non-exhaustive enum - might add new variants
     // in the future
     _ => "Error",

runtime/js/01_errors.js

@@ -96,6 +96,13 @@ class WriteZero extends Error {
   }
 }
 
+class WouldBlock extends Error {
+  constructor(msg) {
+    super(msg);
+    this.name = "WouldBlock";
+  }
+}
+
 class UnexpectedEof extends Error {
   constructor(msg) {
     super(msg);
@@ -139,6 +146,7 @@ const errors = {
   TimedOut,
   Interrupted,
   WriteZero,
+  WouldBlock,
   UnexpectedEof,
   BadResource,
   Http,

runtime/js/99_main.js

@@ -265,6 +265,7 @@ function registerErrors() {
   core.registerErrorClass("InvalidData", errors.InvalidData);
   core.registerErrorClass("TimedOut", errors.TimedOut);
   core.registerErrorClass("Interrupted", errors.Interrupted);
+  core.registerErrorClass("WouldBlock", errors.WouldBlock);
   core.registerErrorClass("WriteZero", errors.WriteZero);
   core.registerErrorClass("UnexpectedEof", errors.UnexpectedEof);
   core.registerErrorClass("BadResource", errors.BadResource);