Ejercicio: Configuración del archivo package.json

Completado

Es un desarrollador de Node.js en Tailwind Traders. Le interesa mucho saber cómo configurar un nuevo proyecto de Node.js. El programa de instalación incluye la generación de un archivo package.json y la creación de algunos scripts comunes que se usarán durante el ciclo de vida del proyecto.

Abrir el proyecto en el contenedor de desarrollo

Se ha proporcionado un entorno de desarrollo sencillo. Si ya tiene Node.js LTS instalado en el equipo, puede omitir esta sección y clonar el repositorio de ejemplo y usar el entorno local.

Desarrollo remoto (explorador)

1. Inicie el proceso para crear una nueva instancia de GitHub Codespace en la rama main del repositorio de GitHub MicrosoftDocs/node-essentials.

   Abra este proyecto en GitHub Codespaces.

2. En la página Crear codespace, revise las opciones de configuración de codespace y, después, seleccione Crear nuevo codespace

   

3. Espere a que se inicie Codespace. Este proceso de startup puede tardar unos minutos.

4. Abra un nuevo terminal en el codespace.

   Sugerencia

   Puede usar el menú principal para ir a la opción de menú Terminal y, a continuación, seleccionar la opción Nuevo terminal.

   

5. Compruebe que Node.js está instalado en el entorno:

   node --version
   

   El contenedor de desarrollo usa una versión Node.js LTS, como v20.5.1. La versión exacta podría ser diferente.

6. Los demás ejercicios de este proyecto tienen lugar en el contexto de este contenedor de desarrollo.

Desarrollo local (Docker)

1. Abra Visual Studio Code en el contexto de un directorio vacío.

2. Asegúrese de que tiene la extensión contenedores de desarrollo instalada en Visual Studio Code.

3. Abra un nuevo terminal en el editor.

   Sugerencia

   Puede usar el menú principal para ir a la opción de menú Terminal y, a continuación, seleccionar la opción Nuevo terminal.

   

4. Clone el repositorio de GitHub MicrosoftDocs/node-essentials en el directorio actual.

   git clone https://github.com/MicrosoftDocs/node-essentials.git
   

5. Abra el repositorio en el código con los siguientes comandos en el terminal.

   cd node-essentials
   code .
   

6. Abra la Paleta de comandos, busque los comandos de contenedores de desarrollo y, a continuación, seleccione Contenedores de desarrollo: volver a abrir en el contenedor.

   Sugerencia

   Visual Studio Code puede solicitar automáticamente que vuelva a abrir la carpeta de un contenedor de desarrollo. Esto es funcionalmente equivalente a usar la paleta de comandos para volver a abrir el área de trabajo actual en un contenedor.

   

7. Compruebe que Node.js está instalado en el entorno:

   node --version
   

   El contenedor de desarrollo usa una versión Node.js LTS, como v20.5.1. La versión exacta podría ser diferente.

8. Los demás ejercicios de este proyecto tienen lugar en el contexto de este contenedor de desarrollo.

Configuración de un nuevo proyecto de Node.js

Para esta unidad, se le ha proporcionado el código fuente de JavaScript. El trabajo consiste en crear el archivo package.json.

1. En el terminal, cambie a la carpeta de este ejercicio:

   cd node-dependencies/3-exercise-package-json
   

2. Ver el contenido de la carpeta:

   ls -R
   

   En esta carpeta, debería ver una subcarpeta src con un archivo index.js:

    ./src:
        index.js
   

3. Ejecute el siguiente comando para crear el archivo package.json con valores predeterminados:

   npm init -y
   

   El archivo package.json que tiene un aspecto similar a este ejemplo:

   {
     "name": "3-exercise-package-json",
     "version": "1.0.0",
     "description": "",
     "main": "index.js",
     "scripts": {
       "test": "echo \"Error: no test specified\" && exit 1"
     },
     "keywords": [],
     "author": "",
     "license": "ISC"
   }
   

4. Modifique package.json con estos valores de propiedad:

   • name: "tailwind-trader-api"
   • description: "API HTTP para administrar elementos de la base de datos de Tailwind Traders"
   • main: "index.js"
   • keywords: ["API", "database"]
   • author: "Sergio"

   El archivo package.json ahora debería ser similar a este código:

   {
     "name": "tailwind-trader-api",
     "version": "1.0.0",
     "description": "HTTP API to manage items from the Tailwind Traders database",
     "main": "index.js",
     "dependencies": {},
     "devDependencies": {},
     "scripts": {
       "test": "echo \"Error: no test specified\" && exit 1"
     },
     "keywords": ["api", "database"],
     "author": "Sam",
     "license": "ISC"
   }
   

5. En la sección scripts, agregue un nuevo script denominado start encima del script test:

   "start": "node ./src/index.js",
   

6. Guarde los cambios y cierre el archivo package.json.

7. Para iniciar el proyecto con la acción start, escriba este comando:

   npm start
   

   Debería ver este resultado:

   Welcome to this application
   

Ahora tiene un buen archivo package.json en el que puede compilar a medida que crece el proyecto.