[자동차 경주] 주유나 미션 제출합니다.

README.md

@@ -1 +1,62 @@
 # javascript-racingcar-precourse
+
+# 🏎️ 자동차 경주
+
+## 📋 구현 기능 목록
+
+---
+
+### 1️⃣ 입출력 기본 프롬프트
+
+- [x] `Console.print("경주할 자동차 이름을 입력하세요.(이름은 쉼표(,) 기준으로 구분)")`
+- [x] `Console.readLineAsync("")`로 자동차 이름 입력
+- [x] `Console.print("시도할 횟수는 몇 회인가요?")`
+- [x] `Console.readLineAsync("")`로 시도 횟수 입력
+
+---
+
+### 2️⃣ 입력 파싱 & 검증 — 자동차 이름
+
+- [x] 쉼표 기준 분리, 각 이름 `trim()`
+- [x] 빈 이름 금지, 전체 목록 빈 배열 금지
+- [x] 각 이름 길이 1~5자 제한 (초과 시 에러)
+- [x] 오류 시 `[ERROR]`로 시작하는 메시지와 함께 `Error` throw
+
+---
+
+### 3️⃣ 입력 파싱 & 검증 — 시도 횟수
+
+- [x] 정수 문자열인지 확인
+- [x] 양의 정수(>0)만 허용
+- [x] 오류 시 `[ERROR]` 메시지와 함께 `Error` throw
+
+---
+
+### 4️⃣ 진행 규칙 구현
+
+- [x] 라운드마다 각 자동차에 대해 `Random.pickNumberInRange(0, 9)`
+- [x] 4 이상이면 전진, 미만이면 정지
+- [x] 각 라운드 종료 후 `이름 : -...` 형식으로 상태 출력(진행도만큼 `-`)
+
+---
+
+### 5️⃣ 실행 결과 출력 형식
+
+- [x] 입력 후 `\n실행 결과` 출력
+- [x] 라운드 사이 빈 줄 출력(예시와 동일)
+- [x] 모든 라운드 종료 후 우승자(복수 가능) 출력
+
+---
+
+### 6️⃣ 예외 처리와 종료 흐름
+
+- [x] `run()`에서 모든 예외 `try/catch`
+- [x] `[ERROR]`로 시작하는 메시지를 Console.print로 출력
+- [x] rethrow하여 테스트의 `rejects.toThrow`를 만족
+- [x] `process.exit()` 금지
+
+### 7️⃣ 구조화/모듈화 & 스타일
+
+- [x] I/O(`App.js`) ↔ 비즈니스 로직(`RacingGame.js`) 분리
+- [x] 들여쓰기(depth) 2 이내, 3항 연산자 사용 금지
+- [x] 함수는 한 가지 일만 하도록 분리

__tests__/ApplicationTest.js

@@ -57,4 +57,59 @@ describe("자동차 경주", () => {
     // then
     await expect(app.run()).rejects.toThrow("[ERROR]");
   });
+
+  // 파라미터화 테스트 추가
+  describe.each([
+    ["", "[ERROR] 자동차 이름이 비어 있습니다."],
+    ["pobi,javaji", "[ERROR] 자동차 이름은 5자 이하여야 합니다."],
+    ["pobi, ", "[ERROR] 빈 이름은 허용되지 않습니다."],
+    ["  ,woni", "[ERROR] 빈 이름은 허용되지 않습니다."],
+  ])("이름 검증 - 입력: %s", (nameLine, errorMsg) => {
+    test("run()는 [ERROR]로 reject 되어야 한다", async () => {
+      mockQuestions([nameLine]);
+      const app = new App();
+      await expect(app.run()).rejects.toThrow(errorMsg);
+    });
+  });
+
+  describe.each([
+    ["pobi,woni", "0", "[ERROR] 시도 횟수는 1 이상이어야 합니다."],
+    ["pobi,woni", "-1", "[ERROR] 시도 횟수는 1 이상이어야 합니다."],
+    ["pobi,woni", "abc", "[ERROR] 시도 횟수는 숫자여야 합니다."],
+    ["pobi,woni", "  ", "[ERROR] 시도 횟수는 숫자여야 합니다."],
+  ])("시도 횟수 검증 - 입력: %s / %s", (nameLine, attemptLine, errorMsg) => {
+    test("run()는 [ERROR]로 reject 되어야 한다", async () => {
+      mockQuestions([nameLine, attemptLine]);
+      const app = new App();
+      await expect(app.run()).rejects.toThrow(errorMsg);
+    });
+  });
+
+  describe.each([
+    [
+      [4, 3],
+      ["pobi : -", "woni : ", "최종 우승자 : pobi"],
+    ],
+    [
+      [3, 4],
+      ["pobi : ", "woni : -", "최종 우승자 : woni"],
+    ],
+    [
+      [4, 4],
+      ["pobi : -", "woni : -", "최종 우승자 : pobi, woni"],
+    ],
+  ])("한 라운드 시뮬레이션 - 랜덤: %j", (randoms, expectedLogs) => {
+    test("보드/우승자 출력이 형식에 맞아야 합니다.", async () => {
+      const logSpy = getLogSpy();
+      mockQuestions(["pobi,woni", "1"]);
+      mockRandoms(randoms);
+
+      const app = new App();
+      await app.run();
+
+      expectedLogs.forEach((log) => {
+        expect(logSpy).toHaveBeenCalledWith(expect.stringContaining(log));
+      });
+    });
+  });
 });

src/App.js

