Tässä luvussa pääset kehittämään konsolisovellustaitojasi luomalla jännittävän Arvaa luku -pelin. Tämä interaktiivinen peli haastaa pelaajat käyttämään intuitiotaan arvaamalla satunnaisesti valitun luvun ennalta määritellyltä alueelta. Samalla tutustutaan keskeisiin käsitteisiin, kuten

• Satunnaislukujen generointi;
• Syötteen validointi;
• Käyttäjän vuorovaikutus;
• Pelitulosten tallentaminen tiedostoon.

Haaste

Kuvittele sovellus, joka lupaa jännitystä ja arvoituksellisuutta. Pelaajat kutsutaan arvaamaan salaperäisesti valittu luku ennalta määritellyltä alueelta. Sovellus antaa välitöntä palautetta jokaisesta arvauksesta ja pitää tarkkaa kirjaa yrityksistä.

Tämä käytännön esimerkki tarjoaa mahdollisuuden hioa taitoja CLI-sovellusten rakentamisessa ja esittelee interaktiivisten ohjelmien toteutuksen taidon.

Lopputulos

Katso, miten sovellus toimii! Alla oleva GIF havainnollistaa jännittävää Arvaa luku -peliä, jonka tulet rakentamaan:

Arvauspeli-konsolisovelluksen rakentaminen

Edessäsi on kaksi polkua. Ensimmäinen vaihtoehto kutsuu sinut aloittamaan matkan ilman apua, kun taas toinen tarjoaa hyödyllisen oppaan onnistumisesi varmistamiseksi. Valitsitpa rohkean hyppäyksen tai rakenteellisen ohjeen seuraamisen, edessäsi on kiehtova kokemus, jonka lopputuloksena on toimiva ja mukaansatempaava konsolisovellus.

Pääsuunnitelma

• Vaihe 1: Alustus ja valmistelut;
• Vaihe 2: Pelin parametrien määrittely;
• Vaihe 3: Apufunktioiden määrittely;
• Vaihe 4: Pelilogiikka;
• Vaihe 5: Pelituloksen tallennus;
• Vaihe 6: Pelin käynnistys;
• Yhteenveto;
• Koko sovelluksen koodi.

Vaihe 1: Alustus ja valmistelut

Valmistele pohja luomalla uusi hakemisto ja tiedosto nimeltä app.js. Tässä tiedostossa otetaan käyttöön tarvittavat moduulit:

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

Luo Readline-rajapinta:

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

Selitys: Tuodaan tarvittavat moduulit: readline käyttäjän kanssa vuorovaikutukseen ja fs.promises tiedostojen käsittelyyn. Luodaan Readline-rajapinta nimeltä rl syötteen ja tulosteen hallintaan.

Vaihe 2: Pelin parametrien määrittely

Aseta pienin ja suurin numero:

const minNumber = 1;
const maxNumber = 100;

Salaisen numeron generointi:

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

Yritysten laskurin alustaminen:

let attempts = 0;

Selitys: Määritellään lukujen vaihteluväli (minNumber ja maxNumber), jonka sisällä salainen numero arvotaan. Salainen numero luodaan satunnaisesti käyttäen Math.random()-funktiota ja tallennetaan muuttujaan secretNumber. Muuttuja attempts alustetaan käyttäjän yritysten seuraamiseksi.

Vaihe 3: Apufunktioiden määrittely

Varustaudu apufunktiolla virheettömään validointiin:

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

Selitys: isValidGuess-funktio tarkistaa, onko käyttäjän arvaus kelvollinen numero määritellyllä välillä (minNumber–maxNumber).

Vaihe 4: Pelilogiikka

Pelin ydintoiminnallisuus playGame-funktion kautta:

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

Selitys: playGame-funktio muodostaa pelin ydinsilmukan. Se käyttää rl.question-metodia pyytääkseen käyttäjältä arvausta. Jos arvaus on kelvollinen, funktio tarkistaa, vastaako arvaus salaisuusnumeroa. Muussa tapauksessa se antaa palautetta käyttäjälle ja jatkaa pelisilmukkaa rekursiivisesti.

Vaihe 5: Pelituloksen tallentaminen

Toteuta logiikka, jolla käyttäjän pelisaavutukset tallennetaan tiedostoon 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.');
  }
}

Selitys: saveGameResult-funktio käyttää fs.promises-kirjastoa lisätäkseen pelituloksen tiedostoon nimeltä game_results.txt. Funktio antaa palautetta siitä, onnistuiko tuloksen tallennus vai ei.

Vaihe 6: Pelin käynnistäminen

Luo tervetuloviesti ja käynnistä peli:

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

Selitys: Näytetään tervetuloviesti ja käynnistetään pelisilmukka kutsumalla playGame-funktiota.

Sovelluksen koko koodi

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