# Node

Para el uso de node utilizamos el manejador de versiones [nodenv](https://github.com/nodenv/nodenv) y algunos plugins. Siempre usamos la versión LTS, poniendo la `major` en el archivo `.node-version`. Es decir, se debe preferir escribir 10 en vez de 10.12.1.

Nodenv es realmente un clone de rbenv pero para node, por lo que funciona muy parecido. Toda la información de la sección de ruby aplica para node.

## OSX

### Instalación

```bash
# Instalar nodenv y node-build
brew install nodenv node-build
```

### TAPS

Taps son repositorios de donde brew puede buscar aplicaciones. Brew viene con el *tap* [homebrew-core](https://github.com/Homebrew/homebrew-core) incluido, pero se puede agregar más. En este caso tuvimos que agregar el tap de [nodenv](https://github.com/nodenv/homebrew-nodenv) para poder instalar los plugins de nodenv con brew.

### Agregar tap de nodenv

```bash
brew tap nodenv/nodenv
```

### Agregar plugins para nodenv

```bash
brew install nodenv-vars nodenv-aliases
```

Luego debes cargar nodenv en tu shell para que puedas acceder a las diferentes versiones. Para esto debes agregar la siguiente linea en tu `.bash_profile` o `.zshrc` dependiendo del shell que uses. Hay dos formas de hacerlo:

1. Ejecutar el siguiente, que agrega automáticamente la línea necesaria:
   * Si usas `.bash_profile`

     ```
     echo 'eval "$(nodenv init -)"' >> ~/.bash_profile
     ```
   * Si usas `.zshrc`

     ```
     echo 'eval "$(nodenv init -)"' >> ~/.zshrc
     ```
2. Abrir `.bash_profile` o `.zshrc` y agregar la linea en el archivo usando el editor de preferencia:

   ```bash
   eval "$(nodenv init -)"
   ```
3. Instalar yarn (`npm install -g yarn` o <https://github.com/pine/nodenv-yarn-install> para no tener que instalarlo a mano con cada versión de node)

## Windows

Para instalar `nodenv` con WSL2, sigue las instrucciones de Linux y en el paso 2 preocupate de usar el comando especial para WSL.

## Linux

Las instrucciones para instalar `nodenv` se obtuvieron del [repositorio oficial](https://github.com/nodenv/nodenv#basic-github-checkout) por si tienes alguna duda.

1. Clonar `nodenv`

   ```
   git clone https://github.com/nodenv/nodenv.git ~/.nodenv
   ```
2. Agrega `~/.nodenv/bin` a tu $PATH para usar los comando en la shell.
   * Si usas bash:

     ```bash
     echo 'export PATH="$HOME/.nodenv/bin:$PATH"' >> ~/.bash_profile
     ```
   * Si usas Zsh:

     ```bash
     echo 'export PATH="$HOME/.nodenv/bin:$PATH"' >> ~/.zshrc
     ```
   * Si usas Windows con WSL:

     ```bash
     echo 'export PATH="$HOME/.nodenv/bin:$PATH"' >> ~/.bashrc
     ```
3. Configura `nodenv` en tu shell

```bash
~/.nodenv/bin/nodenv init
```

Te deberá aparecer un mensaje similar a este, que se hará en el siguiente paso:

```bash
# Load nodenv automatically by appending
# the following to ~/.bashrc:
eval "$(nodenv init -)"
```

1. Añade `~/.nodenv/bin` a `$PATH`
   * En **Ubuntu 20.04** y **WSL2**:

     `$ echo 'export PATH="$HOME/.nodenv/bin:$PATH"' >> ~/.bashrc`
   * En **bash**:w

     `$ echo 'export PATH="$HOME/.nodenv/bin:$PATH"' >> ~/.bash_profile`
   * En **Zsh**:

     `$ echo 'export PATH="$HOME/.nodenv/bin:$PATH"' >> ~/.zshrc`
   * En **Fish shell**:

     `$ set -Ux fish_user_paths $HOME/.nodenv/bin $fish_user_paths`
2. Instalar **node build**

   ```shell
   # https://github.com/nodenv/node-build#installation
   # macOS
   $ brew install node-build

   # Cualquiera de las 2 opciones siguientes debería servir para Ubuntu 20.04+ y WSL2
   # As a nodenv plugin
   $ mkdir -p "$(nodenv root)"/plugins
   $ git clone https://github.com/nodenv/node-build.git "$(nodenv root)"/plugins/node-build

   # As a standalone program
   $ git clone https://github.com/nodenv/node-build.git
   $ PREFIX=/usr/local ./node-build/install.sh
   ```
3. Reinicia tu shell para que se apliquen todos los cambios.
4. Verifica que `nodenv` se instaló correctamente con el siguiente script llamado nodenv-doctor:

   ```bash
   curl -fsSL https://github.com/nodenv/nodenv-installer/raw/master/bin/nodenv-doctor | bash
   ```

   Con este script deberías ver algo así:

   ![](https://1676720098-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LFSs0Sc43aJVC8VIVG8%2Fuploads%2Fgit-blob-4cebd02b6cc9718ab931b013cd77ea3eb6e8fdc4%2Fnode-1.png?alt=media)

   Si se encuentra algún error de instalación, refiere a la documentación oficial.
5. Instalar plugins necesarios (es posible que ya se te hayan instalado algunos)
   * [nodenv-vars](https://github.com/nodenv/nodenv-vars#installation):

     ```bash
      mkdir -p $(nodenv root)/plugins
      cd $(nodenv root)/plugins
      git clone https://github.com/nodenv/nodenv-vars.git
     ```
   * [nodenv-aliases](https://github.com/nodenv/nodenv-aliases#installation):

     ```bash
     git clone https://github.com/nodenv/nodenv-aliases.git $(nodenv root)/plugins/nodenv-aliases
     ```
   * [node-build](https://github.com/nodenv/node-build#installation):

     ```bash
     mkdir -p "$(nodenv root)"/plugins
     git clone https://github.com/nodenv/node-build.git "$(nodenv root)"/plugins/node-build
     ```
   * Instalar yarn (npm install -g yarn o <https://github.com/pine/nodenv-yarn-install> para no tener que instalarlo a mano con cada versión de node)

## Instalando versiones de node

Para instalar nuevas versiones de node:

```bash
# Actualizar las versiones de node disponibles para instalar
cd $(nodenv root)/plugins/node-build && git pull
# o en OSX
brew upgrade node-build

# Listar todos las versiones disponibles para instalar
nodenv install --list

# Instalar una version en particular
nodenv install 12.19.1

# Establecer una version global de node
nodenv global 12.19.1
```