typescript

TypeScript - Unknown

TypeScript에서 unknown 타입은 any와 비슷해 보이지만, 실제로는 타입 안전성을 높이는 중요한 개념입니다. 많은 개발자가 any를 사용할 때 발생하는 문제를 경험했을 것입니다. any는 어떠한 타입도 허용하지만, 타입 검사를 우회하기 때문에 예상치 못한 오류를 발생시킬 가능성이 높습니다. 반면, unknown은 타입 검사를 강제하여 이러한 문제를 방지할 수 있습니다.

unknown 타입이란?

unknown은 TypeScript 3.0에서 도입된 타입으로, 모든 타입을 받을 수 있지만, 직접 사용하려면 타입 검사를 거쳐야 합니다. 이는 any와 달리 타입 안정성을 보장하면서도 유연한 데이터 처리를 가능하게 합니다.

예를 들어, any를 사용하면 타입 검사를 하지 않아도 함수 내부에서 어떤 연산이든 수행할 수 있습니다.

function logMessage(msg: any) {
  console.log(msg.toUpperCase()); // 런타임 오류 가능성 존재
}
 
logMessage(42); // 숫자에는 toUpperCase()가 없음 → 런타임 오류 발생

반면, unknown을 사용하면 타입 검사를 강제해야 합니다.

function logMessage(msg: unknown) {
  if (typeof msg === "string") {
    console.log(msg.toUpperCase()); // 타입 검사를 거쳤기 때문에 안전
  } else {
    console.log("Invalid message type");
  }
}
 
logMessage(42); // "Invalid message type"

위 코드처럼 unknown은 값을 바로 사용할 수 없고, 명확한 타입 검사를 수행해야만 접근이 가능합니다. 따라서 unknown을 사용하면 any보다 타입 안정성이 크게 향상됩니다.

2. any와 unknown의 차이점

any를 사용하면 코드가 빠르게 작성될 수 있지만, 런타임 오류가 발생할 가능성이 높아집니다. 반면, unknown은 타입 검사를 요구하기 때문에 실수를 방지할 수 있습니다.

3. unknown의 활용 예시

3.1. unknown을 사용한 안전한 에러 핸들링

catch 블록에서 unknown을 사용하면 에러의 타입이 명확하지 않을 때도 안전하게 처리할 수 있습니다.

try {
  throw new Error("Something went wrong!");
} catch (err: unknown) {
  if (err instanceof Error) {
    console.log(err.message); // 타입 검사를 거쳐야 안전하게 접근 가능
  } else {
    console.log("Unknown error");
  }
}

위 코드에서 catch(err: unknown)을 사용하면, 예외적으로 발생하는 에러가 어떤 타입이든 안전하게 처리할 수 있습니다.

3.2. API 응답을 처리할 때

백엔드에서 반환된 데이터의 타입이 명확하지 않을 때 unknown을 사용하면 예상치 못한 오류를 방지할 수 있습니다.

async function fetchData(): Promise<unknown> {
  return await fetch("https://api.example.com/data").then(res => res.json());
}
 
async function processData() {
  const data: unknown = await fetchData();
  if (typeof data === "object" && data !== null && "name" in data) {
    console.log((data as { name: string }).name); // 타입 검사를 거쳐야 접근 가능
  } else {
    console.log("Invalid data format");
  }
}

위 코드에서 fetchData의 반환 타입을 unknown으로 지정함으로써, 데이터를 사용할 때 반드시 타입 검사를 하도록 강제합니다.

4. unknown[]을 활용한 가변 인자 처리

...rest 파라미터에도 unknown[]을 사용할 수 있습니다. 예를 들어, 여러 타입의 데이터를 로깅하는 함수에서 unknown[]을 활용하면 유연하면서도 안전한 코드를 작성할 수 있습니다.

class Logger {
  error(message: unknown, ...rest: unknown[]): void {
    console.log("---- ERROR LOG ----");
    if (typeof message === "string") {
      console.log(message.toUpperCase()); // 안전한 타입 검사 후 처리
    } else {
      console.log("Unknown error:", message);
    }
    console.log("Additional info:", rest);
  }
}
 
const logger = new Logger();
logger.error("Server error", { code: 500 }, new Error("DB Connection failed"));

위 코드에서 message: unknown과 ...rest: unknown[]을 사용함으로써, 다양한 타입의 데이터를 안전하게 처리할 수 있습니다.

unknown을 타입 가드로 활용

TypeScript에서는 unknown을 활용해 커스텀 타입 가드를 만들 수도 있습니다.

function isString(value: unknown): value is string {
  return typeof value === "string";
}
 
function printMessage(msg: unknown) {
  if (isString(msg)) {
    console.log(msg.toUpperCase()); // 타입 가드를 거쳤기 때문에 안전
  } else {
    console.log("Not a string");
  }
}
 
printMessage("Hello!"); // "HELLO!"
printMessage(123); // "Not a string"

위 코드에서 isString(value: unknown): value is string 타입 가드를 사용하면, printMessage 함수 내부에서 msg가 문자열인지 안전하게 확인할 수 있습니다.

6. 언제 unknown을 사용할까?

• 입력 타입을 미리 알 수 없지만, 내부에서 안전한 처리가 필요할 때
• API 응답처럼 외부 데이터를 처리할 때
• catch(err)에서 예외를 안전하게 처리할 때
• 다양한 타입을 받을 수 있는 유틸리티 함수나 로깅 함수

반면, 정확한 타입을 알고 있다면 unknown보다는 명확한 타입을 직접 지정하는 것이 좋습니다. 불필요하게 unknown을 사용하면 오히려 타입 검사가 과도해질 수 있기 때문입니다.

정리

unknown은 any와 비슷하지만, 타입 검사를 강제함으로써 안전한 코드 작성을 돕는 강력한 기능입니다. 특히, API 응답 처리, 예외 핸들링, 가변 인자 처리 등에서 유용하게 사용할 수 있습니다. any를 무분별하게 사용하면 예상치 못한 버그가 발생할 가능성이 크므로, unknown을 적절히 활용하여 타입 안전성을 유지하는 것이 중요합니다.