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 portthat already has a listener.

c
Deno.errors.AddrNotAvailable

Raised when the underlying operating system reports an EADDRNOTAVAILerror.

c
Deno.errors.AlreadyExists

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

c
Deno.errors.BadResource

The underlying IO resource is invalid or closed, and so the operationcould 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 stderrand the operating system is unable to pipe the output for a reasonexternal to the Deno runtime.

c
Deno.errors.Busy

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

c
Deno.errors.ConnectionAborted

Raised when the underlying operating system reports an ECONNABORTEDerror.

c
Deno.errors.ConnectionRefused

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

c
Deno.errors.ConnectionReset

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

c
Deno.errors.FilesystemLoop

Raised when too many symbolic links were encountered when resolving thefilename.

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. Inmany cases, this underlying IO error will be handled internally withinDeno, or result in an @{link BadResource} error instead.

c
Deno.errors.InvalidData

Raised when an operation to returns data that is invalid for theoperation 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 isnot reachable.

c
Deno.errors.NotADirectory

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

c
Deno.errors.NotCapable

Raised when trying to perform an operation while the relevant Denopermission (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 filewas not found.

c
Deno.errors.NotSupported

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

c
Deno.errors.PermissionDenied

Raised when the underlying operating system indicates the current userwhich the Deno process is running under does not have the appropriatepermissions to a file or resource.

c
Deno.errors.TimedOut

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

c
Deno.errors.UnexpectedEof

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

c
Deno.errors.WouldBlock

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

c
Deno.errors.WriteZero

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