zodios 는 응답 검증이 실패하면 ZodError 를 그대로 던지지 않고 ZodiosError 의 cause 에 담아 던진다. 그래서 instanceof z.ZodError 로는 잡히지 않고, ZodiosError 인지 본 뒤 cause 가 ZodError 인지 확인해 fromZodError 로 읽는다.

-- zodios: 응답 검증 실패를 ZodiosError 로 감싸고 ZodError 는 cause 에 둔다
zodError :: Error -> Maybe ZodError
zodError (ZodiosError { cause = Just (ZodErr z) }) = Just z   -- err instanceof ZodiosError && err.cause instanceof ZodError
zodError (ZodErr z)                                = Just z
zodError _                                         = Nothing
-- instanceof z.ZodError 만 보면 놓친다 → fromZodError(err.cause).toString()
#278

ES2015 이상에서는 Error 생성자가 new.target 으로 프로토타입 사슬을 서브클래스로 맞춰 준다. ES5 로 내리면 new.target 이 없어 만들어진 객체의 프로토타입이 Error.prototype 에 머물고, instanceof CustomError 가 false 가 된다. super() 바로 뒤에 Object.setPrototypeOf(this, CustomError.prototype) 로 직접 맞춘다.

-- Error 를 상속한 클래스: 프로토타입 사슬을 누가 맞추나
construct :: Target -> Class -> Object
construct ES2015 cls = Object { proto = prototype cls }      -- Error 가 new.target 으로 맞춘다
construct ES5    _   = Object { proto = prototype Error }    -- new.target 이 없다 → instanceof CustomError == False

-- 고침: super(message) 직후 Object.setPrototypeOf(this, CustomError.prototype) — ES2015+ 타깃이면 필요 없다
#287

await tuple(promise) 는 던지는 대신 배열을 돌려준다. 성공하면 [null, 결과], 실패하면 [error]. reject 된 값이 Error 가 아니면(문자열·undefined 등) TupleItError 로 감싸서, if (error) 하나로 성공과 실패가 갈린다. try…catch 대신 쓰는 이 모양을 언어 문법으로 넣자는 제안이 safe assignment operator 다.

-- 비동기 결과와 오류를 튜플로 — try…catch 대신
tuple :: IO a -> IO (Either Error a)
tuple p = (Right <$> p) `catch` (pure . Left . wrap)
  where wrap e | isError e = e
               | otherwise = TupleItError e   -- Error 가 아닌 값으로 reject 돼도 감싼다

-- const [error, data] = await tuple(someAsyncFunction())
--   성공 [null, data] · 실패 [error] — if (error) 하나로 갈린다
-- 언어 문법으로 넣자는 제안: safe assignment operator (?=)
#357


Footnotes

  1. 에러 메시지를 어디에·어떻게 보이나 의 디자인 지침 (Vitaly Friedman). 빨간색에만 기대지 않기, 자동 스크롤 금지, 입력값을 가리지 않기, 폼에선 입력란 위에·표에선 인라인으로, 토스트로 띄우지 않기, 사용자가 에러를 무시하고 진행할 수 있게, 올바른 입력 예시와 상단 요약. ↩

  2. Google Tech Writing 의 에러 메시지 문구 과정. 좋은 에러 메시지는 “무엇이 잘못됐나”와 “어떻게 고치나” 두 질문에 답한다 — 모호하거나 다음 행동을 알 수 없는 메시지가 지원 문의를 늘린다. GUI 에 띄우는 방식은 다루지 않는다. ↩

#429