Skip to main content
Module

std/node/_errors.ts

Deno standard library
denoland/deno
Go to Latest
File
123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484
// Copyright Node.js contributors. All rights reserved. MIT License./************ NOT IMPLEMENTED* ERR_INVALID_ARG_VALUE* ERR_INVALID_MODULE_SPECIFIER* ERR_INVALID_PACKAGE_TARGET* ERR_INVALID_URL_SCHEME* ERR_MANIFEST_ASSERT_INTEGRITY* ERR_MISSING_ARGS* ERR_MODULE_NOT_FOUND* ERR_PACKAGE_PATH_NOT_EXPORTED* ERR_QUICSESSION_VERSION_NEGOTIATION* ERR_REQUIRE_ESM* ERR_SOCKET_BAD_PORT* ERR_TLS_CERT_ALTNAME_INVALID* ERR_UNHANDLED_ERROR* ERR_WORKER_INVALID_EXEC_ARGV* ERR_WORKER_PATH* ERR_QUIC_ERROR* ERR_SOCKET_BUFFER_SIZE //System error, shouldn't ever happen inside Deno* ERR_SYSTEM_ERROR //System error, shouldn't ever happen inside Deno* ERR_TTY_INIT_FAILED //System error, shouldn't ever happen inside Deno* ERR_INVALID_PACKAGE_CONFIG // package.json stuff, probably useless*************/
import { unreachable } from "../testing/asserts.ts";
/** * All error instances in Node have additional methods and properties * This export class is meant to be extended by these instances abstracting native JS error instances */export class NodeErrorAbstraction extends Error {  code: string;
  constructor(name: string, code: string, message: string) {    super(message);    this.code = code;    this.name = name;    //This number changes dependending on the name of this class    //20 characters as of now    this.stack = this.stack && `${name} [${this.code}]${this.stack.slice(20)}`;  }
  toString() {    return `${this.name} [${this.code}]: ${this.message}`;  }}
export class NodeError extends NodeErrorAbstraction {  constructor(code: string, message: string) {    super(Error.prototype.name, code, message);  }}
export class NodeSyntaxError extends NodeErrorAbstraction  implements SyntaxError {  constructor(code: string, message: string) {    super(SyntaxError.prototype.name, code, message);    Object.setPrototypeOf(this, SyntaxError.prototype);  }}
export class NodeRangeError extends NodeErrorAbstraction {  constructor(code: string, message: string) {    super(RangeError.prototype.name, code, message);    Object.setPrototypeOf(this, RangeError.prototype);  }}
export class NodeTypeError extends NodeErrorAbstraction implements TypeError {  constructor(code: string, message: string) {    super(TypeError.prototype.name, code, message);    Object.setPrototypeOf(this, TypeError.prototype);  }}
export class NodeURIError extends NodeErrorAbstraction implements URIError {  constructor(code: string, message: string) {    super(URIError.prototype.name, code, message);    Object.setPrototypeOf(this, URIError.prototype);  }}
export class ERR_INVALID_ARG_TYPE extends NodeTypeError {  constructor(a1: string, a2: string | string[], a3: unknown) {    super(      "ERR_INVALID_ARG_TYPE",      `The "${a1}" argument must be of type ${        typeof a2 === "string"          ? a2.toLocaleLowerCase()          : a2.map((x) => x.toLocaleLowerCase()).join(", ")      }. Received ${typeof a3} (${a3})`,    );  }}
export class ERR_OUT_OF_RANGE extends RangeError {  code = "ERR_OUT_OF_RANGE";
  constructor(str: string, range: string, received: unknown) {    super(      `The value of "${str}" is out of range. It must be ${range}. Received ${received}`,    );
    const { name } = this;    // Add the error code to the name to include it in the stack trace.    this.name = `${name} [${this.code}]`;    // Access the stack to generate the error message including the error code from the name.    this.stack;    // Reset the name to the actual name.    this.name = name;  }}
// In Node these values are coming from libuv:// Ref: https://github.com/libuv/libuv/blob/v1.x/include/uv/errno.h// Ref: https://github.com/nodejs/node/blob/524123fbf064ff64bb6fcd83485cfc27db932f68/lib/internal/errors.js#L383// Since there is no easy way to port code from libuv and these maps are// changing very rarely, we simply extract them from Node and store here.
// Note// Run the following to get the map:// $ node -e "console.log(process.binding('uv').getErrorMap())"// This setup automatically exports maps from both "win", "linux" & darwin:// https://github.com/schwarzkopfb/node_errno_map
type ErrMapData = Array<[number, [string, string]]>;
const windows: ErrMapData = [  [-4093, ["E2BIG", "argument list too long"]],  [-4092, ["EACCES", "permission denied"]],  [-4091, ["EADDRINUSE", "address already in use"]],  [-4090, ["EADDRNOTAVAIL", "address not available"]],  [-4089, ["EAFNOSUPPORT", "address family not supported"]],  [-4088, ["EAGAIN", "resource temporarily unavailable"]],  [-3000, ["EAI_ADDRFAMILY", "address family not supported"]],  [-3001, ["EAI_AGAIN", "temporary failure"]],  [-3002, ["EAI_BADFLAGS", "bad ai_flags value"]],  [-3013, ["EAI_BADHINTS", "invalid value for hints"]],  [-3003, ["EAI_CANCELED", "request canceled"]],  [-3004, ["EAI_FAIL", "permanent failure"]],  [-3005, ["EAI_FAMILY", "ai_family not supported"]],  [-3006, ["EAI_MEMORY", "out of memory"]],  [-3007, ["EAI_NODATA", "no address"]],  [-3008, ["EAI_NONAME", "unknown node or service"]],  [-3009, ["EAI_OVERFLOW", "argument buffer overflow"]],  [-3014, ["EAI_PROTOCOL", "resolved protocol is unknown"]],  [-3010, ["EAI_SERVICE", "service not available for socket type"]],  [-3011, ["EAI_SOCKTYPE", "socket type not supported"]],  [-4084, ["EALREADY", "connection already in progress"]],  [-4083, ["EBADF", "bad file descriptor"]],  [-4082, ["EBUSY", "resource busy or locked"]],  [-4081, ["ECANCELED", "operation canceled"]],  [-4080, ["ECHARSET", "invalid Unicode character"]],  [-4079, ["ECONNABORTED", "software caused connection abort"]],  [-4078, ["ECONNREFUSED", "connection refused"]],  [-4077, ["ECONNRESET", "connection reset by peer"]],  [-4076, ["EDESTADDRREQ", "destination address required"]],  [-4075, ["EEXIST", "file already exists"]],  [-4074, ["EFAULT", "bad address in system call argument"]],  [-4036, ["EFBIG", "file too large"]],  [-4073, ["EHOSTUNREACH", "host is unreachable"]],  [-4072, ["EINTR", "interrupted system call"]],  [-4071, ["EINVAL", "invalid argument"]],  [-4070, ["EIO", "i/o error"]],  [-4069, ["EISCONN", "socket is already connected"]],  [-4068, ["EISDIR", "illegal operation on a directory"]],  [-4067, ["ELOOP", "too many symbolic links encountered"]],  [-4066, ["EMFILE", "too many open files"]],  [-4065, ["EMSGSIZE", "message too long"]],  [-4064, ["ENAMETOOLONG", "name too long"]],  [-4063, ["ENETDOWN", "network is down"]],  [-4062, ["ENETUNREACH", "network is unreachable"]],  [-4061, ["ENFILE", "file table overflow"]],  [-4060, ["ENOBUFS", "no buffer space available"]],  [-4059, ["ENODEV", "no such device"]],  [-4058, ["ENOENT", "no such file or directory"]],  [-4057, ["ENOMEM", "not enough memory"]],  [-4056, ["ENONET", "machine is not on the network"]],  [-4035, ["ENOPROTOOPT", "protocol not available"]],  [-4055, ["ENOSPC", "no space left on device"]],  [-4054, ["ENOSYS", "function not implemented"]],  [-4053, ["ENOTCONN", "socket is not connected"]],  [-4052, ["ENOTDIR", "not a directory"]],  [-4051, ["ENOTEMPTY", "directory not empty"]],  [-4050, ["ENOTSOCK", "socket operation on non-socket"]],  [-4049, ["ENOTSUP", "operation not supported on socket"]],  [-4048, ["EPERM", "operation not permitted"]],  [-4047, ["EPIPE", "broken pipe"]],  [-4046, ["EPROTO", "protocol error"]],  [-4045, ["EPROTONOSUPPORT", "protocol not supported"]],  [-4044, ["EPROTOTYPE", "protocol wrong type for socket"]],  [-4034, ["ERANGE", "result too large"]],  [-4043, ["EROFS", "read-only file system"]],  [-4042, ["ESHUTDOWN", "cannot send after transport endpoint shutdown"]],  [-4041, ["ESPIPE", "invalid seek"]],  [-4040, ["ESRCH", "no such process"]],  [-4039, ["ETIMEDOUT", "connection timed out"]],  [-4038, ["ETXTBSY", "text file is busy"]],  [-4037, ["EXDEV", "cross-device link not permitted"]],  [-4094, ["UNKNOWN", "unknown error"]],  [-4095, ["EOF", "end of file"]],  [-4033, ["ENXIO", "no such device or address"]],  [-4032, ["EMLINK", "too many links"]],  [-4031, ["EHOSTDOWN", "host is down"]],  [-4030, ["EREMOTEIO", "remote I/O error"]],  [-4029, ["ENOTTY", "inappropriate ioctl for device"]],  [-4028, ["EFTYPE", "inappropriate file type or format"]],  [-4027, ["EILSEQ", "illegal byte sequence"]],];
const darwin: ErrMapData = [  [-7, ["E2BIG", "argument list too long"]],  [-13, ["EACCES", "permission denied"]],  [-48, ["EADDRINUSE", "address already in use"]],  [-49, ["EADDRNOTAVAIL", "address not available"]],  [-47, ["EAFNOSUPPORT", "address family not supported"]],  [-35, ["EAGAIN", "resource temporarily unavailable"]],  [-3000, ["EAI_ADDRFAMILY", "address family not supported"]],  [-3001, ["EAI_AGAIN", "temporary failure"]],  [-3002, ["EAI_BADFLAGS", "bad ai_flags value"]],  [-3013, ["EAI_BADHINTS", "invalid value for hints"]],  [-3003, ["EAI_CANCELED", "request canceled"]],  [-3004, ["EAI_FAIL", "permanent failure"]],  [-3005, ["EAI_FAMILY", "ai_family not supported"]],  [-3006, ["EAI_MEMORY", "out of memory"]],  [-3007, ["EAI_NODATA", "no address"]],  [-3008, ["EAI_NONAME", "unknown node or service"]],  [-3009, ["EAI_OVERFLOW", "argument buffer overflow"]],  [-3014, ["EAI_PROTOCOL", "resolved protocol is unknown"]],  [-3010, ["EAI_SERVICE", "service not available for socket type"]],  [-3011, ["EAI_SOCKTYPE", "socket type not supported"]],  [-37, ["EALREADY", "connection already in progress"]],  [-9, ["EBADF", "bad file descriptor"]],  [-16, ["EBUSY", "resource busy or locked"]],  [-89, ["ECANCELED", "operation canceled"]],  [-4080, ["ECHARSET", "invalid Unicode character"]],  [-53, ["ECONNABORTED", "software caused connection abort"]],  [-61, ["ECONNREFUSED", "connection refused"]],  [-54, ["ECONNRESET", "connection reset by peer"]],  [-39, ["EDESTADDRREQ", "destination address required"]],  [-17, ["EEXIST", "file already exists"]],  [-14, ["EFAULT", "bad address in system call argument"]],  [-27, ["EFBIG", "file too large"]],  [-65, ["EHOSTUNREACH", "host is unreachable"]],  [-4, ["EINTR", "interrupted system call"]],  [-22, ["EINVAL", "invalid argument"]],  [-5, ["EIO", "i/o error"]],  [-56, ["EISCONN", "socket is already connected"]],  [-21, ["EISDIR", "illegal operation on a directory"]],  [-62, ["ELOOP", "too many symbolic links encountered"]],  [-24, ["EMFILE", "too many open files"]],  [-40, ["EMSGSIZE", "message too long"]],  [-63, ["ENAMETOOLONG", "name too long"]],  [-50, ["ENETDOWN", "network is down"]],  [-51, ["ENETUNREACH", "network is unreachable"]],  [-23, ["ENFILE", "file table overflow"]],  [-55, ["ENOBUFS", "no buffer space available"]],  [-19, ["ENODEV", "no such device"]],  [-2, ["ENOENT", "no such file or directory"]],  [-12, ["ENOMEM", "not enough memory"]],  [-4056, ["ENONET", "machine is not on the network"]],  [-42, ["ENOPROTOOPT", "protocol not available"]],  [-28, ["ENOSPC", "no space left on device"]],  [-78, ["ENOSYS", "function not implemented"]],  [-57, ["ENOTCONN", "socket is not connected"]],  [-20, ["ENOTDIR", "not a directory"]],  [-66, ["ENOTEMPTY", "directory not empty"]],  [-38, ["ENOTSOCK", "socket operation on non-socket"]],  [-45, ["ENOTSUP", "operation not supported on socket"]],  [-1, ["EPERM", "operation not permitted"]],  [-32, ["EPIPE", "broken pipe"]],  [-100, ["EPROTO", "protocol error"]],  [-43, ["EPROTONOSUPPORT", "protocol not supported"]],  [-41, ["EPROTOTYPE", "protocol wrong type for socket"]],  [-34, ["ERANGE", "result too large"]],  [-30, ["EROFS", "read-only file system"]],  [-58, ["ESHUTDOWN", "cannot send after transport endpoint shutdown"]],  [-29, ["ESPIPE", "invalid seek"]],  [-3, ["ESRCH", "no such process"]],  [-60, ["ETIMEDOUT", "connection timed out"]],  [-26, ["ETXTBSY", "text file is busy"]],  [-18, ["EXDEV", "cross-device link not permitted"]],  [-4094, ["UNKNOWN", "unknown error"]],  [-4095, ["EOF", "end of file"]],  [-6, ["ENXIO", "no such device or address"]],  [-31, ["EMLINK", "too many links"]],  [-64, ["EHOSTDOWN", "host is down"]],  [-4030, ["EREMOTEIO", "remote I/O error"]],  [-25, ["ENOTTY", "inappropriate ioctl for device"]],  [-79, ["EFTYPE", "inappropriate file type or format"]],  [-92, ["EILSEQ", "illegal byte sequence"]],];
const linux: ErrMapData = [  [-7, ["E2BIG", "argument list too long"]],  [-13, ["EACCES", "permission denied"]],  [-98, ["EADDRINUSE", "address already in use"]],  [-99, ["EADDRNOTAVAIL", "address not available"]],  [-97, ["EAFNOSUPPORT", "address family not supported"]],  [-11, ["EAGAIN", "resource temporarily unavailable"]],  [-3000, ["EAI_ADDRFAMILY", "address family not supported"]],  [-3001, ["EAI_AGAIN", "temporary failure"]],  [-3002, ["EAI_BADFLAGS", "bad ai_flags value"]],  [-3013, ["EAI_BADHINTS", "invalid value for hints"]],  [-3003, ["EAI_CANCELED", "request canceled"]],  [-3004, ["EAI_FAIL", "permanent failure"]],  [-3005, ["EAI_FAMILY", "ai_family not supported"]],  [-3006, ["EAI_MEMORY", "out of memory"]],  [-3007, ["EAI_NODATA", "no address"]],  [-3008, ["EAI_NONAME", "unknown node or service"]],  [-3009, ["EAI_OVERFLOW", "argument buffer overflow"]],  [-3014, ["EAI_PROTOCOL", "resolved protocol is unknown"]],  [-3010, ["EAI_SERVICE", "service not available for socket type"]],  [-3011, ["EAI_SOCKTYPE", "socket type not supported"]],  [-114, ["EALREADY", "connection already in progress"]],  [-9, ["EBADF", "bad file descriptor"]],  [-16, ["EBUSY", "resource busy or locked"]],  [-125, ["ECANCELED", "operation canceled"]],  [-4080, ["ECHARSET", "invalid Unicode character"]],  [-103, ["ECONNABORTED", "software caused connection abort"]],  [-111, ["ECONNREFUSED", "connection refused"]],  [-104, ["ECONNRESET", "connection reset by peer"]],  [-89, ["EDESTADDRREQ", "destination address required"]],  [-17, ["EEXIST", "file already exists"]],  [-14, ["EFAULT", "bad address in system call argument"]],  [-27, ["EFBIG", "file too large"]],  [-113, ["EHOSTUNREACH", "host is unreachable"]],  [-4, ["EINTR", "interrupted system call"]],  [-22, ["EINVAL", "invalid argument"]],  [-5, ["EIO", "i/o error"]],  [-106, ["EISCONN", "socket is already connected"]],  [-21, ["EISDIR", "illegal operation on a directory"]],  [-40, ["ELOOP", "too many symbolic links encountered"]],  [-24, ["EMFILE", "too many open files"]],  [-90, ["EMSGSIZE", "message too long"]],  [-36, ["ENAMETOOLONG", "name too long"]],  [-100, ["ENETDOWN", "network is down"]],  [-101, ["ENETUNREACH", "network is unreachable"]],  [-23, ["ENFILE", "file table overflow"]],  [-105, ["ENOBUFS", "no buffer space available"]],  [-19, ["ENODEV", "no such device"]],  [-2, ["ENOENT", "no such file or directory"]],  [-12, ["ENOMEM", "not enough memory"]],  [-64, ["ENONET", "machine is not on the network"]],  [-92, ["ENOPROTOOPT", "protocol not available"]],  [-28, ["ENOSPC", "no space left on device"]],  [-38, ["ENOSYS", "function not implemented"]],  [-107, ["ENOTCONN", "socket is not connected"]],  [-20, ["ENOTDIR", "not a directory"]],  [-39, ["ENOTEMPTY", "directory not empty"]],  [-88, ["ENOTSOCK", "socket operation on non-socket"]],  [-95, ["ENOTSUP", "operation not supported on socket"]],  [-1, ["EPERM", "operation not permitted"]],  [-32, ["EPIPE", "broken pipe"]],  [-71, ["EPROTO", "protocol error"]],  [-93, ["EPROTONOSUPPORT", "protocol not supported"]],  [-91, ["EPROTOTYPE", "protocol wrong type for socket"]],  [-34, ["ERANGE", "result too large"]],  [-30, ["EROFS", "read-only file system"]],  [-108, ["ESHUTDOWN", "cannot send after transport endpoint shutdown"]],  [-29, ["ESPIPE", "invalid seek"]],  [-3, ["ESRCH", "no such process"]],  [-110, ["ETIMEDOUT", "connection timed out"]],  [-26, ["ETXTBSY", "text file is busy"]],  [-18, ["EXDEV", "cross-device link not permitted"]],  [-4094, ["UNKNOWN", "unknown error"]],  [-4095, ["EOF", "end of file"]],  [-6, ["ENXIO", "no such device or address"]],  [-31, ["EMLINK", "too many links"]],  [-112, ["EHOSTDOWN", "host is down"]],  [-121, ["EREMOTEIO", "remote I/O error"]],  [-25, ["ENOTTY", "inappropriate ioctl for device"]],  [-4028, ["EFTYPE", "inappropriate file type or format"]],  [-84, ["EILSEQ", "illegal byte sequence"]],];
const { os } = Deno.build;export const errorMap = new Map<number, [string, string]>(  os === "windows"    ? windows    : os === "darwin"    ? darwin    : os === "linux"    ? linux    : unreachable(),);export class ERR_METHOD_NOT_IMPLEMENTED extends NodeError {  constructor(x: string) {    super(      "ERR_METHOD_NOT_IMPLEMENTED",      `The ${x} method is not implemented`,    );  }}export class ERR_MULTIPLE_CALLBACK extends NodeError {  constructor() {    super(      "ERR_MULTIPLE_CALLBACK",      `Callback called multiple times`,    );  }}export class ERR_STREAM_ALREADY_FINISHED extends NodeError {  constructor(x: string) {    super(      "ERR_STREAM_ALREADY_FINISHED",      `Cannot call ${x} after a stream was finished`,    );  }}export class ERR_STREAM_CANNOT_PIPE extends NodeError {  constructor() {    super(      "ERR_STREAM_CANNOT_PIPE",      `Cannot pipe, not readable`,    );  }}export class ERR_STREAM_DESTROYED extends NodeError {  constructor(x: string) {    super(      "ERR_STREAM_DESTROYED",      `Cannot call ${x} after a stream was destroyed`,    );  }}export class ERR_STREAM_NULL_VALUES extends NodeTypeError {  constructor() {    super(      "ERR_STREAM_NULL_VALUES",      `May not write null values to stream`,    );  }}export class ERR_STREAM_PREMATURE_CLOSE extends NodeError {  constructor() {    super(      "ERR_STREAM_PREMATURE_CLOSE",      `Premature close`,    );  }}export class ERR_STREAM_PUSH_AFTER_EOF extends NodeError {  constructor() {    super(      "ERR_STREAM_PUSH_AFTER_EOF",      `stream.push() after EOF`,    );  }}export class ERR_STREAM_UNSHIFT_AFTER_END_EVENT extends NodeError {  constructor() {    super(      "ERR_STREAM_UNSHIFT_AFTER_END_EVENT",      `stream.unshift() after end event`,    );  }}export class ERR_STREAM_WRITE_AFTER_END extends NodeError {  constructor() {    super(      "ERR_STREAM_WRITE_AFTER_END",      `write after end`,    );  }}export class ERR_UNKNOWN_ENCODING extends NodeTypeError {  constructor(x: string) {    super(      "ERR_UNKNOWN_ENCODING",      `Unknown encoding: ${x}`,    );  }}
export class ERR_INVALID_OPT_VALUE extends NodeTypeError {  constructor(name: string, value: unknown) {    super(      "ERR_INVALID_OPT_VALUE",      `The value "${value}" is invalid for option "${name}"`,    );  }}