본문 바로가기
JavaScript/TypeScript

[TypeScript] 타입 단언, 타입 가드, 타입 호환

by dev수니 2024. 4. 12.
반응형

타입스크립트를 오래 사용해 왔지만 가끔 까먹는 내용때문에 막힐때마다 시간낭비하고 싶지 않아서 공부한 내용을 정리하고 포스팅하려고 한다.

  1. 타입을 명시하는 타입 단언(Assertion)
  2. 유니온 등에서 타입의 경우를 좁혀가는 타입 가드(Guard)
  3. 타입 간의 호환성을 판단하는 타입 호환(Compatibility)
위 세 개 항목에 대해 정리해보겠다.

💜 타입 단언

[변수] as [타입]
타입 단언이란, 타입스크립트가 추론하지 못하는 타입을 개발자가 직접 명시해주는 문법이다.
컴파일러가 실제 런타임에 존재하는 변수 타입과 다르게 추론하거나, 너무 보수적으로 추론하는 경우 개발자가 수동적으로 조작하기 위해 사용한다.
타입 단언은 Type Casting 과는 달리, 실제 데이터 타입을 변경하지 않고 에러만 방지한다.

사용예시

타입 단업은 두가지 방법으로 구현할 수 있다.
// 1. as
let someValue: unknown = "this is a string";
let strLength: number = (someValue as string).length;
 
// 2. 꺾쇠(Angle bracket), 타입 단언
let someValue: unknown = "this is a string";
let strLength: number = (<string>someValue).length; // unknown 타입이지만 Type Assertion을 통해 타입추론 가능
- 두번째 방법은 HTML 태그 등과 혼동되므로 as 키워드를 많이 사용한다.

사용예제

이 타입 단언은 DOM 조작에 유용하게 쓰일 수 있다.
먼저 아래의 예시를 보면 변수 div에 DOM 을 할당하고 내부의 프로퍼티를 사용하려고 한다.
const div = document.querySelector('div');
console.log(div.innerText);		// error!
if (div) console.log(div.innerText)
에러가 발생하는 이유는 DOM 이 HTMLDivElement | null 의 유니온 타입으로 이루어져 있기 때문이다. 따라서 해당 요소가 존재하지 않으면 null 이 할당되므로 특정 프로퍼티 접근에 대해 경고를 내린다.
 
이 경우, 개발자는 확실히 div가 HTML 요소임을 단언하여 사용한다.
const div = document.querySelector('div') as HTMLDivElement;
console.log(div.innerText);		// no error

💚 타입 가드

유니온 타입을 사용하면서, 복수의 타입들 중 어느 타입을 이용할 지 확신을 주는 문법이다. (Type Narrowing 이라고도 한다.)

잘못된 예시.

union type error

interface Developer {
  name: string;
  skill: string;
}

interface Person {
  name: string;
  age: number;
}
  
function introduce():  Developer  |  Person {
  return { name : 'Tony', age : 33, skill: 'Iron Marking'}
}

let tony = introduce();
console.log(tony.skill); // error
위 예시처럼, tony 라는 인스턴스는 union 타입이기에 name, age, skill 모든 프로퍼티 설정이 가능하다. 하지만, 인스턴스에서 skill 에 접근하는 경우 에러가 발생한다.
유니온 타입의 인스턴스는 기본적으로 공통된 프로퍼티만 허용하기 때문이다.

타입단언으로 해결

if ((tony as Developer).skill) {
	console.log(tony.skill);
} else if ((tony as Person)).age) {
	console.log(tony.age);
}
tony 인스턴스를 타입 단언으로 보장 한 뒤 조건문으로 설정하는 방법도 있지만 가독성과 효율이 매우 떨어진다.

해결방법.

사용자 정의 Type Guard

// 타입가드 정의
function isDeveloper(target: Developer | Person): target is Developer {
  return (target as Developer).skill !== undefined;
}

// 타입가드 활용
if (isDeveloper(tony)) {
  console.log(tony.skill)	// Developer 타입으로 추론됨
}
else {
  console.log(tony.age)		// Person 타입으로 추론됨
}
isDeveloper() 는 타입 가드 함수이다. 인자의 타입이 Developer인지 여부를 반환한다. (as 단언문은 생략가능) 이 타입 가드 함수는 Boolean을 반환하기 때문에 예시처럼 활용 하면 된다.
이 때 중요한 점은, if 와 else 각 scope에서 인자(tony)의 타입 Developer인 경우와 아닌 경우(여기서는 Person만)로 추론해준다는 것이다.

타입 가드 문법

타입스크립트는 기본적으로 타입 가드를 위한 문법들을 지원하고 있다.

1) typeof

function isString(value: string | number) {
  if (typeof value === string) console.log(value.substr(0));
  else console.log(Math.floor(value));
}
typeof 연산자를 통해 인자(value)의 유니온 타입을 확인한다.

2) instanceof

class Developer {
    developer() {
        console.log("업무 중")
    }
}
 
class Designer {
    design() {
        console.log("업무 중")
    }
}
 
