expect.extend 로 toMatchSchema 를 추가한다. 매처는 Response 의 json 을 꺼내 schema.safeParseAsync 로 검사하고 성공 여부를 pass 로 돌려준다. 비동기 매처라 타입 선언의 반환은 R 이 아니라 Promise<void> 이고, 테스트에서 await expect(res).toMatchSchema(schema) 로 기다려야 한다.

-- expect.extend: Response 의 본문이 Zod 스키마에 맞는가
toMatchSchema :: Response -> Schema -> IO MatcherResult
toMatchSchema res schema = do
  body <- json res
  r    <- safeParseAsync schema body
  pure MatcherResult { pass = success r, message = "" }

-- declare module 'vitest' { interface Matchers<R, T> { toMatchSchema: (s) => Promise<void> } }
-- 비동기 매처: 반환 타입은 R 이 아니라 Promise<void>, 테스트에서 await
-- await expect(todoResponse).toMatchSchema(todoSchema)
#317

영업시간에 따라 결과가 달라지는 purchase 를 테스트한다. 각 테스트 전에 useFakeTimers 로 Date·setTimeout 을 가짜로 바꾸고, setSystemTime 으로 13시를 넣으면 Success, 19시를 넣으면 Error 를 기대한다. 끝나면 useRealTimers 로 되돌린다. Vitest 와 Jest 모두 @sinonjs/fake-timers 위에 있어 API 이름만 vi·jest 로 다르다.

-- 시각에 따라 결과가 달라지는 함수를 시각을 정해 놓고 테스트한다
purchase :: Time -> Result
purchase t | openHours t = Success
           | otherwise   = Error

beforeEach useFakeTimers        -- Date · setTimeout 등을 가짜로 (vi / jest 같은 이름)
afterEach  useRealTimers

it "영업시간"   (setSystemTime (date 2000 1 1 13) >> purchase' `shouldBe` Success)
it "영업시간 외" (setSystemTime (date 2000 1 1 19) >> purchase' `shouldBe` Error)
-- 둘 다 @sinonjs/fake-timers 기반
#347

vi.mock 은 파일 맨 위로 끌어올려져 바깥 변수를 못 본다. 그래서 vi.hoisted 안에서 MockResizeObserver 를 만들고 vi.mock 이 그걸 resize-observer-polyfill 의 default 로 넣는다. new 로 불리므로 구현은 화살표가 아니라 function 이다 — 화살표면 is not a constructor. 생성될 때마다 콜백과 observer 를 배열에 쌓아 두고, 테스트에서 triggerResize(entries, index) 로 원하는 observer 의 콜백을 직접 부른다. beforeEach 에서 배열을 비운다.

-- vi.mock 은 맨 위로 끌어올려져 바깥 변수를 못 본다 → vi.hoisted 로 먼저 만든다
(mockResizeObserver, MockResizeObserver) = hoisted $ do
  observers <- newRef []
  let ctor = fn (\callback -> do                 -- new 로 불린다: 화살표가 아니라 function
               let o = { observe = fn, unobserve = fn, disconnect = fn }
               modify observers (++ [(callback, o)])
               pure o)
  pure ( { triggerResize = \entries i -> do (cb, o) <- (!! i) <$> read observers
                                            cb entries o
         , reset = write observers [] }
       , ctor )

mock "resize-observer-polyfill" { default = MockResizeObserver }

beforeEach (reset mockResizeObserver)
it "handles resize" (triggerResize mockResizeObserver [{ target = div, contentRect = { width = 100 } }] 0)
#514

vi.mocked(useSize) 는 타입을 붙여 받은 것을 그대로 돌려줄 뿐이라, 모킹하지 않은 원래 함수에 mockImplementation 을 부르면 undefined 다. vi.hoisted 로 vi.fn() 을 먼저 만들고 vi.mock 이 그걸 모듈 자리에 넣어야, beforeEach 에서 mockImplementation 으로 너비 100 을 돌려줄 수 있다. DOM 측정값(scrollWidth 등)은 Object.defineProperty 로 getter 를 바꾸고 뒤에서 복원한다. 측정이 복잡하면 Playwright·Cypress 로 넘긴다.

-- vi.mocked 는 타입만 붙인다 — 구현은 없다
mocked :: a -> Mocked a
mocked = unsafeCoerce                    -- "Just returns the object that was passed"
(mocked useSize).mockImplementation      -- undefined: 원래 함수는 mock 이 아니다

-- 구현은 vi.hoisted 로 먼저 만들어 vi.mock 에 넘긴다
mockUseSize = hoisted fn
mock "ahooks" { useSize = mockUseSize }
beforeEach (mockImplementation mockUseSize (const { width = 100, height = 20 }))

-- DOM 측정값은 getter 를 바꾸고 뒤에서 복원
beforeEach (defineProperty htmlElementPrototype "scrollWidth" { configurable = True, get = 150 })
-- 측정이 복잡하면 Playwright·Cypress 통합 테스트로
#515