JS: Configuración del entorno

Teoría: NPM

Cuando instalamos Node.js, no solo tenemos acceso al intérprete que entiende JavaScript fuera del navegador. También ganamos una herramienta muy poderosa llamada npm, abreviación de Node Package Manager. Esta herramienta nos ayuda a organizar y automatizar nuestros proyectos de JavaScript.

¿Qué es npm y por qué lo usamos?

npm es un gestor de paquetes. Es como una caja de herramientas que nos permite:
  • Instalar y actualizar librerías hechas por otras personas (por ejemplo, React, Express, etc.).
  • Administrar las dependencias (las librerías externas que necesita nuestro proyecto).
  • Automatizar tareas, como correr pruebas o compilar tu código.
  • Llevar un control claro de qué usa nuestro proyecto.

Cuando hablamos de un "paquete" en el mundo de npm, nos referimos a cualquier conjunto de archivos que forman un proyecto de JavaScript, ya sea una aplicación web, una API, o una librería.

Verificar si npm está instalado

Después de instalar Node.js, deberíamos tener npm disponible automáticamente. Para asegurarnos, solo tenemos que abrir la terminal (puede ser en VS Code o tu consola favorita) y escribir:

npm  --version

Si todo está bien, vas a ver un número de versión, como:

8.19.2

Eso significa que ya podemos usar npm en cualquier proyecto.

Crear un nuevo proyecto con npm

Vamos a crear nuestro primer proyecto paso a paso.

1. Crear una carpeta para el proyecto

Primero, hagamos un directorio donde guardaremos nuestro código.

mkdir  codica-hello-world
cd  codica-hello-world

2. Inicializar el proyecto con npm

Ahora usamos el comando:

npm  init

Este comando nos hará una serie de preguntas (nombre del proyecto, versión, autor...). Podemos presionar Enter en todas para usar los valores por defecto.

Si no queremos responder nada, podemos usar:

npm  init  -y

Este comando crea automáticamente un archivo llamado package.json con una configuración inicial.

¿Qué es el archivo package.json?

Este archivo es como la "hoja de vida" del proyecto: describe qué herramientas usa, cómo se llama, qué versión tiene, y qué comandos se pueden ejecutar.

Este es un ejemplo de un archivo package.json:

{
"name": "codica-hello-world",
"version": "1.0.0",
"type": "module",
"description": "",
"main": "index.js",
"scripts": {
"test": "echo \"Error: no test specified\" && exit 1"
},
"author": "",
"license": "ISC"
}

Algunas claves importantes

ClaveDescripción
nameNombre del proyecto.
versionVersión actual. Útil para control de cambios.
typeSi es "module", podemos usar import / export. Hay que agregarlo nosotros.
mainArchivo principal del proyecto (puede cambiarse si se desea).
scriptsAcciones automáticas que podemos correr con npm run.
Si vas a usar la sintaxis moderna de módulos (import/export), asegúrate de incluir "type": "module" dentro de package.json.

¿Dónde escribimos nuestro código?

Una vez creado el proyecto, veremos el archivo package.json, pero el código de nuestra aplicación va a ir principalmente en un archivo index.js.

Crea un archivo llamado index.js (en la misma carpeta del proyecto) y escribe el siguiente código:

// Este mensaje aparecerá en la terminal cuando ejecutemos el proyecto
console.log("¡Hola, Códica!");

Para ejecutar el código, usamos:

node  index.js

Y veremos la salida:

¡Hola,  Códica!

Resumen

  • Node.js incluye automáticamente npm.
  • Puedes verificar que tienes npm instalado con npm --version.
  • Para iniciar un nuevo proyecto, usamos npm init (o npm init -y).
  • El archivo package.json guarda la configuración del proyecto.
  • Agrega "type": "module" en package.json si quieres usar import/export.
  • El archivo principal del proyecto es index.js.

Ahora que ya sabes cómo empezar un proyecto con npm, en próximas lecciones veremos cómo instalar paquetes y crear scripts personalizados para automatizar tareas comunes. ¡Vamos paso a paso!

NavegaciónTeoría

Completado

0 / 11