ホーム 全セッション S05

演習: 工程と依存の向きを守る仕組みの選択

13 / 14 目安 6分

ページ一覧

解決策: 工程の条件と依存の向きを守る仕組みを選択し、誤った変更を検出します。

eslint.config.mjsimport tseslint from "typescript-eslint";const rules = {};export default [  {    files: ["exercises/guard/cases/**/*.ts"],    languageOptions: {      parser: tseslint.parser,      parserOptions: { projectService: true, tsconfigRootDir: import.meta.dirname },    },    plugins: { "@typescript-eslint": tseslint.plugin },    rules,  },];

必須の誤った変更3件がすべて「検出」で、正しいコード4件がすべて「誤検知なし」になると合格です。

この演習の手順

  1. 左の一覧から誤った変更を選び、コードを読みます。必須の3件は、domain が外側の web と sqlite を import する2件(依存の向き)と、会計済みの予約をキャンセルに通す1件(工程の条件)です。
  2. どの仕組みで検出するかは自分で選びます。Linter は eslint.config.mjs の rules にルールを追加します。テストは exercises/guard/mine/ の cancelAppointment.test.ts に実装し、Err になることは expect(result.isErr()).toBe(true) で検証できます。Linter のルールの記述方法は「依存の向きの違反の検出」のページに記載があります。reason.test.ts は、合格後に追加される任意の誤った変更(空の理由)に使います。
  3. 仕組みを追加したら「検出を検証する」を押します。検出された誤った変更は「検出」、検出されない変更は「未検出」と表に表示されます。「対象外」は、この教材の判定で、その誤った変更の検出に数えない仕組みです。「対象外」と表示されない列が、その誤った変更の検出に数える仕組みです。
  4. 合格すると追加の誤った変更が2件増えます。追加の分は任意です。合格したら、表の誤った変更の名前を押して行を開き、「この仕組みで検出できないこと」に1文を記入します。この欄はプログラムでは判定しません。
  5. 答え合わせは、合格の後に「解答の例を見る」の必須3件の検出結果と理由で行います。時間内に進められなくなった場合も、解答の例を開きます。

手元のエディタで解く

ブラウザの代わりに、手元のエディタで同じ演習を解くこともできます。編集するファイルと合否の判定は、ブラウザの演習と同じです。ブラウザで書いた内容は、手元のファイルに引き継がれません。

必要なツール

  • Node.js 20以上
  • pnpm 9.12.0
  • Git

ターミナルで次のコマンドを実行し、版を確認します。

node --version
pnpm --version
git --version

pnpmが無い場合は、次のコマンドでインストールします。

npm install --global pnpm@9.12.0

最初の1回だけ行う準備

ターミナルで次のコマンドを順に実行します。1行目でリポジトリをcloneし、3行目で依存パッケージをインストールします。

git clone https://github.com/iwasa-kosui/fp-with-ts-hands-on.git
cd fp-with-ts-hands-on
pnpm install --frozen-lockfile

ほかのSessionの演習も、同じフォルダで解きます。以前にcloneしたフォルダを使う場合は、そのフォルダで次のコマンドを実行し、最新の状態にします。

git pull
pnpm install --frozen-lockfile

演習を解く

  1. エディタで、cloneした fp-with-ts-hands-on フォルダを開きます。
  2. 次のファイルを編集します。examples/session-05-solution/exercises/guard/cases/ の誤った変更は編集しません。
    • examples/session-05-solution/eslint.config.mjs
    • examples/session-05-solution/exercises/guard/mine/ の中のファイル
  3. fp-with-ts-hands-on フォルダで次のコマンドを実行します。このコマンドは、ブラウザの「検出を検証する」と同じ判定を実行し、結果をターミナルに表示します。
    pnpm guard:05

解答の例は、このページの演習の「解答の例を見る」で確認できます。examples/session-05-solution/exercises/guard/answer/ にも解答の例があります。ただし、このフォルダのファイルは import のパスが mine/ のファイルと異なるため、mine/ にそのまま複写しても合格しません。解答の例を使うときは、「解答の例を見る」の内容を複写します。

判定の結果の読み方

  • 先頭の「結果:」の行が合否を示します。「合格です」と表示されれば合格です。
  • 誤った変更の行に「[検出]」と表示されれば、その変更を検出できています。「[未検出]」は、まだ検出できていないことを示します。
  • 正しいコードの行には「[誤検知なし]」と表示されるのが正しい状態です。「[誤検知あり]」は、追加した検出の仕組みが正しいコードまで失敗として扱っていることを示します。
  • 「[未判定]」は、実行のエラーで判定できなかったことを示します。「問題」の節に原因が表示されます。
  • 各行の下の「型のテスト / Linter / テスト」は、検出の仕組みごとの結果です。「検出 N件」は検出した件数、「−」は検出なし、「対象外」はその行の合否に数えない仕組み、「エラー」は実行の失敗を示します。
  • 「次にすること」の節は、次に取り組む作業を示します。
  • 合格するまでは、最後に ELIFECYCLE Command failed with exit code 1. と表示されます。この表示は不合格を示すもので、コマンドの不具合ではありません。

最初からやり直す

次のコマンドで、この演習のファイルへの編集を元に戻します。このコマンドは、自分で新しく作ったファイルを削除しません。

git restore examples/session-05-solution