解答の例
eslint.config.mjs 「parse が any を受け取り、検査せずに値を取り出す」、「parse が unknown を型アサーションで通す」、「route が parse を通さず、body をそのまま渡す」(任意)を検出します。
import tseslint from "typescript-eslint";
const rules = {
"@typescript-eslint/no-explicit-any": "error",
"@typescript-eslint/consistent-type-assertions": ["error", { assertionStyle: "never" }],
"@typescript-eslint/no-unsafe-assignment": "error",
"@typescript-eslint/no-unsafe-argument": "error",
"@typescript-eslint/no-unsafe-member-access": "error",
"@typescript-eslint/no-unsafe-call": "error",
"@typescript-eslint/no-unsafe-return": "error",
};
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/audit.test.ts 「監査記録に飼い主の連絡先が入る」を検出します。
import fc from "fast-check";
import { describe, expect, it } from "vitest";
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 { toAuditPayload } from "../subjects/audit.js";
const timestamp = fc
.date({ min: new Date("2020-01-01T00:00:00.000Z"), max: new Date("2035-01-01T00:00:00.000Z"), noInvalidDate: true })
.map((date) => date.toISOString());
const inExamination = fc.record({
kind: fc.constant<"InExamination">("InExamination"),
appointmentId: fc.uuid().map((id) => AppointmentId.parse(id)),
petId: fc.uuid().map((id) => PetId.parse(id)),
ownerId: fc.uuid().map((id) => OwnerId.parse(id)),
scheduledAt: timestamp,
reason: fc.string(),
checkedInAt: timestamp,
veterinarianId: fc.uuid().map((id) => VeterinarianId.parse(id)),
examinationStartedAt: timestamp,
});
describe("toAuditPayload", () => {
it("監査記録は3項目だけで、値は予約のものと同じ", () => {
fc.assert(
fc.property(inExamination, (appointment) => {
expect(toAuditPayload(appointment)).toEqual({
appointmentId: appointment.appointmentId,
veterinarianId: appointment.veterinarianId,
examinationStartedAt: appointment.examinationStartedAt,
});
}),
{ numRuns: 50 },
);
});
});
exercises/guard/mine/audit.type-test.ts 「監査記録に飼い主の連絡先が入る」を検出します。
import { toAuditPayload } from "../subjects/audit.js";
type Payload = ReturnType<typeof toAuditPayload>;
type Extra = Exclude<keyof Payload, "appointmentId" | "veterinarianId" | "examinationStartedAt">;
// @ts-expect-error
const extra: Extra = "ownerContact";
export { extra };
exercises/guard/mine/handler.test.ts 「route が parse を通さず、body をそのまま渡す」(任意)を検出します。
import fc from "fast-check";
import { describe, expect, it } from "vitest";
import { handle } from "../subjects/handler.js";
const validAppointment = "11111111-1111-4111-8111-111111111111";
const validVeterinarian = "44444444-4444-4444-8444-444444444444";
const uuidLike = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
const notUuid = fc.string().filter((value) => !uuidLike.test(value));
const call = async (body: unknown) => {
const seen: unknown[] = [];
const context = { req: { json: async () => body } };
await handle(context as never, (input) => {
seen.push(input);
}).catch(() => undefined);
return seen;
};
describe("handle", () => {
it("不正な ID の本文では、診察開始の処理を呼ばない", async () => {
await fc.assert(
fc.asyncProperty(notUuid, async (id) => {
const seen = await call({
appointmentId: id,
veterinarianId: validVeterinarian,
});
return seen.length === 0;
}),
{ numRuns: 30 },
);
});
it("正しい本文では、診察開始の処理を呼ぶ", async () => {
const seen = await call({
appointmentId: validAppointment,
veterinarianId: validVeterinarian,
});
expect(seen).toHaveLength(1);
});
});
exercises/guard/mine/ids.type-test.ts 「予約IDと獣医師IDの型が同じになり、取り違えられる」(任意)を検出します。
import type { AppointmentId, VeterinarianId } from "../../../src/domain/appointment/index.js";
import { StartExaminationInput } from "../subjects/input.js";
declare const input: StartExaminationInput;
// @ts-expect-error
const appointmentId: AppointmentId = input.veterinarianId;
// @ts-expect-error
const veterinarianId: VeterinarianId = input.appointmentId;
export { appointmentId, veterinarianId };
exercises/guard/mine/input.test.ts 「parse が any を受け取り、検査せずに値を取り出す」、「parse が unknown を型アサーションで通す」、「schema が UUID かどうかを検証しない」を検出します。
import fc from "fast-check";
import { describe, expect, it } from "vitest";
import { StartExaminationInput } from "../subjects/input.js";
const validAppointment = "11111111-1111-4111-8111-111111111111";
const validVeterinarian = "44444444-4444-4444-8444-444444444444";
const uuidLike = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
const notUuid = fc.string().filter((value) => !uuidLike.test(value));
describe("StartExaminationInput.parse", () => {
it("任意の値で throw せず、ok か err を返す", () => {
fc.assert(
fc.property(fc.anything(), (raw) => {
const result = StartExaminationInput.parse(raw);
return result.isOk() !== result.isErr();
}),
{ numRuns: 100 },
);
});
it("UUID の ID は ok", () => {
fc.assert(
fc.property(fc.uuid(), fc.uuid(), (appointmentId, veterinarianId) =>
StartExaminationInput.parse({ appointmentId, veterinarianId }).isOk(),
),
{ numRuns: 50 },
);
});
it("UUID でない予約 ID は err", () => {
fc.assert(
fc.property(notUuid, (id) =>
StartExaminationInput.parse({ appointmentId: id, veterinarianId: validVeterinarian }).isErr(),
),
{ numRuns: 50 },
);
});
it("UUID でない獣医師 ID は err", () => {
fc.assert(
fc.property(notUuid, (id) =>
StartExaminationInput.parse({ appointmentId: validAppointment, veterinarianId: id }).isErr(),
),
{ numRuns: 50 },
);
});
it("正しい ID は、渡した値のまま取り出せる", () => {
expect(
StartExaminationInput.parse({
appointmentId: validAppointment,
veterinarianId: validVeterinarian,
})._unsafeUnwrap(),
).toEqual({ appointmentId: validAppointment, veterinarianId: validVeterinarian });
});
});