I dette kapitel får du mulighed for at forbedre dine færdigheder i at udvikle konsolapplikationer, når vi dykker ned i opbygningen af et spændende Gæt Tallet-spil. Dette interaktive spil udfordrer spillere til at bruge deres intuition ved at gætte et tilfældigt genereret tal inden for et foruddefineret interval. Undervejs udforsker vi grundlæggende begreber som:

• Tilfældig talgenerering;
• Validering af input;
• Brugerinteraktion;
• Endda gemme spilresultater i en fil.

Udfordring

Forestil dig at udforske en app, der lover spænding og mystik. Spillere inviteres til at gætte et hemmeligt valgt tal inden for et foruddefineret interval. Appen giver øjeblikkelig feedback på hvert gæt og holder nøje styr på antallet af forsøg.

Dette praktiske eksempel er din mulighed for at forfine dine færdigheder i at bygge CLI-apps og demonstrerer kunsten at skabe interaktive programmer.

Resultat App

Se magien udfolde sig! Nedenfor ses en GIF, der illustrerer det spændende Gæt Tallet-spil, som du skal bygge:

Bygning af et Gæt et Tal-konsolprogram

Du står over for to veje. Den første mulighed opfordrer dig til at begive dig ud på rejsen uden hjælp, mens den anden tilbyder en hjælpsom guide for at sikre din succes. Uanset om du kaster dig ud i det eller følger den strukturerede guide, venter der dig en fascinerende oplevelse, der vil efterlade dig med et funktionelt og fængende konsolprogram.

Masterplan

• Trin 1: Opsætning og initialisering;
• Trin 2: Definer spilparametre;
• Trin 3: Definer hjælpefunktioner;
• Trin 4: Spil-logik;
• Trin 5: Gem spilresultat;
• Trin 6: Start spillet;
• Konklusion;
• Fuld programkode.

Trin 1: Opsætning og initialisering

Forbered lærredet ved at oprette et nyt bibliotek og en fil med navnet app.js. I denne fil importeres de nødvendige moduler:

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

Opret et Readline-interface:

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

Forklaring: Vi importerer de nødvendige moduler: readline til brugerinteraktion og fs.promises til filoperationer. Derefter opretter vi et Readline-interface kaldet rl til at håndtere input og output.

Trin 2: Definer spilparametre

Angiv minimums- og maksimumstal:

const minNumber = 1;
const maxNumber = 100;

Generér det hemmelige tal:

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

Initialiser tælleren for forsøg:

let attempts = 0;

Forklaring: Området for tal (minNumber og maxNumber) defineres, inden for hvilket det hemmelige tal genereres. Det hemmelige tal genereres tilfældigt ved hjælp af Math.random() og tildeles til secretNumber. Variablen attempts initialiseres for at holde styr på brugerens forsøg.

Trin 3: Definer hjælpefunktioner

Udstyret med en hjælpefunktion for fejlfri validering:

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

Forklaring: Funktionen isValidGuess kontrollerer, om brugerens gæt er et gyldigt tal inden for det angivne interval (minNumber til maxNumber).

Trin 4: Spillets logik

Spillets kernefunktionalitet gennem funktionen 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();
    }
  });
}

Forklaring: playGame-funktionen udgør den centrale spilsløjfe. Den bruger rl.question til at bede brugeren om et gæt. Hvis gættet er gyldigt, kontrollerer funktionen, om gættet matcher det hemmelige tal. Hvis ikke, gives der feedback til brugeren, og spilsløjfen fortsætter rekursivt.

Trin 5: Gem spilresultat

Implementering af logikken til at gemme brugerens spilpræstationer i filen 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.');
  }
}

Forklaring: Funktionen saveGameResult bruger fs.promises til at tilføje spilresultatet til en fil med navnet game_results.txt. Den giver feedback om, hvorvidt det lykkedes at gemme resultatet eller ej.

Trin 6: Start spillet

Opret velkomstbeskeden og start spillet:

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

Forklaring: Vi viser en velkomstbesked og starter spil-loopet ved at kalde funktionen playGame.

Fuld app-kode

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