Dans ce chapitre, préparez-vous à améliorer vos compétences en matière d'applications console en plongeant dans la création d'une application de jeu passionnante 🎮 Devinez le Nombre 🔢. Ce jeu interactif mettra au défi les joueurs d'exercer leur intuition en devinant un nombre généré aléatoirement dans une plage prédéfinie. En cours de route, nous démystifierons des concepts fondamentaux tels que

• 🎲 Génération de nombres aléatoires;
• ✅ Validation des entrées;
• 🤝 Interaction utilisateur;
• 💾 Même sauvegarder les résultats du jeu dans un fichier.

🏆 Un Défi Vous Attend

Imaginez-vous plonger dans une application qui promet excitation et intrigue. Les joueurs sont invités à deviner un nombre mystérieusement choisi dans une plage prédéfinie. L'application offre un retour instantané sur chaque tentative et un décompte méticuleux des essais effectués.

Cet exemple pratique est votre chance d'affiner vos compétences dans la création d'applications CLI et met en valeur l'art de créer des programmes interactifs.

🚀 Application Résultante

Voyez la magie en action ! Ci-dessous, un GIF illustrant l'excitant jeu Devinez le Nombre que vous allez créer :

Construire une application de console de jeu de devinettes

Vous êtes présenté avec deux chemins. La première option vous invite à vous lancer dans le voyage sans assistance, tandis que la seconde offre un guide utile pour assurer votre succès. Que vous plongiez audacieusement ou suiviez le guide structuré, vous êtes en pour une expérience fascinante qui vous laissera avec une application de console fonctionnelle et captivante.

Plan directeur

• 👉 Étape 1 : Configuration et initialisations;
• 👉 Étape 2 : Définir les paramètres du jeu;
• 👉 Étape 3 : Définir les fonctions utilitaires;
• 👉 Étape 4 : Logique du jeu;
• 👉 Étape 5 : Sauvegarder le résultat du jeu;
• 👉 Étape 6 : Démarrer le jeu;
• 🎉 Conclusion;
• 🏁 Code complet de l'application.

Étape 1 : Configuration et Initialisations

Préparez le terrain en créant un nouveau répertoire et un fichier nommé app.js. Dans ce fichier, nous invoquons les modules nécessaires :

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

Créez une interface Readline :

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

Explication : Nous importons les modules nécessaires : readline pour l'interaction avec l'utilisateur et fs.promises pour les opérations sur les fichiers. Ensuite, nous créons une interface Readline nommée rl pour gérer l'entrée et la sortie.

Étape 2 : Définir les paramètres du jeu

Définissez les nombres minimum et maximum :

const minNumber = 1;
const maxNumber = 100;

Générer le nombre secret :

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

Initialiser le compteur de tentatives :

let attempts = 0;

Explication : Nous définissons la plage de nombres (minNumber et maxNumber) dans laquelle le nombre secret sera généré. Le nombre secret est généré aléatoirement en utilisant Math.random() et assigné à secretNumber. La variable attempts est initialisée pour suivre les tentatives de l'utilisateur.

Étape 3 : Définir les fonctions utilitaires

Équipez-vous d'une fonction utilitaire pour une validation impeccable :

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

Explication: La fonction isValidGuess vérifie si le guess de l'utilisateur est un nombre valide dans la plage spécifiée (minNumber à maxNumber).

Étape 4 : Logique du Jeu

Les mécanismes de base du jeu via la fonction 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();
    }
  });
}

Explication : La fonction playGame forme la boucle principale du jeu. Elle utilise rl.question pour inviter l'utilisateur à faire une supposition. Si la supposition est valide, la fonction vérifie si elle correspond au nombre secret. Sinon, elle fournit un retour à l'utilisateur et continue la boucle du jeu de manière récursive.

Étape 5 : Enregistrer le Résultat du Jeu

Implémentez la logique de sauvegarde des réalisations de l'utilisateur dans le fichier 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.');
  }
}

Explication : La fonction saveGameResult utilise fs.promises pour ajouter le résultat du jeu à un fichier nommé game_results.txt. Elle fournit un retour d'information sur le succès ou l'échec de l'enregistrement du résultat.

Étape 6 : Démarrer le Jeu

Créez le message de bienvenue et lancez le jeu :

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

Explication : Nous affichons un message de bienvenue et démarrons la boucle de jeu en appelant la fonction playGame.

🎉 Conclusion : Tour de Victoire

En développant l'application Devinez le Nombre, vous avez acquis une expérience précieuse dans la conception d'applications console interactives et engageantes. Cet exemple illustre la fusion de la saisie utilisateur, de la génération de nombres aléatoires, de la validation et de la manipulation de fichiers, aboutissant à une expérience de jeu captivante.

👨‍💻 Code Complet de l'Application

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();