Errors

Raised when attempting to open a server listener on an address and port that already has a listener.

Raised when the underlying operating system reports an EADDRNOTAVAIL error.

Raised when trying to create a resource, like a file, that already exits.

The underlying IO resource is invalid or closed, and so the operation could not be performed.

Raised when trying to write to a resource and a broken pipe error occurs. This can happen when trying to write directly to stdout or stderr and the operating system is unable to pipe the output for a reason external to the Deno runtime.

Raised when the underlying IO resource is not available because it is being awaited on in another block of code.

Raised when the underlying operating system reports an ECONNABORTED error.

Raised when the underlying operating system reports that a connection to a resource is refused.

Raised when the underlying operating system reports that a connection has been reset. With network servers, it can be a normal occurrence where a client will abort a connection instead of properly shutting it down.

Raised when too many symbolic links were encountered when resolving the filename.

Raised in situations where when attempting to load a dynamic import, too many redirects were encountered.

Raised when the underlying operating system reports an EINTR error. In many cases, this underlying IO error will be handled internally within Deno, or result in an BadResource error instead.

Raised when an operation returns data that is invalid for the operation being performed.

Raised when trying to open, create or write to a directory.

Raised when performing a socket operation but the remote host is not reachable.

Raised when trying to perform an operation on a path that is not a directory, when directory is required.

Raised when trying to perform an operation while the relevant Deno permission (like --allow-read) has not been granted.

Before Deno 2.0, this condition was covered by the PermissionDenied error.

Raised when the underlying operating system reports an ENOTCONN error.

Raised when the underlying operating system indicates that the file was not found.

Raised when the underlying Deno API is asked to perform a function that is not currently supported.

Raised when the underlying operating system indicates the current user which the Deno process is running under does not have the appropriate permissions to a file or resource.

Before Deno 2.0, this error was raised when the user did not provide required --allow-* flag. As of Deno 2.0, that case is now handled by the NotCapable error.

Raised when the underlying operating system reports that an I/O operation has timed out (ETIMEDOUT).

Raised when attempting to read bytes from a resource, but the EOF was unexpectedly encountered.

Raised when the underlying operating system would need to block to complete but an asynchronous (non-blocking) API is used.

Raised when expecting to write to a IO buffer resulted in zero bytes being written.

A set of error constructors that are raised by Deno APIs.

Can be used to provide more specific handling of failures within code which is using Deno APIs. For example, handling attempting to open a file which does not exist:

try {
  const file = await Deno.open("./some/file.txt");
} catch (error) {
  if (error instanceof Deno.errors.NotFound) {
    console.error("the file was not found");
  } else {
    // otherwise re-throw
    throw error;
  }
}