Skip to main content
Deno.errors - Deno documentation
namespace Deno.errors

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;
  }
}

Classes

c
Deno.errors.AddrInUse

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

c
Deno.errors.AddrNotAvailable

Raised when the underlying operating system reports an EADDRNOTAVAIL error.

c
Deno.errors.AlreadyExists

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

c
Deno.errors.BadResource

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

c
Deno.errors.BrokenPipe

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.

c
Deno.errors.Busy

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

c
Deno.errors.ConnectionAborted

Raised when the underlying operating system reports an ECONNABORTED error.

c
Deno.errors.ConnectionRefused

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

c
Deno.errors.ConnectionReset

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.

c
Deno.errors.FilesystemLoop

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

c
Deno.errors.Http

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

c
Deno.errors.Interrupted

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 @{link BadResource} error instead.

c
Deno.errors.InvalidData

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

c
Deno.errors.IsADirectory

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

c
Deno.errors.NetworkUnreachable

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

c
Deno.errors.NotADirectory

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

c
Deno.errors.NotCapable

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

c
Deno.errors.NotConnected

Raised when the underlying operating system reports an ENOTCONN error.

c
Deno.errors.NotFound

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

c
Deno.errors.NotSupported

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

c
Deno.errors.PermissionDenied

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.

c
Deno.errors.TimedOut

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

c
Deno.errors.UnexpectedEof

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

c
Deno.errors.WouldBlock

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

c
Deno.errors.WriteZero

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