Outside using Deno with your favorite IDE, this section also documents and environment variables.
There is broad support for Deno in editors/IDEs. The following sections provide information about how to use Deno with editors. Most editors integrate directly into Deno using the Language Server Protocol and the language server that is integrated into the Deno CLI.
If you are trying to write or support a community integration to the Deno language server, there is some located in the Deno CLI code repository, but also feel free to join the Discord community in the channel.
Visual Studio Code
There is an official extension for Visual Studio Code called . When installed, it will connect to the language server built into the Deno CLI.
Because most people work in mixed environments, the extension does not enable a
workspace as Deno enabled by default, and it requires that the "deno.enable"
flag to be set. You can change the settings yourself, or you can choose
Deno: Initialize Workspace Configuration
from the command palette to enable
your project.
More information can be found in the Using Visual Studio Code section of the manual.
JetBrains IDEs
You can get support for Deno in WebStorm and other JetBrains IDEs, including PhpStorm, IntelliJ IDEA Ultimate, and PyCharm Professional. For this, install the from Preferences / Settings | Plugins - Marketplace.
Check out this blog post to learn more about how to get started with Deno.
vim/Neovim
Deno is well supported on both vim and via coc.nvim, and ALE. coc.nvim offers plugins to integrate to the Deno language server while ALE supports it out of the box. The in Neovim also supports Deno. The built-in language server protocol in Neovim also supports Deno.
Neovim 0.6+ and nvim-lspconfig
Neovim has supported Deno’s language server since version 0.5, but recent changes to Deno mean that now 0.6 or newer is needed.
To use the Deno language server install nvim-lspconfig and follow the instructions to enable the .
Deno’s linting is not supported out of the box, but assuming you are using the
on_attach
helper function from the
basic setup example,
the default of lint = false
can be overridden as follows:
Note that if you also have tsserver
as an LSP client, you may run into having
issues where both tsserver
and denols
are attached to your current buffer.
To resolve this, make sure to set some unique root_dir
for both tsserver
and
denols
. Here is an example of such a configuration:
nvim_lsp.denols.setup {
on_attach = on_attach,
root_dir = nvim_lsp.util.root_pattern("deno.json"),
init_options = {
lint = true,
},
}
nvim_lsp.tsserver.setup {
on_attach = on_attach,
root_dir = nvim_lsp.util.root_pattern("package.json"),
init_options = {
lint = true,
},
}
coc.nvim
Once you have
coc.nvim installed
installed, you need to install the required plugin via :CocInstall coc-deno
.
Once the plugin is installed and you want to enable Deno for a workspace, run
the command :CocCommand deno.initializeWorkspace
and you should be able to
utilize commands like gd
(goto definition) and gr
(go/find references).
ALE
ALE supports Deno via the Deno language server out of the box and in many uses cases doesn’t require additional configuration. Once you have ALE installed you can perform the command to get information on the configuration options available.
For more information on how to setup ALE (like key bindings) refer to the official documentation.
Vim-EasyComplete
Vim-EasyComplete supports Deno without any other configuration. Once you have
vim-easycomplete installed,
you need install deno via :InstallLspServer deno
if you havn’t installed deno.
You can get more information from
.
Emacs
lsp-mode
Emacs supports Deno via the Deno language server using lsp-mode. Once it should support Deno, which can be configured to support various settings.
eglot
You can also use built-in Deno language server by using
eglot
.
An example configuration for Deno via eglot:
(add-to-list 'eglot-server-programs '((js-mode typescript-mode) . (eglot-deno "deno" "lsp")))
(defclass eglot-deno (eglot-lsp-server) ()
:documentation "A custom class for deno lsp.")
(cl-defmethod eglot-initialization-options ((server eglot-deno))
(list :enable t
:lint t))
Atom
The Atom editor supports integrating with the Deno language
server via the package.
atom-ide-deno
requires that the Deno CLI be installed and the
atom-ide-base package to be installed
as well.
Sublime Text
Sublime Text supports connecting to the Deno language server via the . You may also want to install the TypeScript package to get full syntax highlighting.
Once you have the LSP package installed, you will want to add configuration to
your .sublime-project
configuration like the below:
{
"settings": {
"LSP": {
"deno": {
"command": [
"deno",
],
"initializationOptions": {
// "config": "", // Sets the path for the config file in your project
"enable": true,
// "importMap": "", // Sets the path for the import-map in your project
"lint": true,
"unstable": false
},
"enabled": true,
"languages": [
{
"languageId": "javascript",
"scopes": ["source.js"],
"syntaxes": [
"Packages/Babel/JavaScript (Babel).sublime-syntax",
"Packages/JavaScript/JavaScript.sublime-syntax"
]
},
{
"languageId": "javascriptreact",
"scopes": ["source.jsx"],
"syntaxes": [
"Packages/Babel/JavaScript (Babel).sublime-syntax",
"Packages/JavaScript/JavaScript.sublime-syntax"
]
},
{
"languageId": "typescript",
"scopes": ["source.ts"],
"syntaxes": [
"Packages/TypeScript-TmLanguage/TypeScript.tmLanguage",
"Packages/TypeScript Syntax/TypeScript.tmLanguage"
]
},
{
"scopes": ["source.tsx"],
"syntaxes": [
"Packages/TypeScript-TmLanguage/TypeScriptReact.tmLanguage",
"Packages/TypeScript Syntax/TypeScriptReact.tmLanguage"
]
}
]
}
}
}
}
Nova
The Nova editor can integrate the Deno language server via the .
GitHub Codespaces
allows you develop fully online or remotely on your local machine without needing to configure or install Deno. It is currently in early access.
Once selected, you will need to rebuild your container so that the Deno CLI is added to the container. After the container is rebuilt, the code space will support Deno.
Kakoune
supports connecting to the Deno language server
via the kak-lsp client. Once
an
example of configuring it up to connect to the Deno language server is by adding
the following to your kak-lsp.toml
:
Built into the Deno CLI is support to generate shell completion information for
the CLI itself. By using deno completions <shell>
, the Deno CLI will output to
stdout the completions. Current shells that are supported:
- bash
- elvish
- fish
- powershell
- zsh
bash example
Output the completions and add them to the environment:
> deno completions bash > /usr/local/etc/bash_completion.d/deno.bash
> source /usr/local/etc/bash_completion.d/deno.bash
PowerShell example
Output the completions:
> deno completions powershell >> $profile
> .$profile
This will be create a Powershell profile at
$HOME\Documents\WindowsPowerShell\Microsoft.PowerShell_profile.ps1
, and it
will be run whenever you launch the PowerShell.
zsh example
You should have a directory where the completions can be saved:
> mkdir ~/.zsh
Then output the completions:
And ensure the completions get loaded in your ~/.zshrc
:
fpath=(~/.zsh $fpath)
autoload -Uz compinit
compinit -u
If after reloading your shell and completions are still not loading, you may
need to remove ~/.zcompdump/
to remove previously generated completions and
then compinit
to generate them again.
zsh example with ohmyzsh and antigen
ohmyzsh is a configuration framework for zsh and can make it easier to manage your shell configuration. is a plugin manager for zsh.
Create the directory to store the completions and output the completions:
> mkdir ~/.oh-my-zsh/custom/plugins/deno
> deno completions zsh > ~/.oh-my-zsh/custom/plugins/deno/_deno
Then your .zshrc
might look something like this:
source /path-to-antigen/antigen.zsh
# Load the oh-my-zsh's library.
antigen use oh-my-zsh
antigen bundle deno
fish example
There are several environment variables which can impact the behavior of Deno:
DENO_AUTH_TOKENS
- a list of authorization tokens which can be used to allow Deno to access remote private code. See the section for more details.DENO_TLS_CA_STORE
- a list of certificate stores which will be used when establishing TLS connections. The available stores aremozilla
andsystem
. You can specify one, both or none. The order you specify the store determines the order in which certificate chains will be attempted to resolved. The default value ismozilla
. Themozilla
store will use the bundled mozilla certs provided bywebpki-roots
. Thesystem
store will use your platforms . The exact set of mozilla certs will depend the version of Deno you are using. If you specify no certificate stores, then no trust will be given to any TLS connection without also specifyingDENO_CERT
or--cert
or specifying a specific certificate per TLS connection.DENO_CERT
- load a certificate authority from a PEM encoded file. This “overrides” the--cert
option. See the Proxies section for more information.DENO_DIR
- this will set the directory where cached information from the CLI is stored. This includes items like cached remote modules, cached transpiled modules, language server cache information and persisted data from local storage. This defaults to the operating systems default cache location and then under thedeno
path.DENO_INSTALL_ROOT
- When usingdeno install
where the installed scripts are stored. This defaults to$HOME/.deno/bin
.DENO_NO_PROMPT
- Set to disable permission prompts on access (alternative to passing--no-prompt
on invocation).DENO_FUTURE_CHECK
- Opt-in to the upcoming behavior of thedeno run
subcommand that doesn’t perform type-checking by default.DENO_WEBGPU_TRACE
- The directory to use for WebGPU traces.HTTP_PROXY
- The proxy address to use for HTTP requests. See the section for more information.HTTPS_PROXY
- The proxy address to use for HTTPS requests. See the Proxies section for more information.NO_COLOR
- If set, this will cause the Deno CLI to not send ANSI color codes when writing to stdout and stderr. See the website for more information on this de facto standard. The value of this flag can be accessed at runtime without permission to read the environment variables by checking the value ofDeno.noColor
.- - Indicates hosts which should bypass the proxy set in the other environment variables. See the Proxies section for more information.