誤った変更 イベントの時刻を、clock ではなく new Date() から作る 未確認 入力 clock が 06:30 を返すとき 本来 clock の時刻が入る "…T06:30:00.000Z"この変更では 実行した日時が入る イベントIDを、ID generator ではなく乱数から作る 未確認 入力 ID generator が固定の ID を返すとき 本来 固定の ID が入る "55555555-…"この変更では 毎回違う ID が入る イベントの時刻を、Date. now() から作る 未確認 入力 clock が 06:30 を返すとき 本来 clock の時刻が入る "…T06:30:00.000Z"この変更では 実行した日時が入る 状態の保存と監査記録の保存で、store を2回呼ぶ 未確認 入力 来院済みの予約で診察を開始する 本来 store を1回呼ぶ storeCalls: 1この変更では store を2回呼ぶ storeCalls: 2 解答の例を見る 解答の例 閉じる
eslint.config.mjs コピーする 「イベントの時刻を、clock ではなく new Date() から作る」、「イベントIDを、ID generator ではなく乱数から作る」、「イベントの時刻を、Date.now() から作る」、「予約が見つからない分岐の中で、new Date() を呼ぶ」(任意)を検出します。
import tseslint from "typescript-eslint" ;
const rules = {
"no-restricted-syntax" : [
"error" ,
{
selector: "NewExpression[callee.name='Date'][arguments.length=0]" ,
message: "現在時刻を直接読まず、clock から受け取ります。" ,
},
{
selector: "CallExpression[callee.object.name='crypto'][callee.property.name='randomUUID']" ,
message: "ID を直接作らず、ID generator から受け取ります。" ,
},
{
selector: "CallExpression[callee.object.name='Date'][callee.property.name='now']" ,
message: "現在時刻を直接読まず、clock から受け取ります。" ,
},
],
};
export default [
{
files: [ "exercises/guard/cases/**/*.ts" ],
languageOptions: {
parser: tseslint.parser,
parserOptions: { projectService: true , tsconfigRootDir: process. cwd () },
},
plugins: { "@typescript-eslint" : tseslint.plugin },
rules,
},
];
exercises/guard/mine/useCase.test.ts コピーする 「イベントの時刻を、clock ではなく new Date() から作る」、「イベントIDを、ID generator ではなく乱数から作る」、「イベントの時刻を、Date.now() から作る」、「状態の保存と監査記録の保存で、store を2回呼ぶ」、「イベントの時刻を、診察開始の時刻とは別に clock から読み直す」(任意)、「store の結果を待たず、競合しても呼び出し側に Err が返らない」(任意)を検出します。
import { errAsync, okAsync } from "neverthrow" ;
import { describe, expect, it } from "vitest" ;
import { EventId } from "../../../src/domain/aggregate/eventId.js" ;
import type { CheckedIn, ExaminationStarted } from "../../../src/domain/appointment/index.js" ;
import { AppointmentId, VeterinarianId } from "../../../src/domain/appointment/index.js" ;
import { OwnerId } from "../../../src/domain/owner/index.js" ;
import { PetId } from "../../../src/domain/pet/index.js" ;
import type { EffectsDependencies } from "../../../src/useCase/dependencies.js" ;
import { startExaminationWithEffects } from "../subjects/useCase.js" ;
const FIXED_EVENT_ID = EventId. parse ( "55555555-5555-4555-8555-555555555555" );
const FIXED_OCCURRED_AT = "2026-08-30T06:30:00.000Z" ;
const appointmentId = AppointmentId. parse ( "11111111-1111-4111-8111-111111111111" );
const veterinarianId = VeterinarianId. parse ( "44444444-4444-4444-8444-444444444444" );
const checkedIn = {
kind: "CheckedIn" ,
appointmentId,
petId: PetId. parse ( "22222222-2222-4222-8222-222222222222" ),
ownerId: OwnerId. parse ( "33333333-3333-4333-8333-333333333333" ),
scheduledAt: "2026-08-30T06:30:00.000Z" ,
reason: "skin check" ,
checkedInAt: "2026-08-30T06:20:00.000Z" ,
} as const satisfies CheckedIn ;
const input = { appointmentId, veterinarianId } as const ;
const createHarness = ( options : Readonly <{ conflict ?: boolean ; ticking ?: boolean }> = {}) => {
const recordedEvents : Array < ExaminationStarted > = [];
let storeCalls = 0 ;
let clockReads = 0 ;
const dependencies : EffectsDependencies = {
resolver: { resolveById : () => checkedIn },
clock: {
now : () => {
clockReads += 1 ;
return options.ticking === true ? `2026-08-30T06:30:0${ clockReads }.000Z` : FIXED_OCCURRED_AT ;
},
},
eventIdGenerator: { generate : () => FIXED_EVENT_ID },
examinationStartedStore: {
store : ( event ) => {
storeCalls += 1 ;
if (options.conflict === true ) {
return errAsync ({ kind: "AppointmentConflict" , appointmentId });
}
recordedEvents. push (event);
return okAsync ( undefined );
},
},
};
return {
dependencies,
recordedEvents,
get storeCalls () {
return storeCalls;
},
get clockReads () {
return clockReads;
},
};
};
describe ( "startExaminationWithEffects" , () => {
it ( "固定の clock と ID generator から、同じイベントが決まる" , async () => {
const harness = createHarness ();
await startExaminationWithEffects (harness.dependencies)(input);
expect (harness.recordedEvents. map (({ eventId , occurredAt }) => ({ eventId, occurredAt }))). toEqual ([
{ eventId: FIXED_EVENT_ID , occurredAt: FIXED_OCCURRED_AT },
]);
});
it ( "状態と監査記録のために、store を1回だけ呼ぶ" , async () => {
const harness = createHarness ();
await startExaminationWithEffects (harness.dependencies)(input);
expect (harness.storeCalls). toBe ( 1 );
});
it ( "clock を1回だけ読み、イベントの時刻と診察開始の時刻が一致する" , async () => {
const harness = createHarness ({ ticking: true });
const result = await startExaminationWithEffects (harness.dependencies)(input);
expect (harness.clockReads). toBe ( 1 );
expect (harness.recordedEvents[ 0 ]?.occurredAt). toBe (harness.recordedEvents[ 0 ]?.aggregateState.examinationStartedAt);
expect (result. isOk () ? result.value.examinationStartedAt : undefined ). toBe (harness.recordedEvents[ 0 ]?.occurredAt);
});
it ( "store が競合を返したら、呼び出し側に Err が返る" , async () => {
const harness = createHarness ({ conflict: true });
const result = await startExaminationWithEffects (harness.dependencies)(input);
expect (result. isErr () ? result.error : undefined ). toEqual ({ kind: "AppointmentConflict" , appointmentId });
});
});
eslint.config.mjs useCase.test.ts eslint.config.mjs ファイル一覧 ▾
eslint.config.mjs import 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, }, ];
選択中のファイルをリセット
ターミナルを開く
コマンドはブラウザ内の隔離環境で実行され、ローカルPCのファイルにはアクセスしません。
ターミナルを起動 検出を検証する
正しいコードは、「clock と ID generator から作り、1回だけ保存する正しい診察開始」と「clock が返した時刻から Date を作る正しい診察開始」です。検出すると誤検知になるため、検出してはいけません。必須の誤った変更4件がすべて「検出」で、正しいコード2件がすべて「誤検知なし」にな ると合格です。
手元のエディタで解く ブラウザの代わりに、手元のエディタで同じ演習を解くこともできます。編集するファイルと合否の判定は、ブラウザの演習と同じです。ブラウザで書いた内容は、手元のファイルに引き継がれません。
必要なツール 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 演習を解く エディタで、cloneした fp-with-ts-hands-on フォルダを開きます。
次のファイルを編集します。examples/session-06-solution/exercises/guard/cases/ の誤った変更は編集しません。
examples/session-06-solution/eslint.config.mjs examples/session-06-solution/exercises/guard/mine/ の中のファイル fp-with-ts-hands-on フォルダで次のコマンドを実行します。このコマンドは、ブラウザの「検出を検証する」と同じ判定を実行し、結果をターミナルに表示します。
pnpm guard:06 解答の例は、このページの演習の「解答の例を見る」で確認できます。examples/session-06-solution/exercises/guard/answer/ にも解答の例があります。ただし、このフォルダのファイルは import のパスが mine/ のファイルと異なるため、mine/ にそのまま複写しても合格しません。解答の例を使うときは、「解答の例を見る」の内容を複写します。
判定の結果の読み方 先頭の「結果:」の行が合否を示します。「合格です」と表示されれば合格です。 誤った変更の行に「[検出]」と表示されれば、その変更を検出できています。「[未検出]」は、まだ検出できていないことを示します。 正しいコードの行には「[誤検知なし]」と表示されるのが正しい状態です。「[誤検知あり]」は、追加した検出の仕組みが正しいコードまで失敗として扱っていることを示します。 「[未判定]」は、実行のエラーで判定できなかったことを示します。「問題」の節に原因が表示されます。 各行の下の「型のテスト / Linter / テスト」は、検出の仕組みごとの結果です。「検出 N件」は検出した件数、「−」は検出なし、「対象外」はその行の合否に数えない仕組み、「エラー」は実行の失敗を示します。 「次にすること」の節は、次に取り組む作業を示します。 合格するまでは、最後に ELIFECYCLE Command failed with exit code 1. と表示されます。この表示は不合格を示すもので、コマンドの不具合ではありません。 最初からやり直す 次のコマンドで、この演習のファイルへの編集を元に戻します。このコマンドは、自分で新しく作ったファイルを削除しません。
git restore examples/session-06-solution