Skip to main content
Deno - Deno documentation
namespace Deno

The global namespace where Deno specific, non-standard APIs are located.

Classes

c
Deno.AtomicOperation

An operation on a Deno.Kv that can be performed atomically. Atomic operations do not auto-commit, and must be committed explicitly by calling the commit method.

c
Deno.ChildProcess

The interface for handling a child process returned from Deno.Command.spawn.

c
Deno.Command

Create a child process.

c
Deno.HttpClient

A custom HttpClient for use with fetch function. This is designed to allow custom certificates or proxies to be used with fetch().

c
Deno.Kv

A key-value database that can be used to store and retrieve data.

c
Deno.KvListIterator

An iterator over a range of data entries in a Deno.Kv.

c
Deno.KvU64

Wrapper type for 64-bit unsigned integers for use as values in a Deno.Kv.

c
Deno.PermissionStatus

An EventTarget returned from the Deno.permissions API which can provide updates to any state changes of the permission.

c
Deno.UnsafeCallback

An unsafe function pointer for passing JavaScript functions as C function pointers to foreign function calls.

c
Deno.UnsafeFnPointer

An unsafe pointer to a function, for calling functions that are not present as symbols.

c
Deno.UnsafePointer

A collection of static functions for interacting with pointer objects.

c
Deno.UnsafePointerView

An unsafe pointer view to a memory location as specified by the pointer value. The UnsafePointerView API follows the standard built in interface DataView for accessing the underlying types at an memory location (numbers, strings and raw bytes).

c
Deno.UnsafeWindowSurface

Creates a presentable WebGPU surface from given window and display handles.

Enums

E
Deno.SeekMode

A enum which defines the seek mode for IO related APIs that support seeking.

Functions

f
Deno.addSignalListener

Registers the given function as a listener of the given signal event.

f
Deno.bench

Register a benchmark test which will be run when deno bench is used on the command line and the containing module looks like a bench module.

f
Deno.chdir

Change the current working directory to the specified path.

f
Deno.chmod

Changes the permission of a specific file/directory of specified path. Ignores the process's umask.

f
Deno.chmodSync

Synchronously changes the permission of a specific file/directory of specified path. Ignores the process's umask.

f
Deno.chown

Change owner of a regular file or directory.

f
Deno.chownSync

Synchronously change owner of a regular file or directory.

f
Deno.connect

Connects to the hostname (default is "127.0.0.1") and port on the named transport (default is "tcp"), and resolves to the connection (Conn).

f
Deno.connectTls

Establishes a secure connection over TLS (transport layer security) using an optional list of CA certs, hostname (default is "127.0.0.1") and port.

f
Deno.consoleSize

Gets the size of the console as columns/rows.

f
Deno.copyFile

Copies the contents and permissions of one file to another specified path, by default creating a new file if needed, else overwriting. Fails if target path is a directory or is unwritable.

f
Deno.copyFileSync

Synchronously copies the contents and permissions of one file to another specified path, by default creating a new file if needed, else overwriting. Fails if target path is a directory or is unwritable.

f
Deno.create

Creates a file if none exists or truncates an existing file and resolves to an instance of Deno.FsFile.

f
Deno.createHttpClient

Create a custom HttpClient to use with fetch. This is an extension of the web platform Fetch API which allows Deno to use custom TLS CA certificates and connect via a proxy while using fetch().

f
Deno.createSync

Creates a file if none exists or truncates an existing file and returns an instance of Deno.FsFile.

f
Deno.cron

Create a cron job that will periodically execute the provided handler callback based on the specified schedule.

f
Deno.cwd

Return a string representing the current working directory.

f
Deno.dlopen

Opens an external dynamic library and registers symbols, making foreign functions available to be called.

f
Deno.execPath

Returns the path to the current deno executable.

f
Deno.exit

Exit the Deno process with optional exit code.

f
Deno.gid

Returns the group id of the process on POSIX platforms. Returns null on windows.

f
Deno.hostname

Get the hostname of the machine the Deno process is running on.

f
Deno.inspect

Converts the input into a string that has the same format as printed by console.log().

f
Deno.kill

