{"id":18456,"date":"2025-10-23T13:38:27","date_gmt":"2025-10-23T13:38:27","guid":{"rendered":"https:\/\/pokecon.jp\/job\/?p=18456"},"modified":"2025-10-23T13:38:27","modified_gmt":"2025-10-23T13:38:27","slug":"vitest-4%e3%81%ae%e6%96%b0%e6%a9%9f%e8%83%bd-expect-schemamatching-%e3%81%a8hono%e3%81%a8zod%e3%81%a7%e3%82%b9%e3%82%ad%e3%83%bc%e3%83%9e%e9%a7%86%e5%8b%95%e3%81%a7%e3%83%86%e3%82%b9%e3%83%88%e3%82%92","status":"publish","type":"post","link":"https:\/\/pokecon.jp\/job\/18456\/","title":{"rendered":"Vitest 4\u306e\u65b0\u6a5f\u80fd expect.schemaMatching \u3068Hono\u3068Zod\u3067\u30b9\u30ad\u30fc\u30de\u99c6\u52d5\u3067\u30c6\u30b9\u30c8\u3092\u3084\u308b"},"content":{"rendered":"\n<\/p>\n
\n

\n \u306f\u3058\u3081\u306b<\/h2>\n

\u3053\u3093\u306b\u3061\u306f\u3001\u682a\u5f0f\u4f1a\u793e\u30a2\u30b5\u30a4\u30f3\u3067\u30a8\u30f3\u30b8\u30cb\u30a2\u3092\u3057\u3066\u3044\u308b\u3046\u3061\u307b\u308a(@showichiro0123<\/a>)\u3067\u3059\u3002<\/p>\n

2025\u5e7410\u670822\u65e5\u306b\u30ea\u30ea\u30fc\u30b9\u3055\u308c\u305fVitest 4<\/a>\u306b\u306f\u3001\u30c6\u30b9\u30c8\u99c6\u52d5\u958b\u767a\u3084\u30b9\u30ad\u30fc\u30de\u99c6\u52d5\u958b\u767a\u3092\u52a0\u901f\u3055\u305b\u308b\u65b0\u6a5f\u80fd\u304c\u591a\u6570\u8ffd\u52a0\u3055\u308c\u307e\u3057\u305f\u3002\u4e2d\u3067\u3082\u79c1\u306e\u76ee\u3092\u5f15\u3044\u305f\u306e\u306f\u3001Zod\u306a\u3069\u306e\u30b9\u30ad\u30fc\u30de\u30e9\u30a4\u30d6\u30e9\u30ea\u3068\u7d71\u5408\u3067\u304d\u308bexpect.schemaMatching<\/code>\u3067\u3059\u3002<\/p>\n

\u672c\u8a18\u4e8b\u3067\u306f\u3001Vitest 4\u306e\u65b0\u6a5f\u80fd\u3092\u6982\u89b3\u3057\u3064\u3064\u3001expect.schemaMatching<\/code>\u3092\u4f7f\u3063\u305f\u30b9\u30ad\u30fc\u30de\u99c6\u52d5\u30c6\u30b9\u30c8\u306e\u5b9f\u8df5\u65b9\u6cd5\u3092\u3001Hono\u3092\u4f7f\u3063\u305fWeb API\u306e\u958b\u767a\u4f8b\u3092\u4ea4\u3048\u3066\u7d39\u4ecb\u3057\u307e\u3059\u3002<\/p>\n

\n Vitest 4\u306e\u4e3b\u8981\u306a\u65b0\u6a5f\u80fd<\/h2>\n

\u307e\u305a\u3001Vitest 4\u3067\u8ffd\u52a0\u3055\u308c\u305f\u4e3b\u8981\u306a\u65b0\u6a5f\u80fd\u3092\u898b\u3066\u3044\u304d\u307e\u3057\u3087\u3046\u3002<\/p>\n

\n 1. Browser Mode\u306e\u6b63\u5f0f\u7248\u5316<\/h3>\n

\u3053\u308c\u307e\u3067\u5b9f\u9a13\u7684\u6a5f\u80fd\u3060\u3063\u305fBrowser Mode\u304c\u6b63\u5f0f\u7248\u306b\u306a\u308a\u307e\u3057\u305f\u3002Playwright\u3001WebdriverIO\u3001Preview\u3068\u3044\u3063\u305f\u8907\u6570\u306e\u30d7\u30ed\u30d0\u30a4\u30c0\u30fc\u3092\u30b5\u30dd\u30fc\u30c8\u3057\u3001\u5b9f\u969b\u306e\u30d6\u30e9\u30a6\u30b6\u74b0\u5883\u3067\u30c6\u30b9\u30c8\u3092\u5b9f\u884c\u3067\u304d\u307e\u3059\u3002<\/p>\n

\n
vitest --browser.name<\/span>=<\/span>chromium\n<\/code><\/pre>\n<\/div>\n
\n 2. \u30d3\u30b8\u30e5\u30a2\u30eb\u30ea\u30b0\u30ec\u30c3\u30b7\u30e7\u30f3\u30c6\u30b9\u30c8<\/h3>\n
toMatchScreenshot()<\/code>\u3084toBeInViewport()<\/code>\u3068\u3044\u3063\u305f\u65b0\u3057\u3044\u30de\u30c3\u30c1\u30e3\u30fc\u304c\u8ffd\u52a0\u3055\u308c\u3001UI\u306e\u8996\u899a\u7684\u306a\u691c\u8a3c\u304c\u53ef\u80fd\u306b\u306a\u308a\u307e\u3057\u305f\u3002<\/p>\n
\n
await<\/span> expect<\/span>(<\/span>page)<\/span>.<\/span>toMatchScreenshot<\/span>(<\/span>)<\/span>;<\/span>\n<\/code><\/pre>\n<\/div>\n
\n 3. Type-Aware Hooks<\/h3>\n
test.beforeEach()<\/code>\u3084test.afterEach()<\/code>\u304c\u62e1\u5f35\u30b3\u30f3\u30c6\u30ad\u30b9\u30c8\u3092\u30b5\u30dd\u30fc\u30c8\u3057\u3001\u578b\u5b89\u5168\u306a\u30bb\u30c3\u30c8\u30a2\u30c3\u30d7\u30fb\u30af\u30ea\u30fc\u30f3\u30a2\u30c3\u30d7\u304c\u53ef\u80fd\u306b\u306a\u308a\u307e\u3057\u305f\u3002<\/p>\n
\n 4. \u65b0\u3057\u3044\u30de\u30c3\u30c1\u30e3\u30fc<\/h3>\n
    \n
  • \nexpect.assert()<\/code>: Chai\u306eassert API\u3092expect\u30aa\u30d6\u30b8\u30a7\u30af\u30c8\u3067\u4f7f\u7528\u53ef\u80fd\u306b<\/li>\n
  • \nexpect.schemaMatching()<\/code>: Standard Schema v1\u6e96\u62e0\u306e\u30b9\u30ad\u30fc\u30de\u30e9\u30a4\u30d6\u30e9\u30ea(Zod\u3001Valibot\u3001ArkType)\u306b\u3088\u308b\u691c\u8a3c<\/li>\n<\/ul>\n
    \u4eca\u56de\u306e\u8a18\u4e8b\u3067\u306f\u3001\u3053\u306eexpect.schemaMatching()<\/code>\u306b\u7126\u70b9\u3092\u5f53\u3066\u307e\u3059\u3002<\/p>\n
    \n expect.schemaMatching \u3068\u306f<\/h2>\n
    expect.schemaMatching()<\/code>\u306f\u3001Standard Schema v1\u30aa\u30d6\u30b8\u30a7\u30af\u30c8\u3092\u53d7\u3051\u5165\u308c\u3001\u30b9\u30ad\u30fc\u30de\u306b\u5bfe\u3057\u3066\u5024\u3092\u691c\u8a3c\u3059\u308b\u975e\u5bfe\u79f0\u30de\u30c3\u30c1\u30e3\u30fc\u3067\u3059\u3002
    \u975e\u5bfe\u79f0\u30de\u30c3\u30c1\u30e3\u30fc\u3068\u306f\u3001\u30c6\u30b9\u30c8\u306e\u671f\u5f85\u5024\u5074\u3067\u4f7f\u7528\u3067\u304d\u308b\u7279\u6b8a\u306a\u30de\u30c3\u30c1\u30e3\u30fc\u3067\u3001\u5b9f\u969b\u306e\u5024\u3068\u671f\u5f85\u5024\u3092\u67d4\u8edf\u306b\u6bd4\u8f03\u3067\u304d\u307e\u3059\u3002\u4f8b\u3048\u3070expect.any(String)<\/code>\u3084expect.objectContaining()<\/code>\u306a\u3069\u304c\u975e\u5bfe\u79f0\u30de\u30c3\u30c1\u30e3\u30fc\u306e\u4f8b\u3067\u3059\u3002<\/p>\n
    \n \u30b5\u30dd\u30fc\u30c8\u3059\u308b\u30b9\u30ad\u30fc\u30de\u30e9\u30a4\u30d6\u30e9\u30ea<\/h3>\n
    \u5177\u4f53\u7684\u306b\u306f\u4ee5\u4e0b\u306e\u3088\u3046\u306a\u30d0\u30ea\u30c7\u30fc\u30b7\u30e7\u30f3\u30e9\u30a4\u30d6\u30e9\u30ea\u3092\u5229\u7528\u3059\u308b\u3053\u3068\u304c\u3067\u304d\u307e\u3059\u3002<\/p>\n
      \n
    • Zod: z.string().email()<\/code>\n<\/li>\n
    • Valibot: v.pipe(v.string(), v.email())<\/code>\n<\/li>\n
    • ArkType: type('string.email')<\/code>\n<\/li>\n<\/ul>\n
      \n expect.schemaMatching\u3068\u4e00\u7dd2\u306b\u4f7f\u7528\u3067\u304d\u308b\u30de\u30c3\u30c1\u30e3\u30fc<\/h3>\n
      \u524d\u8ff0\u306e\u901a\u308a\u3001expect.schemaMatching<\/code>\u306f\u975e\u5bfe\u79f0\u30de\u30c3\u30c1\u30e3\u30fc\u306a\u306e\u3067\u3001\u4ee5\u4e0b\u306e\u3088\u3046\u306a\u7b49\u4fa1\u6027\u30c1\u30a7\u30c3\u30af\u30de\u30c3\u30c1\u30e3\u30fc\u3068\u7d44\u307f\u5408\u308f\u305b\u3066\u4f7f\u7528\u3067\u304d\u307e\u3059\u3002<\/p>\n
        \n
      • toEqual<\/code><\/li>\n
      • toStrictEqual<\/code><\/li>\n
      • toMatchObject<\/code><\/li>\n
      • toContainEqual<\/code><\/li>\n
      • toHaveBeenCalledWith<\/code><\/li>\n<\/ul>\n
        \u3053\u308c\u306b\u3088\u308a\u3001\u30aa\u30d6\u30b8\u30a7\u30af\u30c8\u306e\u4e00\u90e8\u5206\u3060\u3051\u3092\u30b9\u30ad\u30fc\u30de\u691c\u8a3c\u3057\u305f\u308a\u3001\u95a2\u6570\u306e\u5f15\u6570\u304c\u30b9\u30ad\u30fc\u30de\u306b\u6e96\u62e0\u3057\u3066\u3044\u308b\u304b\u3092\u691c\u8a3c\u3057\u305f\u308a\u3067\u304d\u307e\u3059\u3002<\/p>\n
        \n \u5b9f\u8df5: Hono\u3067\u30b9\u30ad\u30fc\u30de\u99c6\u52d5\u30c6\u30b9\u30c8\u3092\u66f8\u304f<\/h2>\n
        \u3053\u3053\u304b\u3089\u306f\u3001\u5b9f\u969b\u306bHono + Zod + Vitest 4\u3092\u4f7f\u3063\u305f\u5177\u4f53\u4f8b\u3092\u898b\u3066\u3044\u304d\u307e\u3059\u3002<\/p>\n
        \n \u30d7\u30ed\u30b8\u30a7\u30af\u30c8\u306e\u30bb\u30c3\u30c8\u30a2\u30c3\u30d7<\/h3>\n
        \u307e\u305a\u3001\u5fc5\u8981\u306a\u30d1\u30c3\u30b1\u30fc\u30b8\u3092\u30a4\u30f3\u30b9\u30c8\u30fc\u30eb\u3057\u307e\u3059\u3002<\/p>\n
        \n
        {<\/span>\n  \"dependencies\"<\/span>:<\/span> {<\/span>\n    \"@hono\/swagger-ui\"<\/span>:<\/span> \"^0.5.2\"<\/span>,<\/span>\n    \"@hono\/zod-openapi\"<\/span>:<\/span> \"^1.1.4\"<\/span>,<\/span>\n    \"hono\"<\/span>:<\/span> \"^4.10.2\"<\/span>\n  }<\/span>,<\/span>\n  \"devDependencies\"<\/span>:<\/span> {<\/span>\n    \"vitest\"<\/span>:<\/span> \"^4.0.1\"<\/span>,<\/span>\n    \"zod\"<\/span>:<\/span> \"^4.1.12\"<\/span>\n  }<\/span>\n}<\/span>\n<\/code><\/pre>\n<\/div>\n
        \n 1. Zod\u30b9\u30ad\u30fc\u30de\u306e\u5b9a\u7fa9<\/h3>\n
        \u307e\u305a\u3001API\u3067\u6271\u3046\u30c7\u30fc\u30bf\u306e\u30b9\u30ad\u30fc\u30de\u3092Zod\u3067\u5b9a\u7fa9\u3057\u307e\u3059\u3002<\/p>\n
        \n
        src\/schemas\/user.ts<\/span><\/p>\n
        import<\/span> {<\/span> z }<\/span> from<\/span> '@hono\/zod-openapi'<\/span>\n\n\nexport<\/span> const<\/span> UserSchema =<\/span> z.<\/span>object<\/span>(<\/span>{<\/span>\n  id:<\/span> z.<\/span>string<\/span>(<\/span>)<\/span>.<\/span>openapi<\/span>(<\/span>{<\/span>\n    example:<\/span> '123'<\/span>,<\/span>\n    description:<\/span> '\u30e6\u30fc\u30b6\u30fcID'<\/span>,<\/span>\n  }<\/span>)<\/span>,<\/span>\n  name:<\/span> z.<\/span>string<\/span>(<\/span>)<\/span>.<\/span>min<\/span>(<\/span>1<\/span>)<\/span>.<\/span>max<\/span>(<\/span>100<\/span>)<\/span>.<\/span>openapi<\/span>(<\/span>{<\/span>\n    example:<\/span> '\u5c71\u7530\u592a\u90ce'<\/span>,<\/span>\n    description:<\/span> '\u30e6\u30fc\u30b6\u30fc\u540d'<\/span>,<\/span>\n  }<\/span>)<\/span>,<\/span>\n  email:<\/span> z.<\/span>string<\/span>(<\/span>)<\/span>.<\/span>email<\/span>(<\/span>)<\/span>.<\/span>openapi<\/span>(<\/span>{<\/span>\n    example:<\/span> 'yamada@example.com'<\/span>,<\/span>\n    description:<\/span> '\u30e1\u30fc\u30eb\u30a2\u30c9\u30ec\u30b9'<\/span>,<\/span>\n  }<\/span>)<\/span>,<\/span>\n  age:<\/span> z.<\/span>number<\/span>(<\/span>)<\/span>.<\/span>int<\/span>(<\/span>)<\/span>.<\/span>min<\/span>(<\/span>0<\/span>)<\/span>.<\/span>max<\/span>(<\/span>150<\/span>)<\/span>.<\/span>optional<\/span>(<\/span>)<\/span>.<\/span>openapi<\/span>(<\/span>{<\/span>\n    example:<\/span> 25<\/span>,<\/span>\n    description:<\/span> '\u5e74\u9f62'<\/span>,<\/span>\n  }<\/span>)<\/span>,<\/span>\n  createdAt:<\/span> z.<\/span>string<\/span>(<\/span>)<\/span>.<\/span>datetime<\/span>(<\/span>)<\/span>.<\/span>openapi<\/span>(<\/span>{<\/span>\n    example:<\/span> '2025-01-01T00:00:00Z'<\/span>,<\/span>\n    description:<\/span> '\u4f5c\u6210\u65e5\u6642'<\/span>,<\/span>\n  }<\/span>)<\/span>,<\/span>\n}<\/span>)<\/span>\n\n\nexport<\/span> const<\/span> CreateUserRequestSchema =<\/span> z.<\/span>object<\/span>(<\/span>{<\/span>\n  name:<\/span> z.<\/span>string<\/span>(<\/span>)<\/span>.<\/span>min<\/span>(<\/span>1<\/span>)<\/span>.<\/span>max<\/span>(<\/span>100<\/span>)<\/span>,<\/span>\n  email:<\/span> z.<\/span>string<\/span>(<\/span>)<\/span>.<\/span>email<\/span>(<\/span>)<\/span>,<\/span>\n  age:<\/span> z.<\/span>number<\/span>(<\/span>)<\/span>.<\/span>int<\/span>(<\/span>)<\/span>.<\/span>min<\/span>(<\/span>0<\/span>)<\/span>.<\/span>max<\/span>(<\/span>150<\/span>)<\/span>.<\/span>optional<\/span>(<\/span>)<\/span>,<\/span>\n}<\/span>)<\/span>\n\n\nexport<\/span> const<\/span> UsersListResponseSchema =<\/span> z.<\/span>object<\/span>(<\/span>{<\/span>\n  users:<\/span> z.<\/span>array<\/span>(<\/span>UserSchema)<\/span>,<\/span>\n  total:<\/span> z.<\/span>number<\/span>(<\/span>)<\/span>.<\/span>int<\/span>(<\/span>)<\/span>,<\/span>\n}<\/span>)<\/span>\n\n\nexport<\/span> const<\/span> ErrorResponseSchema =<\/span> z.<\/span>object<\/span>(<\/span>{<\/span>\n  error:<\/span> z.<\/span>string<\/span>(<\/span>)<\/span>,<\/span>\n  message:<\/span> z.<\/span>string<\/span>(<\/span>)<\/span>.<\/span>optional<\/span>(<\/span>)<\/span>,<\/span>\n}<\/span>)<\/span>\n\n\nexport<\/span> type<\/span> User<\/span> =<\/span> z.<\/span>infertypeof<\/span> UserSchema><\/span>\nexport<\/span> type<\/span> CreateUserRequest<\/span> =<\/span> z.<\/span>infertypeof<\/span> CreateUserRequestSchema><\/span>\n<\/span><\/span><\/code><\/pre>\n<\/div>\n
        \n 2. API\u30eb\u30fc\u30c8\u306e\u5b9a\u7fa9<\/h3>\n
        \u6b21\u306b\u3001@hono\/zod-openapi<\/code>\u3092\u4f7f\u3063\u3066API\u30eb\u30fc\u30c8\u3092\u5b9a\u7fa9\u3057\u307e\u3059\u3002<\/p>\n
        \n
        src\/routes\/users.ts<\/span><\/p>\n
        import<\/span> {<\/span> createRoute }<\/span> from<\/span> '@hono\/zod-openapi'<\/span>\nimport<\/span> {<\/span> UserSchema,<\/span> UsersListResponseSchema,<\/span> ErrorResponseSchema }<\/span> from<\/span> '..\/schemas\/user'<\/span>\n\n\nexport<\/span> const<\/span> listUsersRoute =<\/span> createRoute<\/span>(<\/span>{<\/span>\n  method:<\/span> 'get'<\/span>,<\/span>\n  path:<\/span> '\/users'<\/span>,<\/span>\n  summary:<\/span> '\u30e6\u30fc\u30b6\u30fc\u4e00\u89a7\u53d6\u5f97'<\/span>,<\/span>\n  tags:<\/span> [<\/span>'users'<\/span>]<\/span>,<\/span>\n  responses:<\/span> {<\/span>\n    200<\/span>:<\/span> {<\/span>\n      content:<\/span> {<\/span>\n        'application\/json'<\/span>:<\/span> {<\/span>\n          schema:<\/span> UsersListResponseSchema,<\/span>\n        }<\/span>,<\/span>\n      }<\/span>,<\/span>\n      description:<\/span> '\u30e6\u30fc\u30b6\u30fc\u4e00\u89a7\u3092\u8fd4\u5374'<\/span>,<\/span>\n    }<\/span>,<\/span>\n  }<\/span>,<\/span>\n}<\/span>)<\/span>\n\n\nexport<\/span> const<\/span> getUserRoute =<\/span> createRoute<\/span>(<\/span>{<\/span>\n  method:<\/span> 'get'<\/span>,<\/span>\n  path:<\/span> '\/users\/{id}'<\/span>,<\/span>\n  summary:<\/span> '\u30e6\u30fc\u30b6\u30fc\u8a73\u7d30\u53d6\u5f97'<\/span>,<\/span>\n  tags:<\/span> [<\/span>'users'<\/span>]<\/span>,<\/span>\n  request:<\/span> {<\/span>\n    params:<\/span> UserSchema.<\/span>pick<\/span>(<\/span>{<\/span> id:<\/span> true<\/span> }<\/span>)<\/span>,<\/span>\n  }<\/span>,<\/span>\n  responses:<\/span> {<\/span>\n    200<\/span>:<\/span> {<\/span>\n      content:<\/span> {<\/span>\n        'application\/json'<\/span>:<\/span> {<\/span>\n          schema:<\/span> UserSchema,<\/span>\n        }<\/span>,<\/span>\n      }<\/span>,<\/span>\n      description:<\/span> '\u30e6\u30fc\u30b6\u30fc\u60c5\u5831\u3092\u8fd4\u5374'<\/span>,<\/span>\n    }<\/span>,<\/span>\n    404<\/span>:<\/span> {<\/span>\n      content:<\/span> {<\/span>\n        'application\/json'<\/span>:<\/span> {<\/span>\n          schema:<\/span> ErrorResponseSchema,<\/span>\n        }<\/span>,<\/span>\n      }<\/span>,<\/span>\n      description:<\/span> '\u30e6\u30fc\u30b6\u30fc\u304c\u898b\u3064\u304b\u308a\u307e\u305b\u3093'<\/span>,<\/span>\n    }<\/span>,<\/span>\n  }<\/span>,<\/span>\n}<\/span>)<\/span>\n<\/code><\/pre>\n<\/div>\n
        \n 3. \u30cf\u30f3\u30c9\u30e9\u306e\u5b9f\u88c5<\/h3>\n
        \u5b9a\u7fa9\u3057\u305f\u30eb\u30fc\u30c8\u306b\u5bfe\u3057\u3066\u30cf\u30f3\u30c9\u30e9\u3092\u5b9f\u88c5\u3057\u307e\u3059\u3002<\/p>\n
        \n
        src\/index.ts<\/span><\/p>\n
        import<\/span> {<\/span> OpenAPIHono }<\/span> from<\/span> '@hono\/zod-openapi'<\/span>\nimport<\/span> {<\/span> swaggerUI }<\/span> from<\/span> '@hono\/swagger-ui'<\/span>\nimport<\/span> {<\/span> listUsersRoute,<\/span> getUserRoute }<\/span> from<\/span> '.\/routes\/users'<\/span>\n\nconst<\/span> app =<\/span> new<\/span> OpenAPIHono<\/span>(<\/span>)<\/span>\n\nconst<\/span> mockUsers =<\/span> [<\/span>\n  {<\/span>\n    id:<\/span> '1'<\/span>,<\/span>\n    name:<\/span> '\u5c71\u7530\u592a\u90ce'<\/span>,<\/span>\n    email:<\/span> 'yamada@example.com'<\/span>,<\/span>\n    age:<\/span> 25<\/span>,<\/span>\n    createdAt:<\/span> '2025-01-01T00:00:00Z'<\/span>,<\/span>\n  }<\/span>,<\/span>\n  {<\/span>\n    id:<\/span> '2'<\/span>,<\/span>\n    name:<\/span> '\u4f50\u85e4\u82b1\u5b50'<\/span>,<\/span>\n    email:<\/span> 'sato@example.com'<\/span>,<\/span>\n    age:<\/span> 30<\/span>,<\/span>\n    createdAt:<\/span> '2025-01-02T00:00:00Z'<\/span>,<\/span>\n  }<\/span>,<\/span>\n]<\/span>\n\n\napp.<\/span>openapi<\/span>(<\/span>listUsersRoute,<\/span> (<\/span>c)<\/span> =><\/span> {<\/span>\n  return<\/span> c.<\/span>json<\/span>(<\/span>{<\/span>\n    users:<\/span> mockUsers,<\/span>\n    total:<\/span> mockUsers.<\/span>length,<\/span>\n  }<\/span>)<\/span>\n}<\/span>)<\/span>\n\n\napp.<\/span>openapi<\/span>(<\/span>getUserRoute,<\/span> (<\/span>c)<\/span> =><\/span> {<\/span>\n  const<\/span> {<\/span> id }<\/span> =<\/span> c.<\/span>req.<\/span>valid<\/span>(<\/span>'param'<\/span>)<\/span>\n  const<\/span> user =<\/span> mockUsers.<\/span>find<\/span>(<\/span>(<\/span>u)<\/span> =><\/span> u.<\/span>id ===<\/span> id)<\/span>\n\n  if<\/span> (<\/span>!<\/span>user)<\/span> {<\/span>\n    return<\/span> c.<\/span>json<\/span>(<\/span>{<\/span> error:<\/span> 'User not found'<\/span> }<\/span>,<\/span> 404<\/span>)<\/span>\n  }<\/span>\n\n  return<\/span> c.<\/span>json<\/span>(<\/span>user,<\/span> 200<\/span>)<\/span>\n}<\/span>)<\/span>\n\n\napp.<\/span>doc<\/span>(<\/span>'\/doc'<\/span>,<\/span> {<\/span>\n  openapi:<\/span> '3.0.0'<\/span>,<\/span>\n  info:<\/span> {<\/span>\n    title:<\/span> 'User API'<\/span>,<\/span>\n    version:<\/span> '1.0.0'<\/span>,<\/span>\n  }<\/span>,<\/span>\n}<\/span>)<\/span>\n\napp.<\/span>get<\/span>(<\/span>'\/ui'<\/span>,<\/span> swaggerUI<\/span>(<\/span>{<\/span> url:<\/span> '\/doc'<\/span> }<\/span>)<\/span>)<\/span>\n\nexport<\/span> default<\/span> app\n<\/code><\/pre>\n<\/div>\n
        \n 4. expect.schemaMatching \u3092\u4f7f\u3063\u305f\u30c6\u30b9\u30c8<\/h3>\n
        \u3053\u3053\u304b\u3089\u304c\u672c\u984c\u3067\u3059\u3002Vitest 4\u306eexpect.schemaMatching()<\/code>\u3092\u4f7f\u3063\u3066\u30c6\u30b9\u30c8\u3092\u66f8\u3044\u3066\u3044\u304d\u307e\u3059\u3002<\/p>\n
        \n
        src\/__tests__\/users.test.ts<\/span><\/p>\n
        import<\/span> {<\/span> describe,<\/span> expect,<\/span> test }<\/span> from<\/span> 'vitest'<\/span>\nimport<\/span> app from<\/span> '..\/index'<\/span>\nimport<\/span> {<\/span>\n  UserSchema,<\/span>\n  UsersListResponseSchema,<\/span>\n  ErrorResponseSchema,<\/span>\n}<\/span> from<\/span> '..\/schemas\/user'<\/span>\n\ndescribe<\/span>(<\/span>'Users API - \u30b9\u30ad\u30fc\u30de\u99c6\u52d5\u30c6\u30b9\u30c8'<\/span>,<\/span> (<\/span>)<\/span> =><\/span> {<\/span>\n  describe<\/span>(<\/span>'GET \/users - \u30e6\u30fc\u30b6\u30fc\u4e00\u89a7\u53d6\u5f97'<\/span>,<\/span> (<\/span>)<\/span> =><\/span> {<\/span>\n    test<\/span>(<\/span>'\u6b63\u3057\u3044\u30b9\u30ad\u30fc\u30de\u306e\u30ec\u30b9\u30dd\u30f3\u30b9\u3092\u8fd4\u3059'<\/span>,<\/span> async<\/span> (<\/span>)<\/span> =><\/span> {<\/span>\n      const<\/span> res =<\/span> await<\/span> app.<\/span>request<\/span>(<\/span>'\/users'<\/span>)<\/span>\n\n      expect<\/span>(<\/span>res.<\/span>status)<\/span>.<\/span>toBe<\/span>(<\/span>200<\/span>)<\/span>\n\n      const<\/span> data =<\/span> await<\/span> res.<\/span>json<\/span>(<\/span>)<\/span>\n\n      \n      expect<\/span>(<\/span>data)<\/span>.<\/span>toEqual<\/span>(<\/span>expect.<\/span>schemaMatching<\/span>(<\/span>UsersListResponseSchema)<\/span>)<\/span>\n    }<\/span>)<\/span>\n\n    test<\/span>(<\/span>'users\u914d\u5217\u306e\u5404\u8981\u7d20\u304cUserSchema\u306b\u6e96\u62e0'<\/span>,<\/span> async<\/span> (<\/span>)<\/span> =><\/span> {<\/span>\n      const<\/span> res =<\/span> await<\/span> app.<\/span>request<\/span>(<\/span>'\/users'<\/span>)<\/span>\n      const<\/span> data =<\/span> await<\/span> res.<\/span>json<\/span>(<\/span>)<\/span>\n\n      \n      data.<\/span>users.<\/span>forEach<\/span>(<\/span>(<\/span>user:<\/span> any<\/span>)<\/span> =><\/span> {<\/span>\n        expect<\/span>(<\/span>user)<\/span>.<\/span>toEqual<\/span>(<\/span>expect.<\/span>schemaMatching<\/span>(<\/span>UserSchema)<\/span>)<\/span>\n      }<\/span>)<\/span>\n    }<\/span>)<\/span>\n\n    test<\/span>(<\/span>'total\u5024\u304c\u6b63\u3057\u3044\u578b'<\/span>,<\/span> async<\/span> (<\/span>)<\/span> =><\/span> {<\/span>\n      const<\/span> res =<\/span> await<\/span> app.<\/span>request<\/span>(<\/span>'\/users'<\/span>)<\/span>\n      const<\/span> data =<\/span> await<\/span> res.<\/span>json<\/span>(<\/span>)<\/span>\n\n      \n      expect<\/span>(<\/span>data)<\/span>.<\/span>toMatchObject<\/span>(<\/span>{<\/span>\n        total:<\/span> expect.<\/span>schemaMatching<\/span>(<\/span>UsersListResponseSchema.<\/span>shape.<\/span>total)<\/span>,<\/span>\n      }<\/span>)<\/span>\n    }<\/span>)<\/span>\n  }<\/span>)<\/span>\n\n  describe<\/span>(<\/span>'GET \/users\/:id - \u30e6\u30fc\u30b6\u30fc\u8a73\u7d30\u53d6\u5f97'<\/span>,<\/span> (<\/span>)<\/span> =><\/span> {<\/span>\n    test<\/span>(<\/span>'\u5b58\u5728\u3059\u308b\u30e6\u30fc\u30b6\u30fcID\u3067\u6b63\u3057\u3044\u30b9\u30ad\u30fc\u30de\u306e\u30ec\u30b9\u30dd\u30f3\u30b9\u3092\u8fd4\u3059'<\/span>,<\/span> async<\/span> (<\/span>)<\/span> =><\/span> {<\/span>\n      const<\/span> res =<\/span> await<\/span> app.<\/span>request<\/span>(<\/span>'\/users\/1'<\/span>)<\/span>\n\n      expect<\/span>(<\/span>res.<\/span>status)<\/span>.<\/span>toBe<\/span>(<\/span>200<\/span>)<\/span>\n\n      const<\/span> data =<\/span> await<\/span> res.<\/span>json<\/span>(<\/span>)<\/span>\n\n      \n      expect<\/span>(<\/span>data)<\/span>.<\/span>toEqual<\/span>(<\/span>expect.<\/span>schemaMatching<\/span>(<\/span>UserSchema)<\/span>)<\/span>\n    }<\/span>)<\/span>\n\n    test<\/span>(<\/span>'\u7279\u5b9a\u306e\u30e6\u30fc\u30b6\u30fc\u60c5\u5831\u3092\u691c\u8a3c'<\/span>,<\/span> async<\/span> (<\/span>)<\/span> =><\/span> {<\/span>\n      const<\/span> res =<\/span> await<\/span> app.<\/span>request<\/span>(<\/span>'\/users\/1'<\/span>)<\/span>\n      const<\/span> data =<\/span> await<\/span> res.<\/span>json<\/span>(<\/span>)<\/span>\n\n      \n      expect<\/span>(<\/span>data)<\/span>.<\/span>toMatchObject<\/span>(<\/span>{<\/span>\n        id:<\/span> expect.<\/span>schemaMatching<\/span>(<\/span>UserSchema.<\/span>shape.<\/span>id)<\/span>,<\/span>\n        name:<\/span> expect.<\/span>schemaMatching<\/span>(<\/span>UserSchema.<\/span>shape.<\/span>name)<\/span>,<\/span>\n        email:<\/span> expect.<\/span>schemaMatching<\/span>(<\/span>UserSchema.<\/span>shape.<\/span>email)<\/span>,<\/span>\n        createdAt:<\/span> expect.<\/span>schemaMatching<\/span>(<\/span>UserSchema.<\/span>shape.<\/span>createdAt)<\/span>,<\/span>\n      }<\/span>)<\/span>\n    }<\/span>)<\/span>\n\n    test<\/span>(<\/span>'\u5b58\u5728\u3057\u306a\u3044\u30e6\u30fc\u30b6\u30fcID\u3067\u30a8\u30e9\u30fc\u30b9\u30ad\u30fc\u30de\u3092\u8fd4\u3059'<\/span>,<\/span> async<\/span> (<\/span>)<\/span> =><\/span> {<\/span>\n      const<\/span> res =<\/span> await<\/span> app.<\/span>request<\/span>(<\/span>'\/users\/999'<\/span>)<\/span>\n\n      expect<\/span>(<\/span>res.<\/span>status)<\/span>.<\/span>toBe<\/span>(<\/span>404<\/span>)<\/span>\n\n      const<\/span> data =<\/span> await<\/span> res.<\/span>json<\/span>(<\/span>)<\/span>\n\n      \n      expect<\/span>(<\/span>data)<\/span>.<\/span>toEqual<\/span>(<\/span>expect.<\/span>schemaMatching<\/span>(<\/span>ErrorResponseSchema)<\/span>)<\/span>\n    }<\/span>)<\/span>\n  }<\/span>)<\/span>\n}<\/span>)<\/span>\n<\/code><\/pre>\n<\/div>\n
        \n 5. \u30c6\u30b9\u30c8\u5b9f\u884c<\/h3>\n
        \u30c6\u30b9\u30c8\u3092\u5b9f\u884c\u3057\u307e\u3059\u3002<\/p>\n
        \"\"<\/p>\n
        \n expect.schemaMatching \u306e\u5229\u70b9<\/h2>\n
        \u5f93\u6765\u306e\u30c6\u30b9\u30c8\u65b9\u6cd5\u3068\u6bd4\u8f03\u3057\u3066\u3001expect.schemaMatching()<\/code>\u306b\u306f\u4ee5\u4e0b\u306e\u3088\u3046\u306a\u5229\u70b9\u304c\u3042\u308a\u307e\u3059\u3002<\/p>\n
        \n 1. \u30c6\u30b9\u30c8\u30b3\u30fc\u30c9\u306e\u7c21\u6f54\u5316<\/h3>\n
        \u5f93\u6765\u306e\u30c6\u30b9\u30c8\u65b9\u6cd5\u3067\u306f\u3001\u8907\u6570\u306e\u30a2\u30b5\u30fc\u30b7\u30e7\u30f3\u3084expect.objectContaining<\/code>\u3092\u7d44\u307f\u5408\u308f\u305b\u308b\u5fc5\u8981\u304c\u3042\u308a\u307e\u3057\u305f:<\/p>\n
        \n
        \nexpect<\/span>(<\/span>data)<\/span>.<\/span>toHaveProperty<\/span>(<\/span>\"id\"<\/span>)<\/span>;<\/span>\nexpect<\/span>(<\/span>typeof<\/span> data.<\/span>id)<\/span>.<\/span>toBe<\/span>(<\/span>\"string\"<\/span>)<\/span>;<\/span>\nexpect<\/span>(<\/span>data)<\/span>.<\/span>toHaveProperty<\/span>(<\/span>\"name\"<\/span>)<\/span>;<\/span>\nexpect<\/span>(<\/span>typeof<\/span> data.<\/span>name)<\/span>.<\/span>toBe<\/span>(<\/span>\"string\"<\/span>)<\/span>;<\/span>\nexpect<\/span>(<\/span>data.<\/span>name.<\/span>length)<\/span>.<\/span>toBeGreaterThan<\/span>(<\/span>0<\/span>)<\/span>;<\/span>\nexpect<\/span>(<\/span>data)<\/span>.<\/span>toHaveProperty<\/span>(<\/span>\"email\"<\/span>)<\/span>;<\/span>\nexpect<\/span>(<\/span>data.<\/span>email)<\/span>.<\/span>toMatch<\/span>(<\/span>\/<\/span>^<\/span>[<\/span>^<\/span>\\s<\/span>@]<\/span><\/span>+<\/span>@[<\/span>^<\/span>\\s<\/span>@]<\/span><\/span>+<\/span>\\.<\/span>[<\/span>^<\/span>\\s<\/span>@]<\/span><\/span>+<\/span>$<\/span><\/span>\/<\/span><\/span>)<\/span>;<\/span>\n\n\nexpect<\/span>(<\/span>data)<\/span>.<\/span>toEqual<\/span>(<\/span>\n  expect.<\/span>objectContaining<\/span>(<\/span>{<\/span>\n    id:<\/span> expect.<\/span>any<\/span>(<\/span>String)<\/span>,<\/span>\n    name:<\/span> expect.<\/span>any<\/span>(<\/span>String)<\/span>,<\/span>\n    email:<\/span> expect.<\/span>stringMatching<\/span>(<\/span>\/<\/span>^<\/span>[<\/span>^<\/span>\\s<\/span>@]<\/span><\/span>+<\/span>@[<\/span>^<\/span>\\s<\/span>@]<\/span><\/span>+<\/span>\\.<\/span>[<\/span>^<\/span>\\s<\/span>@]<\/span><\/span>+<\/span>$<\/span><\/span>\/<\/span><\/span>)<\/span>,<\/span>\n    age:<\/span> expect.<\/span>any<\/span>(<\/span>Number)<\/span>,<\/span>\n    createdAt:<\/span> expect.<\/span>any<\/span>(<\/span>String)<\/span>,<\/span>\n  }<\/span>)<\/span>,<\/span>\n)<\/span>;<\/span>\n\n<\/code><\/pre>\n<\/div>\n
        expect.schemaMatching()<\/code>\u3092\u4f7f\u7528:<\/p>\n
        \n
        \nexpect<\/span>(<\/span>data)<\/span>.<\/span>toEqual<\/span>(<\/span>expect.<\/span>schemaMatching<\/span>(<\/span>UserSchema)<\/span>)<\/span>;<\/span>\n<\/code><\/pre>\n<\/div>\n
        \n 2. \u30b9\u30ad\u30fc\u30de\u3068\u30c6\u30b9\u30c8\u306e\u4e00\u5143\u7ba1\u7406<\/h3>\n
        \u30b9\u30ad\u30fc\u30de\u304c\u5358\u4e00\u306e\u60c5\u5831\u6e90(Single Source of Truth)\u3068\u306a\u308a\u3001\u4ee5\u4e0b\u304c\u5168\u3066\u540c\u671f\u3055\u308c\u307e\u3059\u3002<\/p>\n
          \n
        • \u578b\u5b9a\u7fa9(TypeScript)<\/li>\n
        • \u30d0\u30ea\u30c7\u30fc\u30b7\u30e7\u30f3(\u5b9f\u884c\u6642\u30c1\u30a7\u30c3\u30af)<\/li>\n
        • API\u30c9\u30ad\u30e5\u30e1\u30f3\u30c8(OpenAPI)<\/li>\n
        • \u30c6\u30b9\u30c8\u306e\u671f\u5f85\u5024<\/li>\n<\/ul>\n
          \u30b9\u30ad\u30fc\u30de\u3092\u66f4\u65b0\u3059\u308c\u3070\u3001\u3053\u308c\u3089\u5168\u3066\u306b\u5909\u66f4\u304c\u53cd\u6620\u3055\u308c\u307e\u3059\u3002<\/p>\n
          \n 3. \u8907\u96d1\u306a\u30c7\u30fc\u30bf\u69cb\u9020\u306e\u691c\u8a3c\u304c\u5bb9\u6613<\/h3>\n
          \u30cd\u30b9\u30c8\u3057\u305f\u69cb\u9020\u3084\u914d\u5217\u306e\u691c\u8a3c\u3082\u7c21\u6f54\u306b\u66f8\u3051\u307e\u3059\u3002<\/p>\n
          \n
          test<\/span>(<\/span>\"users\u914d\u5217\u306e\u5404\u8981\u7d20\u304cUserSchema\u306b\u6e96\u62e0\"<\/span>,<\/span> async<\/span> (<\/span>)<\/span> =><\/span> {<\/span>\n  const<\/span> res =<\/span> await<\/span> app.<\/span>request<\/span>(<\/span>\"\/users\"<\/span>)<\/span>;<\/span>\n  const<\/span> data =<\/span> await<\/span> res.<\/span>json<\/span>(<\/span>)<\/span>;<\/span>\n\n  \n  data.<\/span>users.<\/span>forEach<\/span>(<\/span>(<\/span>user:<\/span> unknown<\/span>)<\/span> =><\/span> {<\/span>\n    expect<\/span>(<\/span>user)<\/span>.<\/span>toEqual<\/span>(<\/span>expect.<\/span>schemaMatching<\/span>(<\/span>UserSchema)<\/span>)<\/span>;<\/span>\n  }<\/span>)<\/span>;<\/span>\n}<\/span>)<\/span>;<\/span>\n<\/code><\/pre>\n<\/div>\n
          \n \u30b9\u30ad\u30fc\u30de\u99c6\u52d5\u958b\u767a\u306e\u30ef\u30fc\u30af\u30d5\u30ed\u30fc<\/h2>\n
          expect.schemaMatching()<\/code>\u306f\u3001\u30b9\u30ad\u30fc\u30de\u99c6\u52d5\u958b\u767a\u306e\u30ef\u30fc\u30af\u30d5\u30ed\u30fc\u3068\u975e\u5e38\u306b\u76f8\u6027\u304c\u826f\u3044\u3067\u3059\u3002<\/p>\n