In dit hoofdstuk maak je je klaar om je vaardigheden in het bouwen van console-applicaties te verbeteren terwijl we aan de slag gaan met het maken van een spannend Raad het Getal-spel. Dit interactieve spel daagt spelers uit om hun intuïtie te gebruiken door een willekeurig gegenereerd getal binnen een vooraf bepaald bereik te raden. Onderweg ontrafelen we de basisprincipes zoals:

• Willekeurige getalgeneratie;
• Invoercontrole;
• Gebruikersinteractie;
• Zelfs het opslaan van spelresultaten in een bestand.

Uitdaging

Stel je voor dat je een app verkent die spanning en mysterie belooft. Spelers worden uitgenodigd om een geheimzinnig gekozen getal binnen een vooraf bepaald bereik te raden. De app geeft direct feedback op elke gok en houdt nauwkeurig het aantal pogingen bij.

Dit praktijkvoorbeeld biedt de kans om je vaardigheden in het bouwen van CLI-apps te verfijnen en laat zien hoe je interactieve programma's ontwikkelt.

Resultaat App

Bekijk de magie in actie! Hieronder zie je een GIF die de spannende Raad het Getal-spelapp illustreert die je gaat bouwen:

Een Raadspel Console App Bouwen

Je staat voor twee paden. De eerste optie nodigt je uit om het avontuur zelfstandig aan te gaan, terwijl de tweede een behulpzame gids biedt om je succes te verzekeren. Of je nu moedig zelf aan de slag gaat of de gestructureerde gids volgt, je staat een boeiende ervaring te wachten die resulteert in een functionele en aantrekkelijke console-app.

Masterplan

• Stap 1: Setup en Initialisaties;
• Stap 2: Spelparameters Definiëren;
• Stap 3: Hulpfuncties Definiëren;
• Stap 4: Spellogica;
• Stap 5: Spelresultaat Opslaan;
• Stap 6: Het Spel Starten;
• Conclusie;
• Volledige App Code.

Stap 1: Setup en Initialisaties

Bereid het canvas voor door een nieuwe map en een bestand genaamd app.js aan te maken. In dit bestand halen we de benodigde modules op:

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

Maak een Readline-interface aan:

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

Uitleg: We importeren de benodigde modules: readline voor gebruikersinteractie en fs.promises voor bestandsbewerkingen. Vervolgens maken we een Readline-interface met de naam rl aan om invoer en uitvoer te verwerken.

Stap 2: Spelparameters definiëren

Stel het minimum- en maximumgetal in:

const minNumber = 1;
const maxNumber = 100;

Genereer het geheime nummer:

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

Initialiseer de pogingen teller:

let attempts = 0;

Uitleg: Het bereik van getallen (minNumber en maxNumber) wordt gedefinieerd waarbinnen het geheime getal wordt gegenereerd. Het geheime getal wordt willekeurig gegenereerd met Math.random() en toegewezen aan secretNumber. De variabele attempts wordt geïnitialiseerd om het aantal pogingen van de gebruiker bij te houden.

Stap 3: Hulpfuncties definiëren

Voorzien van een hulpfunctie voor foutloze validatie:

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

Uitleg: De functie isValidGuess controleert of de gok van de gebruiker een geldig getal is binnen het opgegeven bereik (minNumber tot maxNumber).

Stap 4: Spel Logica

De kernmechanica van het spel via de functie 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();
    }
  });
}

Uitleg: De functie playGame vormt de kern van de spel-lus. Deze gebruikt rl.question om de gebruiker om een gok te vragen. Als de gok geldig is, controleert de functie of de gok overeenkomt met het geheime nummer. Zo niet, dan geeft het feedback aan de gebruiker en gaat de spel-lus recursief verder.

Stap 5: Spelresultaat opslaan

Implementeer de logica om de spelprestaties van de gebruiker op te slaan in het bestand 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.');
  }
}

Uitleg: De functie saveGameResult gebruikt fs.promises om het spelresultaat toe te voegen aan een bestand genaamd game_results.txt. Geeft feedback over het succes of falen van het opslaan van het resultaat.

Stap 6: Start het spel

Maak het welkomstbericht en start het spel:

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

Uitleg: We tonen een welkomstbericht en starten de spel-lus door de functie playGame aan te roepen.

Volledige app-code

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