@@ -1,5 +1,46 @@
+import { Console } from "@woowacourse/mission-utils";
+import { RacingGame } from "./RacingGame.js";
+import { ERROR, PROMPT } from "./constants/messages.js";
+
 class App {
-  async run() {}
+  async run() {
+    Console.print(PROMPT.ASK_NAMES);
+    try {
+      const nameLine = await Console.readLineAsync("");
+      Console.print(PROMPT.ASK_ATTEMPTS);
+      const attemptLine = await Console.readLineAsync("");
+
+      const game = new RacingGame(nameLine, attemptLine);
+      const result = game.playAllRounds();
+
+      this.#printExecutionHeader();
+      this.#printBoards(result.boards);
+      this.#printWinners(result.winners);
+    } catch (error) {
+      const message = error?.message ?? ERROR.UNKNOWN;
+      Console.print(message);
+      throw error;
+    }
+  }
+
+  #printExecutionHeader() {
+    Console.print("");
+    Console.print(PROMPT.EXEC_HEADER);
+  }
+
+  #printBoards(boards) {
+    for (const board of boards) {
+      for (const line of board) {
+        Console.print(line);
+      }
+      Console.print("");
+    }
+  }
+
+  #printWinners(winners) {
+    const line = `최종 우승자 : ${winners.join(", ")}`;
+    Console.print(line);
+  }
 }
 
 export default App;

src/RacingGame.js

@@ -0,0 +1,95 @@
+import { Random } from "@woowacourse/mission-utils";
+import { ERROR } from "./constants/messages";
+
+const MOVE_THRESHOLD = 4;
+const RANDOM_MIN = 0;
+const RANDOM_MAX = 9;
+
+export class RacingGame {
+  #cars;
+  #attempts;
+
+  constructor(nameLine, attemptLine) {
+    const names = this.#parseNames(nameLine);
+    const attempts = this.#parseAttempts(attemptLine);
+    this.#cars = names.map((name) => ({ name, position: 0 }));
+    this.#attempts = attempts;
+  }
+
+  playAllRounds() {
+    const boards = [];
+    for (let round = 0; round < this.#attempts; round += 1) {
+      this.#playOneRound();
+      boards.push(this.#formatBoard());
+    }
+    const winners = this.#determineWinners();
+    return { boards, winners };
+  }
+
+  #playOneRound() {
+    for (const car of this.#cars) {
+      const randomValue = Random.pickNumberInRange(RANDOM_MIN, RANDOM_MAX);
+      if (randomValue >= MOVE_THRESHOLD) {
+        car.position += 1;
+      }
+    }
+  }
+
+  #formatBoard() {
+    const lines = [];
+    for (const car of this.#cars) {
+      const hyphens = "-".repeat(car.position);
+      lines.push(`${car.name} : ${hyphens}`);
+    }
+    return lines;
+  }
+
+  #determineWinners() {
+    const max = this.#cars.reduce((maxDistance, car) => {
+      if (car.position > maxDistance) return car.position;
+      return maxDistance;
+    }, 0);
+    const names = [];
+    for (const car of this.#cars) {
+      if (car.position === max) {
+        names.push(car.name);
+      }
+    }
+    return names;
+  }
+
+  #parseNames(nameLine) {
+    const raw = (nameLine ?? "").trim();
+    if (raw === "") {
+      throw new Error(ERROR.EMPTY_NAMES);
+    }
+
+    const nameTokens = raw.split(",").map((s) => s.trim());
+
+    for (const nameToken of nameTokens) {
+      if (nameToken === "") {
+        throw new Error(ERROR.EMPTY_NAME_TOKEN);
+      }
+      if (nameToken.length > 5) {
+        throw new Error(ERROR.NAME_TOO_LONG);
+      }
+    }
+
+    return nameTokens;
+  }
+
+  #parseAttempts(attemptLine) {
+    const raw = (attemptLine ?? "").trim();
+
+    if (!/^-?\d+$/.test(raw)) {
+      throw new Error(ERROR.ATTEMPTS_NAN);
+    }
+
+    const randomValue = Number(raw);
+
+    if (!Number.isSafeInteger(randomValue) || randomValue <= 0) {
+      throw new Error(ERROR.ATTEMPTS_POSITIVE);
+    }
+    return randomValue;
+  }
+}

src/constants/messages.js

@@ -0,0 +1,13 @@
+export const PROMPT = {
+  ASK_NAMES: "경주할 자동차 이름을 입력하세요.(이름은 쉼표(,) 기준으로 구분)",
+  ASK_ATTEMPTS: "시도할 횟수는 몇 회인가요?",
+  EXEC_HEADER: "실행 결과",
+};
+export const ERROR = {
+  EMPTY_NAMES: "[ERROR] 자동차 이름이 비어 있습니다.",
+  EMPTY_NAME_TOKEN: "[ERROR] 빈 이름은 허용되지 않습니다.",
+  NAME_TOO_LONG: "[ERROR] 자동차 이름은 5자 이하여야 합니다.",
+  ATTEMPTS_NAN: "[ERROR] 시도 횟수는 숫자여야 합니다.",
+  ATTEMPTS_POSITIVE: "[ERROR] 시도 횟수는 1 이상이어야 합니다.",
+  UNKNOWN: "[ERROR] 알 수 없는 오류가 발생했습니다.",
+};

types/woowacourse__mission-utils.d.ts

@@ -0,0 +1,6 @@
+declare module "@woowacourse/mission-utils" {
+  export const Console: {
+    readLineAsync(prompt?: string): Promise<string>;
+    print(message: string): void;
+  };
+}