Node.js & TypeScript

Summary

Develop Node.js based applications in TypeScript. Includes Node.js, eslint, nvm, yarn, and the TypeScript compiler.

Metadata	Value
Contributors	The VS Code Team
Definition type	Dockerfile
Published image	mcr.microsoft.com/vscode/devcontainers/typescript-node:14
Available image variants	mcr.microsoft.com/vscode/devcontainers/typescript-node:14 mcr.microsoft.com/vscode/devcontainers/typescript-node:12 mcr.microsoft.com/vscode/devcontainers/typescript-node:10
Published image architecture(s)	x86-64
Works in Codespaces	Yes
Container host OS support	Linux, macOS, Windows
Languages, platforms	Node.js, TypeScript

Using this definition with an existing folder

While the definition itself works unmodified, you can select the version of Node.js the container uses by updating the VARIANT arg in the included devcontainer.json (and rebuilding if you've already created the container).

"args": { "VARIANT": "12" }

You can also directly reference pre-built versions of .devcontainer/base.Dockerfile by using the image property in .devcontainer/devcontainer.json or updating the FROM statement in your own Dockerfile with one of the following:

mcr.microsoft.com/vscode/devcontainers/typescript-node (latest)
mcr.microsoft.com/vscode/devcontainers/typescript-node:14
mcr.microsoft.com/vscode/devcontainers/typescript-node:12
mcr.microsoft.com/vscode/devcontainers/typescript-node:10

Version specific tags tied to releases in this repository are also available.

mcr.microsoft.com/vscode/devcontainers/typescript-node:0-14
mcr.microsoft.com/vscode/devcontainers/typescript-node:0.123-14
mcr.microsoft.com/vscode/devcontainers/typescript-node:0.123.0-14

Alternatively, you can use the contents of the Dockerfile or the JavaScript and Node.js Dockerfile to fully customize your container's contents.

Beyond TypeScript, Node.js, and git, this image / Dockerfile includes eslint, zsh, Oh My Zsh!, a non-root vscode user with sudo access, and a set of common dependencies for development. It also installs tslint globally and includes the VS Code TSLint extension for backwards compatibility, but TSLint has been deprecated in favor of ESLint, so eslint and its corresponding extension has been included as well.

Note that, while eslintand typescript are installed globally for convenance, but as of ESLint 6, you will need to install the following packages locally to lint TypeScript code: @typescript-eslint/eslint-plugin, @typescript-eslint/parser, eslint, typescript.

Adding the definition to your project

Just follow these steps:

If this is your first time using a development container, please follow the getting started steps to set up your machine.
To use the pre-built image:
1. Start VS Code and open your project folder.
2. Press F1 select and Remote-Containers: Add Development Container Configuration Files... from the command palette.
3. Select the Node.js 14 & TypeScript definition.
To use the Dockerfile for this definition (rather than the pre-built image):
1. Clone this repository.
2. Copy the contents of containers/typescript-node/.devcontainer to the root of your project folder.
3. Start VS Code and open your project folder.
After following step 2 or 3, the contents of the .devcontainer folder in your project can be adapted to meet your needs.
Finally, press F1 and run Remote-Containers: Reopen Folder in Container to start using the definition.

Testing the definition

This definition includes some test code that will help you verify it is working as expected on your system. Follow these steps:

If this is your first time using a development container, please follow the getting started steps to set up your machine.
Clone this repository.
Start VS Code, press F1, and select Remote-Containers: Open Folder in Container...
Select the containers/typescript-node folder.
After the folder has opened in the container, press F5 to start the project. This will automatically run npm install and compile the source before starting it.
Once the project is running, press F1 and select Remote-Containers: Forward Port from Container...
Select port 3000 and click the "Open Browser" button in the notification that appears.
You should see "Hello remote world!" after the page loads.
From here, you can add breakpoints or edit the contents of the test-project folder to do further testing.

License