En este capítulo, prepárate para mejorar tus habilidades en aplicaciones de consola mientras exploramos la creación de un emocionante juego de Adivina el Número. Este juego interactivo desafía a los jugadores a poner a prueba su intuición adivinando un número generado aleatoriamente dentro de un rango predefinido. A lo largo del proceso, se abordarán conceptos fundamentales como:

• Generación de números aleatorios;
• Validación de entradas;
• Interacción con el usuario;
• Incluso guardar los resultados del juego en un archivo.

Desafío

Imagina sumergirte en una aplicación que promete emoción e intriga. Los jugadores están invitados a adivinar un número elegido misteriosamente dentro de un rango predefinido. La aplicación ofrece retroalimentación instantánea en cada intento y lleva un registro detallado de los intentos realizados.

Este ejemplo práctico es una oportunidad para perfeccionar habilidades en la construcción de aplicaciones CLI y demuestra el arte de crear programas interactivos.

Aplicación resultante

¡Observa la magia en acción! A continuación se muestra un GIF que ilustra la emocionante aplicación del juego Adivina el Número que estarás creando:

Creación de una aplicación de consola para un juego de adivinanzas

Se presentan dos caminos. La primera opción invita a embarcarse en el viaje sin ayuda, mientras que la segunda ofrece una guía útil para asegurar el éxito. Ya sea que te lances con valentía o sigas la guía estructurada, te espera una experiencia fascinante que te dejará con una aplicación de consola funcional y atractiva.

Plan maestro

• Paso 1: Configuración e inicializaciones;
• Paso 2: Definir los parámetros del juego;
• Paso 3: Definir funciones utilitarias;
• Paso 4: Lógica del juego;
• Paso 5: Guardar el resultado del juego;
• Paso 6: Iniciar el juego;
• Conclusión;
• Código completo de la aplicación.

Paso 1: Configuración e inicializaciones

Prepara el entorno creando un nuevo directorio y un archivo llamado app.js. Dentro de este archivo, incluimos los módulos necesarios:

const readline = require('readline');
const fs = require('fs').promises;

Crear una interfaz de Readline:

const rl = readline.createInterface({
  input: process.stdin,
  output: process.stdout
});

Explicación: Se importan los módulos necesarios: readline para la interacción con el usuario y fs.promises para operaciones con archivos. Luego, se crea una interfaz Readline llamada rl para gestionar la entrada y salida.

Paso 2: Definir los parámetros del juego

Establecer los números mínimo y máximo:

const minNumber = 1;
const maxNumber = 100;

Generar el número secreto:

const secretNumber =
  Math.floor(Math.random() * (maxNumber - minNumber + 1)) + minNumber;

Inicializar el contador de intentos:

let attempts = 0;

Explicación: Se define el rango de números (minNumber y maxNumber) dentro del cual se generará el número secreto. El número secreto se genera aleatoriamente utilizando Math.random() y se asigna a secretNumber. La variable attempts se inicializa para llevar el registro de los intentos del usuario.

Paso 3: Definir funciones utilitarias

Incorporación de una función utilitaria para una validación impecable:

function isValidGuess(guess) {
  return !isNaN(guess)
    && guess >= minNumber
    && guess <= maxNumber;
}

Explicación: La función isValidGuess verifica si la suposición del usuario es un número válido dentro del rango especificado (minNumber a maxNumber).

Paso 4: Lógica del juego

La mecánica central del juego a través de la función playGame:

function playGame() {
  rl.question(`Guess a number between ${minNumber} and ${maxNumber}: `, guess => {
    if (isValidGuess(guess)) {
      attempts++;
      const guessNumber = parseInt(guess);

      if (guessNumber === secretNumber) {
        console.log(`Congratulations! You guessed the number in ${attempts} attempts.`);
        saveGameResult(`Player won in ${attempts} attempts.`);
        rl.close();
      } else if (guessNumber < secretNumber) {
        console.log('Try higher.');
        playGame();
      } else {
        console.log('Try lower.');
        playGame();
      }
    } else {
      console.log('Please enter a valid number within the specified range.');
      playGame();
    }
  });
}

Explicación: La función playGame constituye el bucle principal del juego. Utiliza rl.question para solicitar al usuario una suposición. Si la suposición es válida, la función verifica si coincide con el número secreto. Si no es así, proporciona retroalimentación al usuario y continúa el bucle del juego de forma recursiva.

Paso 5: Guardar el resultado del juego

Implementación de la lógica para guardar los logros del usuario en el archivo game_results.txt.

async function saveGameResult(result) {
  try {
    await fs.appendFile('game_results.txt', `${result}\n`);
    console.log('Game result saved.');
  } catch (err) {
    console.log('Failed to save game result.');
  }
}

Explicación: La función saveGameResult utiliza fs.promises para agregar el resultado del juego a un archivo llamado game_results.txt. Proporciona retroalimentación sobre el éxito o fallo al guardar el resultado.

Paso 6: Iniciar el juego

Crear el mensaje de bienvenida e iniciar el juego:

console.log('Welcome to the Guess the Number game!');
playGame();

Explicación: Se muestra un mensaje de bienvenida y se inicia el ciclo del juego llamando a la función playGame.

Código completo de la aplicación

const readline = require("readline");
const fs = require("fs").promises;

const rl = readline.createInterface({
  input: process.stdin,
  output: process.stdout,
});

const minNumber = 1;
const maxNumber = 100;

const secretNumber =
  Math.floor(Math.random() * (maxNumber - minNumber + 1)) + minNumber;
let attempts = 0;

function isValidGuess(guess) {
  return !isNaN(guess) && guess >= minNumber && guess <= maxNumber;
}

function playGame() {
  rl.question(
    `Guess a number between ${minNumber} and ${maxNumber}: `,
    (guess) => {
      if (isValidGuess(guess)) {
        attempts++;
        const guessNumber = parseInt(guess);

        if (guessNumber === secretNumber) {
          console.log(
            `Congratulations! You guessed the number in ${attempts} attempts.`
          );
          saveGameResult(`Player won in ${attempts} attempts.`);
          rl.close();
        } else if (guessNumber < secretNumber) {
          console.log("Try higher.");
          playGame();
        } else {
          console.log("Try lower.");
          playGame();
        }
      } else {
        console.log("Please enter a valid number within the specified range.");
        playGame();
      }
    }
  );
}

async function saveGameResult(result) {
  try {
    await fs.appendFile("game_results.txt", `${result}\n`);
    console.log("Game result saved.");
  } catch (err) {
    console.log("Failed to save game result.");
  }
}

console.log("Welcome to the Guess the Number game!");
playGame();