cours/docs/dev/02-intermediaire/nodejs.md

105 lines
3.4 KiB
Markdown
Raw Normal View History

2023-05-17 11:27:55 +02:00
# Installer Node.js
[Node.js](https://nodejs.org/fr) est un environnement dexécution JavaScript. Plus simplement, c'est un outil permettant d'exécuter des programmes écrits en JavaScript sur un ordinateur.
## Versions
Node.js est en développement permanent, ce qui signifie que de nombreuses versions sont disponibles à l'utilisation. On distingue les version <abbr>`LTS`</abbr> <span lang="en">(long term support)</span> et les mises à jour classiques, plus nombreuses.
Afin d'installer et de gérer plusieurs versions de Node.js sur une seule machine, on peut installer un gestionnaire de version de node, autrement appeler <abbr>`nvm`</abbr> <span lang="en">(node version manager)</span>.
## MacOS
### Installation de nvm
Sur MacOS, on installera [nvm](https://github.com/nvm-sh/nvm) via une commande dans le terminal&nbsp;:
```sh
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.3/install.sh | bash
```
:::warning Attention
Si c'est la première fois que vous tentez d'utiliser le terminal ou certaines commandes, MacOS vous demandera d'installer les <span lang="en">command line tools</span>. C'est une suite d'outils indispensable pour utiliser certaines fonctionnalités en ligne de commande (dans un terminal).
Vous pouvez déclencher cette installation via la commande `xcode-select --install`
:::
Pour vérifier que l'installation s'est bien passée, fermez le terminal puis relancez-le. Lancez enfin `nvm --version` dans le terminal. Vous devez obtenir une réponse similaire à&nbsp;:
```sh{2}
$ nvm --version
0.39.3
```
Si vous obtenez un message d'erreur indiquant que vous n'avez pas de fichier `.bashrc` ou `.zshrc`, lancez la commande suivante pour créer ce dernier&nbsp;:
```sh
# macOs Mojave (10.14) ou inférieure
touch ~/.bashrc
# macOs Catalina (10.15) ou supérieure
touch ~/.zshrc
```
Relancez maintenant la commande d'installation de `nvm` puis `nvm --version` pour vérifier l'installation.
### Installation de node
Nous pouvons maintenant [installer une ou plusieurs versions](https://github.com/nvm-sh/nvm#long-term-support) de Node.js via nvm.
```sh
# installer une version précise de node
nvm install 20.2.0
# installer la dernière version lts en date
nvm install lts/*
# installer une version lts précise
nvm install lts/gallium
```
### Utiliser une version installée
:::info
Cette étape est inutile si vous n'avez qu'une seule version installée.
:::
nvm fera de la première version que vous installerez la version par défaut de votre machine. On peut changer de version en utilisant `nvm use VERSION_INSTALLÉE`.
```sh
# lister les versions installées sur la machine
nvm ls
# choisir une version à utiliser
nvm use 18.16.0
```
## Windows
### Installation de nvm
Comme pour [git](./git.md), il faut installer `nvm` via un exécutable sur Windows. Rendez-vous sur [cette page](https://github.com/coreybutler/nvm-windows/releases) et téléchargez la dernière version de `nvm-setup.exe`.
### Installation de node
Ouvrez une fenêtre `powershell` windows puis lancez&nbsp;:
```sh
# installer une version précise de node
nvm install 20.2.0
# installer la dernière version lts en date
nvm install lts
```
### Utiliser une version installée
nvm attendra qu'on lui dise d'utiliser une version installée pour fonctionner. On peut choisir ou changer de version en utilisant `nvm use VERSION_INSTALLÉE`.
```sh
# lister les versions installées sur la machine
nvm list
# choisir une version à utiliser
nvm use lts
```