Send a signal to process under given pid. The value and meaning of the signal to the process is operating system and process dependant. Signal provides the most common signals. Default signal is "SIGTERM".

f
Deno.linkSync

Synchronously creates newpath as a hard link to oldpath.

f
Deno.listen

Listen announces on the local transport address.

f
Deno.listenDatagram

Listen announces on the local transport address.

f
Deno.listenTls

Listen announces on the local transport address over TLS (transport layer security).

f
Deno.loadavg

Returns an array containing the 1, 5, and 15 minute load averages. The load average is a measure of CPU and IO utilization of the last one, five, and 15 minute periods expressed as a fractional number. Zero means there is no load. On Windows, the three values are always the same and represent the current load, not the 1, 5 and 15 minute load averages.

f
Deno.lstat

Resolves to a Deno.FileInfo for the specified path. If path is a symlink, information for the symlink will be returned instead of what it points to.

f
Deno.lstatSync

Synchronously returns a Deno.FileInfo for the specified path. If path is a symlink, information for the symlink will be returned instead of what it points to.

f
Deno.makeTempDir

Creates a new temporary directory in the default directory for temporary files, unless dir is specified. Other optional options include prefixing and suffixing the directory name with prefix and suffix respectively.

f
Deno.makeTempDirSync

Synchronously creates a new temporary directory in the default directory for temporary files, unless dir is specified. Other optional options include prefixing and suffixing the directory name with prefix and suffix respectively.

f
Deno.makeTempFile

Creates a new temporary file in the default directory for temporary files, unless dir is specified.

f
Deno.makeTempFileSync

Synchronously creates a new temporary file in the default directory for temporary files, unless dir is specified.

f
Deno.memoryUsage

Returns an object describing the memory usage of the Deno process and the V8 subsystem measured in bytes.

f
Deno.mkdir

Creates a new directory with the specified path.

f
Deno.mkdirSync

Synchronously creates a new directory with the specified path.

f
Deno.networkInterfaces

Returns an array of the network interface information.

f
Deno.open

Open a file and resolve to an instance of Deno.FsFile. The file does not need to previously exist if using the create or createNew open options. The caller may have the resulting file automatically closed by the runtime once it's out of scope by declaring the file variable with the using keyword.

f
Deno.openKv

Open a new Deno.Kv connection to persist data.

f
Deno.openSync

Synchronously open a file and return an instance of Deno.FsFile. The file does not need to previously exist if using the create or createNew open options. The caller may have the resulting file automatically closed by the runtime once it's out of scope by declaring the file variable with the using keyword.

f
Deno.osRelease

Returns the release version of the Operating System.

f
Deno.osUptime

Returns the Operating System uptime in number of seconds.

f
Deno.readDir

Reads the directory given by path and returns an async iterable of Deno.DirEntry. The order of entries is not guaranteed.

f
Deno.readDirSync

Synchronously reads the directory given by path and returns an iterable of Deno.DirEntry. The order of entries is not guaranteed.

f
Deno.readFile

Reads and resolves to the entire contents of a file as an array of bytes. TextDecoder can be used to transform the bytes to string if required. Reading a directory returns an empty data array.

f
Deno.readFileSync

Synchronously reads and returns the entire contents of a file as an array of bytes. TextDecoder can be used to transform the bytes to string if required. Reading a directory returns an empty data array.

f
Deno.readLinkSync

Synchronously returns the full path destination of the named symbolic link.

f
Deno.readTextFile

Asynchronously reads and returns the entire contents of a file as an UTF-8 decoded string. Reading a directory throws an error.

f
Deno.readTextFileSync

Synchronously reads and returns the entire contents of a file as an UTF-8 decoded string. Reading a directory throws an error.

f
Deno.realPath

Resolves to the absolute normalized path, with symbolic links resolved.

f
Deno.realPathSync

Synchronously returns absolute normalized path, with symbolic links resolved.

f
Deno.refTimer

Make the timer of the given id block the event loop from finishing.

f
Deno.remove

Removes the named file or directory.

f
Deno.removeSignalListener

Removes the given signal listener that has been registered with Deno.addSignalListener.

f
Deno.removeSync

