この章では、コンソールアプリケーションのスキルをさらに高めるために、エキサイティングな数当てゲームアプリの作成に取り組みます。このインタラクティブなゲームでは、プレイヤーがあらかじめ定められた範囲内でランダムに生成された数を直感で当てることに挑戦します。進行の中で、以下の基本的な概念についても学びます。

• ランダムな数値生成
• 入力値の検証
• ユーザーとの対話
• ゲーム結果のファイル保存

チャレンジ

ワクワクと興味を誘うアプリに挑戦してみましょう。プレイヤーは、あらかじめ定められた範囲内で神秘的に選ばれた数を当てることに招待されます。アプリは各推測に対して即座にフィードバックを返し、試行回数も正確に記録します。

この実践的な例を通じて、CLIアプリの構築スキルを磨き、インタラクティブなプログラム作成の技術を身につけましょう。

完成アプリ

実際の動作を確認しましょう。下記のGIFは、これから作成するエキサイティングな数当てゲームアプリの様子を示しています。

推測ゲームコンソールアプリの構築

2つの道が提示されています。1つ目の選択肢は、サポートなしで自ら旅に出ることを促し、2つ目は成功を確実にするための有益なガイドを提供します。大胆に挑戦する場合も、構造化されたガイドに従う場合も、機能的で魅力的なコンソールアプリを作成するという興味深い体験が待っています。

マスタープラン

• ステップ1: セットアップと初期化
• ステップ2: ゲームパラメータの定義
• ステップ3: ユーティリティ関数の定義
• ステップ4: ゲームロジック
• ステップ5: ゲーム結果の保存
• ステップ6: ゲームの開始
• 結論
• アプリ全体のコード

ステップ1: セットアップと初期化

新しいディレクトリと app.js という名前のファイルを作成し、キャンバスを準備します。このファイル内で、必要なモジュールを呼び出します:

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

Readlineインターフェースの作成:

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

説明: 必要なモジュールをインポート：ユーザーとの対話用に readline、ファイル操作用に fs.promises。その後、入出力を処理するための Readline インターフェース rl を作成。

ステップ2: ゲームパラメータの定義

最小値と最大値の設定:

const minNumber = 1;
const maxNumber = 100;

シークレットナンバーの生成：

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

試行回数カウンターの初期化：

let attempts = 0;

説明: 秘密の数字が生成される範囲（minNumber と maxNumber）を定義。秘密の数字は Math.random() を使ってランダムに生成され、secretNumber に代入。attempts 変数はユーザーの試行回数を記録するために初期化。

ステップ3: ユーティリティ関数の定義

正確なバリデーションのためのユーティリティ関数:

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

説明: isValidGuess 関数は、ユーザーの推測が指定された範囲（minNumber から maxNumber）内の有効な数値かどうかを確認する。

ステップ 4: ゲームロジック

ゲームのコアメカニクスは 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();
    }
  });
}

説明: playGame 関数はゲームループの中核を担います。rl.question を使用してユーザーに推測値を入力させます。推測値が有効な場合、この関数は推測値が秘密の数字と一致するかどうかを確認します。一致しない場合は、ユーザーにフィードバックを提供し、再帰的にゲームループを続行します。

ステップ 5: ゲーム結果の保存

ユーザーのゲーム達成結果を 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.');
  }
}

説明: saveGameResult 関数は、fs.promises を使用してゲーム結果を game_results.txt ファイルに追記します。結果の保存が成功したか失敗したかについてフィードバックを提供します。

ステップ 6: ゲームの開始

ウェルカムメッセージを作成し、ゲームを開始します:

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

説明: ウェルカムメッセージを表示し、playGame 関数を呼び出してゲームループを開始します。

完全なアプリコード

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