default
The global namespace where Deno specific, non-standard APIs are located.
The global namespace where Deno specific, non-standard APIs are located.
Registers the given function as a listener of the given signal event.
Returns the script arguments to the program.
UNSTABLE: New API, yet to be vetted.
UNSTABLE: New API, yet to be vetted.
UNSTABLE: New API, yet to be vetted.
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.
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.
The interface for defining a benchmark test using Deno.bench
.
Information related to the build of the current Deno runtime.
If Deno.resolveDns
is called with "CAA"
record type
specified, it will resolve with an array of objects with this interface.
Change the current working directory to the specified path.
The interface for handling a child process returned from
Deno.Command.spawn
.
Changes the permission of a specific file/directory of specified path. Ignores the process's umask.
Synchronously changes the permission of a specific file/directory of specified path. Ignores the process's umask.
Change owner of a regular file or directory.
Synchronously change owner of a regular file or directory.
Create a child process.
Options which can be set when calling Deno.Command
.
The interface returned from calling Deno.Command.output
or
Deno.Command.outputSync
which represents the result of spawning the
child process.
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
).
Establishes a secure connection over TLS (transport layer security) using an optional cert file, hostname (default is "127.0.0.1") and port. The cert file is optional and if not included Mozilla's root certificates will be used (see also https://github.com/ctz/webpki-roots for specifics)
Gets the size of the console as columns/rows.
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.
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.
Creates a file if none exists or truncates an existing file and resolves to
an instance of Deno.FsFile
.
UNSTABLE: New API, yet to be vetted.
UNSTABLE: New API, yet to be vetted.
Creates a file if none exists or truncates an existing file and returns
an instance of Deno.FsFile
.
UNSTABLE: New API, yet to be vetted.
CronSchedule is the interface used for JSON format
cron schedule
.
UNSTABLE: New API, yet to be vetted.
Return a string representing the current working directory.
A generic transport listener for message-oriented protocols.
Information about a directory entry returned from Deno.readDir
and Deno.readDirSync
.
Opens an external dynamic library and registers symbols, making foreign functions available to be called.
UNSTABLE: New API, yet to be vetted.
An interface containing methods to interact with the process environment variables.
An interface containing methods to interact with the process environment variables.
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.
A set of error constructors that are raised by Deno APIs.
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 @{link BadResource} error instead.
Raised when an operation to 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 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, or the user did not provide required
--allow-*
flag.
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.
Returns the path to the current deno executable.
Exit the Deno process with optional exit code.
The exit code for the Deno process.
Flushes any pending data operations of the given file stream to disk.
Synchronously flushes any pending data operations of the given file stream to disk.
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.
Provides information about a file and is returned by
Deno.stat
, Deno.lstat
, Deno.statSync
,
and Deno.lstatSync
or from calling stat()
and statSync()
on an Deno.FsFile
instance.
Acquire an advisory file-system lock for the provided file.
Acquire an advisory file-system lock synchronously for the provided file.
The interface for a foreign function as defined by its parameter and result types.
A foreign library interface descriptor.
Type conversion for foreign symbol return types.
Type conversion for foreign symbol return types and unsafe callback parameters.
Represents a unique file system event yielded by a
Deno.FsWatcher
.
Additional information for FsEvent objects with the "other" kind.
The Deno abstraction for reading and writing files.
Returned by Deno.watchFs
. It is an async iterator yielding up
system events. To stop watching the file system by calling .close()
method.
Flushes any pending data and metadata operations of the given file stream to disk.
Synchronously flushes any pending data and metadata operations of the given file stream to disk.
Release an advisory file-system lock for the provided file.
Release an advisory file-system lock for the provided file synchronously.
Returns the group id of the process on POSIX platforms. Returns null on windows.
Get the hostname
of the machine the Deno process is running on.
The permission descriptor for the allow-hrtime
and deny-hrtime
permissions, which
controls if the runtime code has access to high resolution time. High
resolution time is considered sensitive information, because it can be used
by malicious code to gain information about the host that it might not
otherwise have access to.
UNSTABLE: New API, yet to be vetted.
An instance of the server created using Deno.serve()
API.
Converts the input into a string that has the same format as printed by
console.log()
.
Option which can be specified when performing Deno.inspect
.
A namespace containing runtime APIs available in Jupyter notebooks.
Broadcast a message on IO pub channel.
Display function for Jupyter Deno Kernel.
Mimics the behavior of IPython's display(obj, raw=True)
function to allow
asynchronous displaying of objects in Jupyter.
Format an object for displaying in Deno
Show HTML in Jupyter frontends with a tagged template function.
Show Markdown in Jupyter frontends with a tagged template function.
A collection of supported media types and data for Jupyter frontends.
SVG Tagged Template Function.
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"
.
UNSTABLE: New API, yet to be vetted.
Consistency level of a KV operation.
UNSTABLE: New API, yet to be vetted.
UNSTABLE: New API, yet to be vetted.
UNSTABLE: New API, yet to be vetted.
UNSTABLE: New API, yet to be vetted.
UNSTABLE: New API, yet to be vetted.
UNSTABLE: New API, yet to be vetted.
UNSTABLE: New API, yet to be vetted.
UNSTABLE: New API, yet to be vetted.
UNSTABLE: New API, yet to be vetted.
Creates newpath
as a hard link to oldpath
.
Synchronously creates newpath
as a hard link to oldpath
.
Listen announces on the local transport address.
Listen announces on the local transport address.
A generic network listener for stream-oriented protocols.
Listen announces on the local transport address over TLS (transport layer security).
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.
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.
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.
The URL of the entrypoint module entered from the command-line. It requires read permission to the CWD.
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.
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.
Creates a new temporary file in the default directory for temporary
files, unless dir
is specified.
Synchronously creates a new temporary file in the default directory for
temporary files, unless dir
is specified.
Options which can be set when using Deno.makeTempDir
,
Deno.makeTempDirSync
, Deno.makeTempFile
, and
Deno.makeTempFileSync
.
Returns an object describing the memory usage of the Deno process and the V8 subsystem measured in bytes.
Creates a new directory with the specified path.
Options which can be set when using Deno.mkdir
and
Deno.mkdirSync
.
Synchronously creates a new directory with the specified path.
Represents membership of a IPv4 multicast group.
Represents membership of a IPv6 multicast group.
If Deno.resolveDns
is called with "MX"
record type
specified, it will return an array of objects with this interface.
If Deno.resolveDns
is called with "NAPTR"
record type
specified, it will return an array of objects with this interface.
All BigInt number types for interfacing with foreign functions.
The native boolean type for interfacing to foreign functions.
The native buffer type for interfacing to foreign functions.
The native function type for interfacing with foreign functions.
All plain number types for interfacing with foreign functions.
The native pointer type for interfacing to foreign functions.
The native struct type for interfacing with foreign functions.
All supported types for interfacing with foreign functions.
The native void type for interfacing with foreign functions.
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.
The information for a network interface returned from a call to
Deno.networkInterfaces
.
Returns an array of the network interface information.
Reflects the NO_COLOR
environment variable at program start.
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.
UNSTABLE: New API, yet to be vetted.
Options which can be set when doing Deno.open
and
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.
Returns the release version of the Operating System.
Returns the Operating System uptime in number of seconds.
Permission descriptors which define a permission and can be queried, requested, or revoked.
The name of a privileged feature which needs permission.
Options which define the permissions within a test or worker context.
A set of options which can define the permissions within a test or worker context at a highly specific level.
Deno's permission management API.
Deno's permission management API.
The current status of the permission:
An EventTarget
returned from the Deno.permissions
API which can provide updates to any state changes of the permission.
The interface which defines what event types are supported by
PermissionStatus
instances.
The current process ID of this instance of the Deno CLI.
UNSTABLE: New API, yet to be vetted.
UNSTABLE: New API, yet to be vetted.
The process ID of parent process of this instance of the Deno CLI.
UNSTABLE: New API, yet to be vetted.
Reads the directory given by path
and returns an async iterable of
Deno.DirEntry
. The order of entries is not guaranteed.
Synchronously reads the directory given by path
and returns an iterable
of Deno.DirEntry
. The order of entries is not guaranteed.
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.
Options which can be set when using Deno.readFile
or
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.
Resolves to the full path destination of the named symbolic link.
Synchronously returns the full path destination of the named symbolic link.
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).
Asynchronously reads and returns the entire contents of a file as an UTF-8 decoded string. Reading a directory throws an error.
Synchronously reads and returns the entire contents of a file as an UTF-8 decoded string. Reading a directory throws an error.
Resolves to the absolute normalized path, with symbolic links resolved.
Synchronously returns absolute normalized path, with symbolic links resolved.
The type of the resource record to resolve via DNS using
Deno.resolveDns
.
Make the timer of the given id
block the event loop from finishing.
Removes the named file or directory.
Options which can be set when using Deno.remove
and
Deno.removeSync
.
Removes the given signal listener that has been registered with
Deno.addSignalListener
.
Synchronously removes the named file or directory.
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.
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.
Performs DNS resolution against the given query, returning resolved records.
Options which can be set when using Deno.resolveDns
.
UNSTABLE: New API, yet to be vetted.
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.
An abstract interface which when implemented provides an interface to seek within an open file/resource asynchronously.
An abstract interface which when implemented provides an interface to seek within an open file/resource synchronously.
A enum which defines the seek mode for IO related APIs that support seeking.
Serves HTTP requests with the given handler.
A handler for HTTP requests. Consumes a request and returns a response.
Information for a HTTP request.
Options which can be set when calling Deno.serve
.
Additional options which are used when opening a TLS (HTTPS) server.
A handler for unix domain socket HTTP requests. Consumes a request and returns a response.
Information for a unix domain socket HTTP request.
Operating signals which can be listened for or sent to sub-processes. What signals and what their standard behaviors are OS dependent.
If Deno.resolveDns
is called with "SOA"
record type
specified, it will return an array of objects with this interface.
If Deno.resolveDns
is called with "SRV"
record type
specified, it will return an array of objects with this interface.
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.
Resolves to a Deno.FileInfo
for the specified path
. Will
always follow symlinks.
A utility type that infers a foreign library interface.
A utility type that infers a foreign symbol.
Synchronously returns a Deno.FileInfo
for the specified
path
. Will always follow symlinks.
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.
A reference to stdin
which can be used to read directly from stdin
.
It implements the Deno specific Reader
, ReaderSync
,
and Closer
interfaces as well as provides a
ReadableStream
interface.
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.
Creates newpath
as a symbolic link to oldpath
.
Options that can be used with symlink
and
symlinkSync
.
Creates newpath
as a symbolic link to oldpath
.
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.
Information returned from a call to 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.
Specialized listener that accepts TCP connections.
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.
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.
Provides TLS certified keys, ie: a key that has been certified by a trusted certificate authority. A certified key generally consists of a private key and certificate part.
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.
Specialized listener that accepts TLS connections.
A utility type for conversion of parameter types of foreign functions.
Type conversion for unsafe callback return types.
Type conversion for foreign symbol parameters and unsafe callback return types.
Truncates (or extends) the specified file, to reach the specified len
.
If len
is not specified then the entire file contents are truncated.
Synchronously truncates (or extends) the specified file, to reach the
specified len
. If len
is not specified then the entire file contents
are truncated.
UNSTABLE: New API, yet to be vetted.
Returns the user id of the process on POSIX platforms. Returns null on Windows.
Retrieve the process umask. If mask
is provided, sets the process umask.
This call always returns what the umask was before the call.
Specialized listener that accepts Unix connections.
Options which can be set when opening a Unix listener via
Deno.listen
or Deno.listenDatagram
.
Make the timer of the given id
not block the event loop from finishing.
An unsafe function pointer for passing JavaScript functions as C function pointers to foreign function calls.
Definition of a unsafe callback function.
An unsafe callback function.
An unsafe pointer to a function, for calling functions that are not present as symbols.
A collection of static functions for interacting with pointer objects.
UNSTABLE: New API, yet to be vetted.
Creates a presentable WebGPU surface from given window and display handles.
UNSTABLE: New API, yet to be vetted.
Upgrade an incoming HTTP request to a WebSocket.
Options which can be set when performing a
Deno.upgradeWebSocket
upgrade of a Request
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.
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.
Version information related to the current Deno CLI runtime environment.
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
).
The object that is returned from a Deno.upgradeWebSocket
request.
Write data
to the given path
, by default creating a new file if
needed, else overwriting.
Options for writing to a file.
Synchronously write data
to the given path
, by default creating a new
file if needed, else overwriting.
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).
Write string data
to the given path
, by default creating a new file if
needed, else overwriting.
Synchronously write string data
to the given path
, by default creating
a new file if needed, else overwriting.
A variable-sized buffer of bytes with read()
and write()
methods.
Close the given resource ID (rid
) which has been previously opened, such
as via opening or creating a file. Closing a file when you are finished
with it is important to avoid leaking resources.
An abstract interface which when implemented provides an interface to close files/resources that were previously opened.
Copies from src
to dst
until either EOF (null
) is read from src
or
an error occurs. It resolves to the number of bytes copied or rejects with
the first error encountered while copying.
A symbol which can be used as a key for a custom method which will be
called when Deno.inspect()
is called, or when the object is logged to
the console.
The Deno abstraction for reading and writing files.
Returns a Deno.FileInfo
for the given file stream.
Synchronously returns a Deno.FileInfo
for the given file
stream.
Truncates or extends the specified file stream, to reach the specified
len
.
Synchronously truncates or extends the specified file stream, to reach the
specified len
.
Changes the access (atime
) and modification (mtime
) times of a file
stream resource referenced by rid
. Given times are either in seconds
(UNIX epoch time) or as Date
objects.
Synchronously changes the access (atime
) and modification (mtime
) times
of a file stream resource referenced by rid
. Given times are either in
seconds (UNIX epoch time) or as Date
objects.
The async iterable that is returned from serveHttp
which
yields up RequestEvent
events, representing individual
requests on the HTTP server connection.
Check if a given resource id (rid
) is a TTY (a terminal).
Turns a Reader, r
, into an async iterator.
Turns a ReaderSync, r
, into an iterator.
Receive metrics from the privileged side of Deno. This is primarily used in the development of Deno. Ops, also called bindings, are the go-between between Deno JavaScript sandbox and the rest of Deno.
Represents an instance of a sub process that is returned from
Deno.run
which can be used to manage the sub-process.
The status resolved from the .status()
method of a
Deno.Process
instance.
Read from a resource ID (rid
) into an array buffer (buffer
).
Read Reader r
until EOF (null
) and resolve to the content as
Uint8Array`.
Synchronously reads Reader r
until EOF (null
) and returns the content
as Uint8Array
.
An abstract interface which when implemented provides an interface to read bytes into an array buffer asynchronously.
An abstract interface which when implemented provides an interface to read bytes into an array buffer synchronously.
Synchronously read from a resource ID (rid
) into an array buffer
(buffer
).
The event yielded from an HttpConn
which represents an HTTP
request from a remote client.
A map of open resources that Deno is tracking. The key is the resource ID (rid) and the value is its representation.
Returns a map of open resource IDs (rid) along with their string
representations. This is an internal API and as such resource
representation has unknown
type; that means it can change any time and
should not be depended upon.
Options which can be used with Deno.run
.
Seek a resource ID (rid
) to the given offset
under mode given by whence
.
The call resolves to the new position within the resource (bytes from the start).
Synchronously seek a resource ID (rid
) to the given offset
under mode
given by whence
. The new position within the resource (bytes from the
start) is returned.
Provides an interface to handle HTTP request and responses over TCP or TLS
connections. The method returns an HttpConn
which yields up
RequestEvent
events, which utilize the web platform standard
Request
and Response
objects to handle the request.
Shutdown socket send operations.
Write to the resource ID (rid
) the contents of the array buffer (data
).
Write all the content of the array buffer (arr
) to the writer (w
).
Synchronously write all the content of the array buffer (arr
) to the
writer (w
).
An abstract interface which when implemented provides an interface to write bytes from an array buffer to a file/resource asynchronously.
An abstract interface which when implemented provides an interface to write bytes from an array buffer to a file/resource synchronously.
Synchronously write to the resource ID (rid
) the contents of the array
buffer (data
).