Synchronously removes the named file or directory.

f
Deno.rename

Renames (moves) oldpath to newpath. Paths may be files or directories. If newpath already exists and is not a directory, rename() replaces it. OS-specific restrictions may apply when oldpath and newpath are in different directories.

f
Deno.renameSync

Synchronously renames (moves) oldpath to newpath. Paths may be files or directories. If newpath already exists and is not a directory, renameSync() replaces it. OS-specific restrictions may apply when oldpath and newpath are in different directories.

f
Deno.resolveDns

Performs DNS resolution against the given query, returning resolved records.

f
Deno.serve

Serves HTTP requests with the given handler.

f
Deno.startTls

Start TLS handshake from an existing connection using an optional list of CA certificates, and hostname (default is "127.0.0.1"). Specifying CA certs is optional. By default the configured root certificates are used. Using this function requires that the other end of the connection is prepared for a TLS handshake.

f
Deno.stat

Resolves to a Deno.FileInfo for the specified path. Will always follow symlinks.

f
Deno.statSync

Synchronously returns a Deno.FileInfo for the specified path. Will always follow symlinks.

f
Deno.symlinkSync

Creates newpath as a symbolic link to oldpath.

f
Deno.systemMemoryInfo

Displays the total amount of free and used physical and swap memory in the system, as well as the buffers and caches used by the kernel.

f
Deno.truncate

Truncates (or extends) the specified file, to reach the specified len. If len is not specified then the entire file contents are truncated.

f
Deno.truncateSync

Synchronously truncates (or extends) the specified file, to reach the specified len. If len is not specified then the entire file contents are truncated.

f
Deno.uid

Returns the user id of the process on POSIX platforms. Returns null on Windows.

f
Deno.umask

Retrieve the process umask. If mask is provided, sets the process umask. This call always returns what the umask was before the call.

f
Deno.unrefTimer

Make the timer of the given id not block the event loop from finishing.

f
Deno.upgradeWebSocket

Upgrade an incoming HTTP request to a WebSocket.

f
Deno.utime

Changes the access (atime) and modification (mtime) times of a file system object referenced by path. Given times are either in seconds (UNIX epoch time) or as Date objects.

f
Deno.utimeSync

Synchronously changes the access (atime) and modification (mtime) times of a file system object referenced by path. Given times are either in seconds (UNIX epoch time) or as Date objects.

f
Deno.watchFs

Watch for file system events against one or more paths, which can be files or directories. These paths must exist already. One user action (e.g. touch test.file) can generate multiple file system events. Likewise, one user action can result in multiple file paths in one event (e.g. mv old_name.txt new_name.txt).

f
Deno.writeFile

Write data to the given path, by default creating a new file if needed, else overwriting.

f
Deno.writeFileSync

Synchronously write data to the given path, by default creating a new file if needed, else overwriting.

f
Deno.writeTextFile

Write string data to the given path, by default creating a new file if needed, else overwriting.

f
Deno.writeTextFileSync

Synchronously write string data to the given path, by default creating a new file if needed, else overwriting.

Interfaces

I
Deno.AtomicCheck

A check to perform as part of a Deno.AtomicOperation. The check will fail if the versionstamp for the key-value pair in the KV store does not match the given versionstamp. A check with a null versionstamp checks that the key-value pair does not currently exist in the KV store.

I
Deno.BasicAuth

Basic authentication credentials to be used with a Deno.Proxy server when specifying Deno.CreateHttpClientOptions.

I
Deno.BenchContext

Context that is passed to a benchmarked function. The instance is shared between iterations of the benchmark. Its methods can be used for example to override of the measured portion of the function.

I
I
Deno.CaaRecord

If Deno.resolveDns is called with "CAA" record type specified, it will resolve with an array of objects with this interface.

I
Deno.CommandOutput

The interface returned from calling Deno.Command.output or Deno.Command.outputSync which represents the result of spawning the child process.

I
Deno.CommandStatus
No documentation available
I
Deno.ConnectOptions
No documentation available
I
Deno.CronSchedule

CronSchedule is the interface used for JSON format cron schedule.

I
Deno.DatagramConn

