This track relies on NodeJS throughout to provide a runtime for JavaScript. This means that we assume all execution of JavaScript on your computer will happen using NodeJS.

Many machines come pre-installed with NodeJS, or might have been installed previously, or as a dependency. So before we do anything, we should check if it's already installed:

1. Open up a terminal (Terminal, cmd, Powershell, bash, ...)
2. node -v

If NodeJS is installed, a version is displayed. Write this version down. If NodeJS is not installed, an error will be written out. Usually something along the lines of 'node' is not recognised.

Browse to the NodeJS website. It will display two versions (if it detects your OS. Otherwise select your OS first). If your node -v version matches one of these, you're good. If it doesn't, we recommend that you use Node LTS. If you're worried upgrading might break something on your system, you can continue as if everything is fine; we might not be able to provide support when something unexpected happens.

There are a couple of ways to install NodeJS:

• via an Installer or Binary
• via a package manager

Both options support Windows, MacOS, and Linux. If you don't know what to do, using an installer is the easier.

• We recommend using the LTS version. This is also indicated as recommended on the NodeJS website "for most users".
• Follow the instructions on the webpage and/or during the installer and install NodeJS.

After the installer is done, or the package manager has completed, or the binary has been copied and the instructions have been followed, it's good to test if everything is alright.

1. Open up a terminal (Terminal, cmd, Powershell, bash, ...)
2. node -v

The version should match the one on the website.

Note: It is important you open a new terminal window. Any open terminal windows might not have been refreshed after the installation completed. This means that the open terminals don't know that a new program was installed.

Help: 'node' is not recognised

If you've used the official installer, your PATH should have been automatically configured, but if your shell has trouble locating your globally installed modules — or if you build Node.js from source — update your PATH to include the npm binaries.

On MacOS and Linux you may accomplish this by adding the following to either ~/.bash_profile or ~/.zshrc:

$ export PATH=/usr/local/share/npm/bin:$PATH

On Windows open the start menu and search for "environment variables". You'll need to edit the PATH entry and add the path to the npm binaries here. Usually these are found at C:\Program Files\nodejs. If you browse here with your File Explorer, you should find node.exe, npm.bat and npx.bat.

Close any open terminals and open a new one.

Please follow these instructions to download exercism cli for your OS.

Once CLI is all setup & configured, download the first exercise - hello-world:

$ exercism download --exercise=hello-world --track=javascript

Each assignment then needs some tools to run the tests. They can be installed running this command within each assignment directory:

$ npm install

If you're concerned about disk space and are okay installing another tool, take a look at pnpm, which ensure only one copy of each package-version is ever installed on disk. In this case, run pnpm install instead of npm install, and everything should work as expected.

But what is npm and why does this work?

You don't need this information in order to complete the JavaScript track, but if you're eager to understand what just happened, the following paragraphs are for you:

This works because npm is a package manager that comes bundled with NodeJS, which has been installed per the steps above. The npm command looks for a package.json file, which is present in each assignment folder. This file lists the "dependencies" above, which are then downloaded by npm and placed into the node_modules folder.

The scripts in the package.json use the binaries from the local node_modules folder, and it's these scripts that are used to run the tests, as listed in the exercise description.