Primer programa Node.js con argumentos

Contenido del curso

Introducción a Node.js

Módulos y gestión de paquetes

Módulos nativos en Node.js

Servidores con Node.js

Tomar examen

Cursos Empresas Blog Live Conf Eventos Precios

0:0015:30

Primer programa Node.js con argumentos

Curso de Fundamentos de Node.js

Clase 3 de 20

Clase 3 / 20

Recursos

Aprende, paso a paso y con buenas prácticas, a crear tu primer programa en Node.js que recibe argumentos por terminal, valida rangos y genera un número aleatorio. Verás cómo organizar el espacio de trabajo, iniciar git y configurar npm con seguridad y claridad.

¿Cómo preparar el entorno de Node.js y el espacio de trabajo?

Tener un entorno ordenado acelera el desarrollo. Necesitas una terminal, un editor de código y una carpeta para tus proyectos. Se recomienda crear una carpeta de trabajo (por ejemplo, dev) y clasificar proyectos: de trabajo, personales o de pruebas puntuales. Así mantienes control y contexto.

¿Por qué usar Git desde el inicio?

Ejecuta git init para guardar el historial local de cambios.
No obliga a subir a GitHub o BitBucket.
Ayuda a recordar qué cambió, cuándo y por qué.

¿Cómo organizar la carpeta del proyecto?

Crea la carpeta del proyecto: mkdir nodejs.
Entra en la carpeta y abre el editor: code . en Visual Studio Code.
Crea la estructura base: carpeta src y archivo src/index.js.

¿Cómo inicializar npm y configurar el proyecto?

Inicializa el proyecto con npm init. Responde a las indicaciones para definir metadatos y el punto de entrada.

¿Qué datos define npm init?

Nombre: toma el de la carpeta automáticamente.
Versión: 1.0 por defecto.
Descripción: “Node.js examples”.
Punto de entrada: index.js.
Scripts de prueba: por ahora ninguno.
Repositorio: omite si no usarás un remoto.
Palabras clave: opcional por ahora.
Autor: “Óscar Barajas” con correo.
Licencia: MIT para permitir uso, distribución y ventas.

¿Cómo crear un generador de números aleatorios con argumentos en Node.js?

El programa genera un número aleatorio entre 1 y 100 si no recibe argumentos. Si le pasas dos valores por terminal, usa ese rango mínimo y máximo. Incluye validaciones para evitar errores por entradas inválidas.

¿Cómo capturar y validar argumentos por terminal?

Captura argumentos reales a partir de la tercera posición: process.argv.slice(2).
Define valores por defecto: min = 1 y max = 100.
Si hay al menos dos argumentos, conviértelos con parseInt en base 10.
Valida que no sean NaN y que min < max.
Si el rango no es válido, muestra un mensaje y usa los valores por defecto.

// src/index.js
const args = process.argv.slice(2);

let min = 1;
let max = 100;

if (args.length >= 2) {
  const parseMin = parseInt(args[0], 10);
  const parseMax = parseInt(args[1], 10);

  if (!isNaN(parseMin) && !isNaN(parseMax) && parseMin < parseMax) {
    min = parseMin;
    max = parseMax;
  } else {
    console.log('rango inválido: usando valores por defecto del 1 al 100.');
  }
}

const randomNumber = Math.floor(Math.random() * (max - min + 1)) + min;
console.log(`número aleatorio generado entre ${min} y ${max}: ${randomNumber}`);

Habilidades y conceptos que aplicas:

Uso de process.argv y slice(2) para leer argumentos reales.
Valores por defecto y reasignación controlada con let.
Conversión numérica con parseInt y base 10.
Validaciones con isNaN y comparación de rangos (min < max).
Manejo de errores de usuario con mensajes claros.

¿Cómo generar un número aleatorio inclusivo?

Fórmula clave: Math.floor(Math.random() * (max - min + 1)) + min.
Math.random genera [0, 1), sin incluir 1.
Al multiplicar por (max - min + 1) y sumar min, aseguras incluir ambos extremos del rango.

¿Cómo ejecutar y depurar en la terminal?