A generic transport listener for message-oriented protocols.

I
Deno.DenoTest
No documentation available
I
Deno.DirEntry

Information about a directory entry returned from Deno.readDir and Deno.readDirSync.

I
Deno.DynamicLibrary

A dynamic library resource. Use Deno.dlopen to load a dynamic library and return this interface.

I
Deno.Env

An interface containing methods to interact with the process environment variables.

I
Deno.EnvPermissionDescriptor

The permission descriptor for the allow-env and deny-env permissions, which controls access to being able to read and write to the process environment variables as well as access other information about the environment. The option variable allows scoping the permission to a specific environment variable.

I
Deno.FfiPermissionDescriptor

The permission descriptor for the allow-ffi and deny-ffi permissions, which controls access to loading foreign code and interfacing with it via the Foreign Function Interface API available in Deno. The option path allows scoping the permission to a specific path on the host.

I
Deno.ForeignFunction

The interface for a foreign function as defined by its parameter and result types.

I
Deno.ForeignLibraryInterface

A foreign library interface descriptor.

I
Deno.ForeignStatic
No documentation available
I
Deno.FsEvent

Represents a unique file system event yielded by a Deno.FsWatcher.

I
Deno.FsWatcher

Returned by Deno.watchFs. It is an async iterator yielding up system events. To stop watching the file system by calling .close() method.

I
Deno.HttpServer

An instance of the server created using Deno.serve() API.

I
Deno.KvCommitError
No documentation available
I
Deno.KvCommitResult
No documentation available
I
Deno.KvEntry

A versioned pair of key and value in a Deno.Kv.

I
Deno.KvListOptions

Options for listing key-value pairs in a Deno.Kv.

I
Deno.Listener

A generic network listener for stream-oriented protocols.

I
Deno.ListenOptions
No documentation available
I
I
I
Deno.MkdirOptions

Options which can be set when using Deno.mkdir and Deno.mkdirSync.

I
Deno.MulticastV4Membership

Represents membership of a IPv4 multicast group.

I
Deno.MulticastV6Membership

Represents membership of a IPv6 multicast group.

I
Deno.MxRecord

If Deno.resolveDns is called with "MX" record type specified, it will return an array of objects with this interface.

I
Deno.NaptrRecord

If Deno.resolveDns is called with "NAPTR" record type specified, it will return an array of objects with this interface.

I
Deno.NativeStructType

The native struct type for interfacing with foreign functions.

I
Deno.NetAddr
No documentation available
I
Deno.NetPermissionDescriptor

The permission descriptor for the allow-net and deny-net permissions, which controls access to opening network ports and connecting to remote hosts via the network. The option host allows scoping the permission for outbound connection to a specific host and port.

I
Deno.NetworkInterfaceInfo

The information for a network interface returned from a call to Deno.networkInterfaces.

I
Deno.PermissionOptionsObject

A set of options which can define the permissions within a test or worker context at a highly specific level.

I
Deno.PermissionStatusEventMap

The interface which defines what event types are supported by PermissionStatus instances.

I
Deno.PointerObject

A non-null pointer, represented as an object at runtime. The object's prototype is null and cannot be changed. The object cannot be assigned to either and is thus entirely read-only.

I
Deno.Proxy

The definition of a proxy when specifying Deno.CreateHttpClientOptions.

I
Deno.ReadFileOptions

Options which can be set when using Deno.readFile or Deno.readFileSync.

I
Deno.ReadPermissionDescriptor

The permission descriptor for the allow-read and deny-read permissions, which controls access to reading resources from the local host. The option path allows scoping the permission to a specific path (and if the path is a directory any sub paths).

I
Deno.RemoveOptions

Options which can be set when using Deno.remove and Deno.removeSync.

I
Deno.ResolveDnsOptions

Options which can be set when using Deno.resolveDns.

I
Deno.RunPermissionDescriptor

The permission descriptor for the allow-run and deny-run permissions, which controls access to what sub-processes can be executed by Deno. The option command allows scoping the permission to a specific executable.

I
Deno.ServeDefaultExport

Interface that module run with deno serve subcommand must conform to.

I
Deno.ServeHandlerInfo