const work = (worker: Developer | Designer) => {
    if (worker instanceof Developer) {
        worker.developer();
    } else {
        worker.design();
    }
}
타입스크립트는 클래스도 일종의 타입이다.
인스턴스를 typeof 로 판정하면 항상 객체(object) 이므로 typeof 로는 판정할 수 없다. instanceof 문법을 통해 어느 클래스에서 비롯됐는지를 판정한다.

3) in

type Human = {
    think: () => void;
};
 
type Dog = {
    tail: string;
    bark: () => void;
}
 
declare function getEliceType(): Human | Dog;
 
const elice =  getEliceType();
 
if ('tail' in elice) {
    elice.bark();
} else {
    elice.think();
}
[문자열] in [객체] 문법은 객체 내에 해당 프로퍼티가 존재하는지를 반환한다. 객체 프로퍼티에 접근하는 경우가 많기에 유용한 문법이다.

🤎 타입 호환

특정 타입이 다른 타입에 잘 맞는지를 의미한다. 코드 타입을 해석해나가는 과정에서 두 타입이 서로 호환되는지를 점검하는 것이다.

구조적 타이핑

interface Restaurant {
	name: string;
	star: number;
}

let pinetree: Restaurant;  // pinetree 변수 선언

let pinetreeWithAddress = {   // pinetreeWithAddress 변수 선언하고 초기화
	name: "대나무한정식",
	star: 5,
	address: "동대문",
};

pinetree = pinetreeWithAddress;
구조적 타이핑(structural typing)은 코드 구조 관점에서 타입이 서로 호환되는지 여부를 판단하는 것이다.
위의 예시처럼 pinetree에 pinetreeWithAddress 변수를 할당하면 에러가 날 것으로 예상했지만, 서로가 잘 호환되고 있다.
타입스크립트는 할당하는 타입이 할당받는 타입의 구조보다 크다면 서로 호환된다고 인정한다. 이를, 구조적 타이핑(structual typing)이라 한다.

1) 인터페이스, 클래스

interface Developer {
  name: string;
  skill: string;
}

interface Person {
  name: string;
}

class PersonClass {
  name: string;
}

let developer: Developer;
let person: Person;

person = developer;
developer = person;// Error!
developer = new PersonClass()// Error!
person과 developer 변수의 각 타입을 인터페이스로 작성한 뒤, 이를 서로에게 각각 할당하는 예제이다.
developer는 name 프로퍼티를 보장하기에 person에 할당되어도 무방하나,
person은 skill 프로퍼티를 보장하지 않기에 developer에 할당될 수 없는 것이다.
이는, 클래스(PersonClass)도 동일하다. 클래스도 일종의 타입으로, 인스턴스의 타입이 호환되지 않는 경우 에러가 발생하는 것이다.

2) 함수

const add = function(a: number) {
  return a;
}

const sum = function(a: number, b: number) {
  return a + b;
}

sum = add;
add = sum// Error!
함수에서도 마찬가지이다. sum은 2개의 변수(number)를, add는 1개 변수(number)를 받는다.
그렇기에 sum이 더 큰 범위라고 간주하여, 아래의 할당문이 에러가 발생한다.
함수의 매개변수, 혹은 반환값의 타입의 범주가 더 큰 값이 할당되어야 타입이 호환되는 것으로 판단하는 것이다.

3) 제네릭

interface Empty<T> {
// ..
}

let empty1: Empty<string>
let empty2: Empty<number>;

empty1 = empty2
empty2 = empty1;
interface NotEmpty<T> {
  data: T;
}

let notempty1: NotEmpty<string>;
let notempty2: NotEmpty<number>;

notempty1 = notempty2 // Error!
notempty2 = notempty1 // Error!
제네릭으로 타입 인자를 받는 인터페이스를 예시로 들었다. 위 2가지 케이스를 비교해보자.
Empty의 경우, 제네릭으로 할당되는 타입에 따라 내부 프로퍼티가 영향을 받지 않기 때문에 에러가 발생하지 않는다.
하지만 NotEmpty의 경우, 제네릭에 따라 data 타입이 바뀌기 때문에 notempty1, notempty2 는 서로 호환되지 않는 것이다.

📎 ref.

https://hyunseob.github.io/2017/12/12/typescript-type-inteference-and-type-assertion/

 

TypeScript: 타입 추론과 타입 단언

TypeScript 를 도입하기가 망설여지는 이유 중 하나는 매번 일일이 변수를 선언할 때마다 타입을 선언해야하고 필요한 타입을 정의해야하는 비용에 대한 걱정일 것이다. 필요한 타입이 있을 때 타

hyunseob.github.io

https://abangpa1ace.tistory.com/entry/TS%EA%B0%95%EC%9D%98-%EC%9E%85%EB%AC%B8-1-%EA%B0%9C%EC%9A%94-%EB%B0%8F-%EB%B0%B0%EA%B2%BD

 

[Typescript] 타입 단언 / 타입 가드 / 타입 호환

요즘 타입스크립트 강의를 들으며 개념을 상기하고 연습예제를 풀 준비를 하고 있다. 기본적인 내용들은 이전에 정리한 포스팅을 복기하였으나, 블로그에 남기지 않은 내용 중 중요한 부분을

abangpa1ace.tistory.com

 

반응형

댓글