Ejecutar sin argumentos: node src/index.js.
Ejecutar con rango: node src/index.js 10 50.
Entradas inválidas (por ejemplo, “hola” 20): muestra “rango inválido” y usa 1–100.
Si aparece un error, lee el mensaje: por ejemplo, confundir process.args con process.argv impide usar slice. Los errores señalan dónde corregir.

¿Te animas a mejorar la validación? Propón cómo evitar imprimir un aleatorio cuando el rango sea inválido y cuéntalo en los comentarios.

Jacobo Cosme

Hace 6 meses•editado

¿Cuál es la diferencia entre args y argv?

Hola Jacobo. Mira, esto es más sencillo de lo que parece, no te enredes.

Cuando corres un programa con Node y le pasas palabras extra (como crear usuario), Node guarda absolutamente todo lo que escribiste en una lista larga que técnicamente se llama argv. Esa lista siempre trae un par de cosas "de relleno" en las primeras dos posiciones: la ruta de dónde está instalado Node y la ruta de tu propio archivo. Es como si te dieran la bolsa del súper con el ticket de compra y el panfleto de ofertas adentro, antes de que llegues a tus verduras.

Como a nosotros esas dos primeras cosas no nos interesan para que el programa funcione, lo que hacemos es sacarlas y quedarnos solo con lo que realmente escribimos con intención. A esa nueva lista, ya limpia y ordenada, por costumbre le ponemos el nombre args (que es simplemente una palabra corta para decir "argumentos").

En resumen:

argv es la lista cruda que te da el sistema, con los papelitos de más incluidos.
argses la lista que armas tú después de sacar esos papelitos, lista para usar sin estorbos.

Si imprimes argv sin limpiarla, verás rutas feas del sistema que confunden a cualquiera. Si imprimes args, verás justo lo que necesitas: crear usuario.

¿Lo ves? Uno es lo que te dan, el otro es lo que tú eliges usar. Fácil, ¿no?

Comentarios (42)42 comentarios

Oscar Barajas Tavares

Team Platzi

Hace 2 años

Irving Juárez

Alfonso Neil Jiménez Casallas

Oskar Fabian Vargas Caceres

Hace un año

Raúl Adolfo Sánchez Rodríguez

Jose Ever Muñoz Muñoz

Jared Esaú Ortega Ramírez

David Elias Gatica Morales

Maria Reyes

Dennis Hefziba Martinez Quijano

Hace 9 meses

Juan Diego Caro García

Fernando Emilio Díaz López

Hace 6 meses

Ernesto Emmanuel Gutierrez Muñoz

Mario Alejandro Crespo Reyes

Hace 7 meses

Nicolas Alejandro Baak Poot

Jheison Quiroga

Hace 7 meses•editado

Patricio Manuel Ugarte

Julio Cardenas

Hace 8 meses

Alejandro Zapata

Introducción a Node.js

Qué es Node.js y cómo funciona

NVM para múltiples versiones de Node

Primer programa Node.js con argumentos

Módulos y gestión de paquetes

Módulos en Node.js: CommonJS vs ES Modules

Cómo funciona npm en tu primer proyecto

Cómo crear y probar un paquete npm local

Cómo publicar tu primer paquete npm

Módulos nativos en Node.js

CRUD de archivos con módulo fs

Transcribir audio a texto con Whisper y Node.js

Implementar transcriptAudio con Whisper en Node.js

Console API en Node.js: métodos básicos

Console.count y console.group en JavaScript

Módulo OS de Node.js para monitoreo

Crypto de Node.js: hash SHA-256 completo

Módulo process de Node.js en detalle

Timers en Node.js: setTimeout y setInterval

Streams en Node.js para archivos grandes

Manipulación de buffers binarios en Node.js

Servidores con Node.js

Servidor HTTP en Node.js con flag watch

Servidor Node.js que envía video con streams

Primer programa Node.js con argumentos

Progreso del curso

Introducción a Node.js

Módulos y gestión de paquetes

Módulos nativos en Node.js

Servidores con Node.js

Recursos

Recursos