Additional information for an HTTP request and its connection.

I
Deno.ServeInit
No documentation available
I
Deno.ServeOptions

Options which can be set when calling Deno.serve.

I
Deno.ServeTcpOptions

Options that can be passed to Deno.serve to create a server listening on a TCP port.

I
Deno.ServeUnixOptions

Options that can be passed to Deno.serve to create a server listening on a Unix domain socket.

I
Deno.SetRawOptions
No documentation available
I
Deno.SoaRecord

If Deno.resolveDns is called with "SOA" record type specified, it will return an array of objects with this interface.

I
Deno.SrvRecord

If Deno.resolveDns is called with "SRV" record type specified, it will return an array of objects with this interface.

I
Deno.SymlinkOptions

Options that can be used with symlink and symlinkSync.

I
Deno.SysPermissionDescriptor

The permission descriptor for the allow-sys and deny-sys permissions, which controls access to sensitive host system information, which malicious code might attempt to exploit. The option kind allows scoping the permission to a specific piece of information.

I
Deno.TcpConn
No documentation available
I
Deno.TcpListenOptions
No documentation available
I
Deno.TestContext

Context that is passed to a testing function, which can be used to either gain information about the current test, or register additional test steps within the current test.

I
Deno.TlsCertifiedKeyPem

Provides certified key material from strings. The key material is provided in PEM-format (Privacy Enhanced Mail, https://www.rfc-editor.org/rfc/rfc1422) which can be identified by having -----BEGIN----- and -----END----- markers at the beginning and end of the strings. This type of key is not compatible with DER-format keys which are binary.

I
Deno.TlsConn
No documentation available
I
Deno.TlsHandshakeInfo
No documentation available
I
Deno.UdpListenOptions

Unstable options which can be set when opening a datagram listener via Deno.listenDatagram.

I
Deno.UnixAddr
No documentation available
I
Deno.UnixConn
No documentation available
I
Deno.UnixConnectOptions
No documentation available
I
Deno.UnixListenOptions

Options which can be set when opening a Unix listener via Deno.listen or Deno.listenDatagram.

I
Deno.UnsafeCallbackDefinition

Definition of a unsafe callback function.

I
Deno.UpgradeWebSocketOptions

Options which can be set when performing a Deno.upgradeWebSocket upgrade of a Request

I
Deno.WebSocketUpgrade

The object that is returned from a Deno.upgradeWebSocket request.

I
Deno.WritePermissionDescriptor

The permission descriptor for the allow-write and deny-write permissions, which controls access to writing to resources from the local host. The option path allow scoping the permission to a specific path (and if the path is a directory any sub paths).

Namespaces

N
Deno.errors

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

N
Deno.jupyter

A namespace containing runtime APIs available in Jupyter notebooks.

N
Deno.telemetry

APIs for working with the OpenTelemetry observability framework. Deno can export traces, metrics, and logs to OpenTelemetry compatible backends via the OTLP protocol.

Type Aliases

T
Deno.Addr
No documentation available
T
Deno.ConditionalAsync
No documentation available
T
Deno.CronScheduleExpression

CronScheduleExpression is used as the type of minute, hour, dayOfMonth, month, and dayOfWeek in CronSchedule.

T
Deno.FromForeignFunction
No documentation available
T
Deno.FromNativeParameterTypes
No documentation available
T
Deno.FromNativeResultType

Type conversion for foreign symbol return types.

T
Deno.FromNativeType

Type conversion for foreign symbol return types and unsafe callback parameters.

T
Deno.FsEventFlag

Additional information for FsEvent objects with the "other" kind.

T
Deno.KvConsistencyLevel

Consistency level of a KV operation.

T
Deno.KvEntryMaybe

An optional versioned pair of key and value in a Deno.Kv.

T
Deno.KvKey

A key to be persisted in a Deno.Kv. A key is a sequence of Deno.KvKeyParts.

T
Deno.KvKeyPart

A single part of a Deno.KvKey. Parts are ordered lexicographically, first by their type, and within a given type by their value.

T
Deno.KvListSelector

A selector that selects the range of data returned by a list operation on a Deno.Kv.

T
Deno.KvMutation

A mutation to a key in a Deno.Kv. A mutation is a combination of a key, a value, and a type. The type determines how the mutation is applied to the key.

T
Deno.NativeBigIntType

All BigInt number types for interfacing with foreign functions.

T
Deno.NativeBooleanType

The native boolean type for interfacing to foreign functions.

T
Deno.NativeBufferType

The native buffer type for interfacing to foreign functions.

T
Deno.NativeFunctionType

The native function type for interfacing with foreign functions.

T
Deno.NativeI16Enum
No documentation available
T
Deno.NativeI32Enum
No documentation available
T
Deno.NativeI8Enum
No documentation available
T
Deno.NativeNumberType

All plain number types for interfacing with foreign functions.

T
Deno.NativePointerType

The native pointer type for interfacing to foreign functions.

T
Deno.NativeResultType
No documentation available
T
Deno.NativeType

All supported types for interfacing with foreign functions.

T
Deno.NativeTypedFunction
No documentation available
T
Deno.NativeTypedPointer
No documentation available
T
Deno.NativeU16Enum
No documentation available
T
Deno.NativeU32Enum
No documentation available
T
Deno.NativeU8Enum
No documentation available
T
Deno.NativeVoidType

The native void type for interfacing with foreign functions.

T
Deno.PermissionDescriptor

Permission descriptors which define a permission and can be queried, requested, or revoked.

T
Deno.PermissionName

The name of a privileged feature which needs permission.

T
Deno.PermissionOptions

Options which define the permissions within a test or worker context.

T
Deno.PermissionState

The current status of the permission:

T
Deno.PointerValue

Pointers are represented either with a PointerObject object or a null if the pointer is null.

T
Deno.RecordType

The type of the resource record to resolve via DNS using Deno.resolveDns.

T
Deno.ServeHandler

A handler for HTTP requests. Consumes a request and returns a response.

T
Deno.Signal

Operating signals which can be listened for or sent to sub-processes. What signals and what their standard behaviors are OS dependent.

T
Deno.StaticForeignLibraryInterface

A utility type that infers a foreign library interface.

T
Deno.StaticForeignSymbol

A utility type that infers a foreign symbol.

T
Deno.StaticForeignSymbolReturnType
No documentation available
T
Deno.TcpListener

Specialized listener that accepts TCP connections.

T
Deno.TlsListener

Specialized listener that accepts TLS connections.

T
Deno.ToNativeParameterTypes

A utility type for conversion of parameter types of foreign functions.

T
Deno.ToNativeResultType

Type conversion for unsafe callback return types.

T
Deno.ToNativeType

Type conversion for foreign symbol parameters and unsafe callback return types.

T
Deno.UnixListener

Specialized listener that accepts Unix connections.

T
Deno.UnsafeCallbackFunction

An unsafe callback function.

Variables

v
Deno.args

Returns the script arguments to the program.

v
Deno.brand
No documentation available
v
Deno.build

Information related to the build of the current Deno runtime.

v
Deno.env

An interface containing methods to interact with the process environment variables.

v
Deno.exitCode

The exit code for the Deno process.

v
Deno.mainModule

The URL of the entrypoint module entered from the command-line. It requires read permission to the CWD.

v
Deno.noColor

Reflects the NO_COLOR environment variable at program start.

v
Deno.permissions

Deno's permission management API.

v
Deno.pid

The current process ID of this instance of the Deno CLI.

v
Deno.ppid

The process ID of parent process of this instance of the Deno CLI.

v
Deno.stderr

A reference to stderr which can be used to write directly to stderr. It implements the Deno specific Writer, WriterSync, and Closer interfaces as well as provides a WritableStream interface.

v
Deno.stdin

A reference to stdin which can be used to read directly from stdin.

v
Deno.stdout

A reference to stdout which can be used to write directly to stdout. It implements the Deno specific Writer, WriterSync, and Closer interfaces as well as provides a WritableStream interface.

v
Deno.test

Register a test which will be run when deno test is used on the command line and the containing module looks like a test module.

v
Deno.version

Version information related to the current Deno CLI runtime environment.