03 고급 타입
3.1 타입스크립트만의 독자적 타입 시스템
타입의 계층 구조를 그림으로 나타내면 다음과 같다.
1. any 타입
any 타입은 자바스크립트에 존재하는 모든 값을 오류 없이 받을 수 있다.
any 타입은 타입스크립트로 달성하고자 하는 정적 타이핑을 무색하게 만들 수 있다.
따라서 any 타입을 변수에 할당하는 것은 지양해야 할 패턴으로 알려져 있다.
하지만 타입스크립트에서 any 타입을 어쩔 수 없이 사용해야 할 때가 있는데 대표적으로 3가지 사례를 들 수 있다.
개발 단계에서 임시로 값을 지정해야 할 때
매우 복잡한 구성 요소로 이루어진 개발 과정에서 추후 값이 변경될 가능성이 있거나 아직 세부 항목에 대한 타입이 확정되지 않은 경우가 생길 수 있다.
이럴 때 해당 값을 any로 지정하면 경고 없이 개발을 계속할 수 있다.
하지만 any 타입으로 지정하고 나서 다른 타입으로 바꾸는 과정이 누락되면 문제가 발생할 수 있으므로 주의해야 한다.
어떤 값을 받아올지 또는 넘겨줄지 정할 수 없을 때
예를 들어 API 요청 및 응답 처리, 콜백 함수 전달, 타입이 잘 정제되지 않아 파악이 힘든 외부 라이브러리 등을 사용할 때는 어떤 인자를 주고받을지 특정하기 힘들다.
이처럼 주고받을 값이 명확하지 않을 때 열린 타입(any 타입)을 선언해야 할 수 있다.
값을 예측할 수 없을 때 암묵적으로 사용
외부 라이브러리나 웹 API의 요청에 따라 다양한 값을 반환하는 API가 존재할 수 있다.
대표적인 예로 브라우저의 Fetch API를 들 수 있다.
Fetch API의 일부 메서드는 요청 이후의 응답을 특정 포맷으로 파싱하는데 이때 반환 타입이 any로 매핑되어 있는 것을 볼 수 있다.
2. unknown 타입
unknown 타입은 any 타입과 유사하게 모든 타입의 값이 할당될 수 있다.
그러나 any를 제외한 다른 타입으로 선언된 변수에는 unknown 타입 값을 할당할 수 없다.
let unknownValue: unknown
unknownValue = 100
unknownValue = 'hello world'
unknownValue = () => console.log('this is any type')
let someValue1: any = unknownValue
let someValue2: number = unknownValue // Error: Type 'unknown' is not assignable to type 'number'.
let someValue3: string = unknownValue // Error: Type 'unknown' is not assignable to type 'string'.
unknown 타입은 이름처럼 무엇이 할당될지 아직 모르는 상태의 타입을 말한다.
이렇게만 보면 any 타입과 비슷한데 왜 unknown 타입이 추가되었을까?
// 할당하는 시점에서는 에러가 발생하지 않음
const unknownFunction: unknown = () => console.log('this is unknown type')
// 하지만 실행 시에는 에러가 발생함
unknownFunction() // Error: 'unknownFunction' is of type 'unknown'.
unknown 타입으로 할당된 변수는 어떤 값이든 올 수 있음을 의미하는 동시에, 개발자에게 엄격한 타입 검사를 강제하는 의도를 담고 있다.
나중에 any 타입을 특정 타입으로 수정해야 하는 것을 깜빡하고 누락하면 어떤 값이든 전달될 수 있기 때문에 런타임에 예상치 못한 버그가 발생할 가능성이 높아진다는 것도 설명했다.
unknown 타입은 이러한 상황을 보완하기 위해 등장한 타입이다.
타입 검사를 강제하고 타입이 식별된 후에 사용할 수 있기 때문에 any 타입보다 더 안전하다.
Q. unknown은 어떨 때 사용할 수 있을까요?
- 배달이팀: 강제 타입 캐스팅을 통해 타입을 전환할 때 사용합니다.
const env = process.env as unknown as ProcessEnv같은 식으로요.
unknown은 모든 타입의 슈퍼타입이라서 타입 캐스팅이 호환된다.
3. void 타입
자바스크립트에서는 함수에서 명시적인 반환문을 작성하지 않으면 기본적으로 undefined가 반환된다.
하지만 타입스크립트에서는 void 타입이 사용되는데 이것은 undefined가 아니다.
타입스크립트에서 함수가 어떤 값을 반환하지 않는 경우에는 void를 지정하여 사용한다고 생각하면 된다.
void 타입은 변수에도 할당할 수 있지만 함수가 아닌 값에 대해서는 대부분 무의미하다.
void 타입으로 지정된 변수는 undefined 또는 null 값만 할당할 수 있다.
그런데 만약 tsconfig.json에서 strictNullChecks 옵션이 설정되었거나 컴파일 시 해당 플래그 설정이 실행되는 경우에는 null 값을 할당할 수 없다.
또한 명시적인 의미를 부여하는 관점에서 undefined와 null 타입 키워드를 직접 사용해서 타입을 지정하는 것이 더 바람직하다.
4. never 타입
never 타입은 값을 반환할 수 없는 타입을 말한다.
여기서 값을 반환하지 않는 것과 반환할 수 없는 것을 명확히 구분해야 한다.
자바스크립트에서 값을 반환할 수 없는 예는 크게 2가지로 나눌 수 있다.
에러를 던지는 경우
throw 키워드를 사용하면 런타임에 에러를 발생시킬 수 있는데, 이는 값을 반환하는 것으로 간주하지 않는다.
따라서 특정 함수가 실행 중 마지막에 에러를 던지는 작업을 수행한다면 해당 함수의 반환 타입은 never이다.
function generateError(res: Response): never {
throw new Error(res.getMessage())
}
무한히 함수가 실행되는 경우
드물지만 함수 내에서 무한 루프를 실행하는 경우가 있을 수 있다.
무한 루프는 결국 함수가 종료되지 않음을 의미하기 때문에 값을 반환하지 못한다.
function checkStatus(): never {
while (true) {
// ...
}
}
never 타입은 모든 타입의 하위 타입이다.
즉, never 자신을 제외한 어떤 타입도 never 타입에 할당될 수 없다는 것을 의미한다.
심지어 any 타입이라 할지라도 never 타입에 할당될 수 없다.
5. Array 타입
배열 타입을 가리키는 Array 키워드는 자바스크립트에서도 Object.prototype.toString.call(…) 연산자를 사용하여 확인할 수 있다.
Object.prototype.toString.call(…) 함수는 객체의 타입을 알아내는 데 사용하는 함수이다.
typeof를 사용하여 타입을 알 수도 있지만, 이 함수를 사용하는 이유는 typeof의 경우 객체 타입을 단순히 object 타입으로 알려주지만, Object.prototype.toString.call(…) 함수는 객체의 인스턴스까지 알려주기 때문이다.
const arr = []
console.log(typeof arr) // 'object'
console.log(Object.prototype.toString.call(arr)) // '[object Array]'
엄밀히 말하면 자바스크립트에서는 배열을 객체에 속하는 타입으로 분류한다.
즉, 자바스크립트에서는 배열을 단독으로 배열이라는 자료형에 국한하지 않는다.
타입스크립트에서 Array라는 타입을 사용하기 위해서는 타입스크립트의 특수한 문법을 함께 다뤄야 한다.
const array1: number[] = [1, 2, 3] // 숫자에 해당하는 원소만 허용한다
const array2: Array<number> = [1, 2, 3] // number[]와 동일한 타입이다
만약 숫자형과 문자열 등 여러 타입을 모두 관리해야 하는 배열을 선언하려면 유니온 타입을 사용할 수 있다.
const array1: Array<number | string> = [1, 'string']
const array2: number[] | string[] = [1, 'string']
// 후자의 방식은 아래와 같이 선언할 수도 있다
const array3: (number | string)[] = [1, 'string']
타입스크립트에서 배열 타입을 명시하는 것만으로 배열의 길이까지는 제한할 수 없다.
그러나 튜플은 배열 타입의 하위 타입으로 기존 타입스크립트의 배열 기능에 길이 제한까지 추가한 타입 시스템이라고 볼 수 있다.
대괄호 안에 타입 시스템을 기술하는 것이 배열 타입과 유일하게 다른 점이다.
이때 대괄호 안에 선언하는 타입의 개수가 튜플이 가질 수 있는 원소의 개수를 나타낸다.
즉, 튜플은 배열의 특정 인덱스에 정해진 타입을 선언하는 것과 같다.
let tuple: [number] = [1]
tuple = [1, 2]
// Error: Type '[number, number]' is not assignable to type '[number]'.
// Error: Source has 2 element(s) but target allows only 1.
tuple = [1, 'string']
// Error: Type '[number, string]' is not assignable to type '[number]'.
// Error: Source has 2 element(s) but target allows only 1.
let tuple: [number, string, boolean] = [1, 'string', true] // 여러 타입과 혼합도 가능하다
튜플의 유용한 쓰임새를 알아보기 위해 사용자 인터페이스를 만들기 위한 자바스크립트 라이브러리인 리액트 예시를 살펴보자.
리액트는 16.8 버전부터 도입된 훅이라는 요소 중 useState는 튜플 타입을 반환한다.
첫 번째 원소는 훅으로부터 생성 및 관리되는 상태 값을 의미하고, 두 번째 원소는 해당 상태를 조작할 수 있는 세터(setter)를 의미한다.
useState API는 배열 원소의 자리마다 명확한 의미를 부여하기 때문에 컴포넌트에서 사용하지 않은 값에 접근하는 오류를 방지할 수 있다.
또한 구조 분해 할당을 사용해서 사용자가 자유롭게 이름을 정의할 수 있다.
import { useState } from 'react'
const [value, setValue] = useState(false)
const [username, setUsername] = useState('')
첫 번째 원소와 두 번째 원소의 타입과 의미가 명확하기 때문에 사용자는 그 의미에 맞게 적합한 이름을 선언하여 값을 가져올 수 있다.
구조 분해 할당은 배열뿐만 아니라 객체에 대해서도 적용할 수 있다.
순서에 의존하지 않고 필요한 값만 가져와야 하는 경우 객체 구조 분해 할당 방식이 더 유용할 수 있다.
const useStateWithObject = (initialValue: any) => {
// ...
return { value, setValue }
}
const { value, setValue } = useStateWithObject(false) // 해당 함수에서 정의된 속성 이름으로 가져와야 한다
const { value: username, setValue: setUsername } = useStateWithObject('') // 사용자 정의 이름으로 사용하고 싶다면 일차적으로 먼저 접근한 다음에 다른 이름으로 지정할 수 있다
튜플과 배열의 성질을 혼합해서 사용할 수도 있다.
다음과 같이 스프레드 연산자(…)를 사용하여 특정 인덱스에서 요소를 명확한 타입으로 선언하고 나머지 인덱스에서는 배열처럼 동일한 자료형의 원소를 개수 제한 없이 받도록 할 수 있다.
const httpStatusFromPaths: [number, string, ...string[]] = [
400,
'Bad Request',
'/users/:id',
'/users/:userId',
'/users/:uuid',
]
// 첫 번째 자리는 숫자, 두 번째 자리는 문자열을 받아야 하고, 그 이후로는 문자열 타입의 원소를 개수 제한 없이 받을 수 있다.
또한 옵셔널 프로퍼티(선택적 속성)을 명시하고 싶다면 물음표(?) 기호와 함께 해당 속성을 선언할 수 있다.
해당 원소는 옵셔널하기 때문에 해당 인덱스에 필수적으로 자리 잡고 있지 않을 수 있음을 의미한다.
const optionTuple1: [number, number, number?] = [1, 2]
const optionTuple2: [number, number, number?] = [1, 2, 3] // 3번째 인덱스에 해당하는 숫자형 원소는 있어도 되괴 없어도 됨을 의미한다
옵셔널(optional)
특정 속성 또는 매개변수가 값이 있을 수도 있고 없을 수도 있는 것을 의미한다.
즉, 선택적 매개변수(옵셔널 파라미터) 또는 선택적 속성(옵셔널 프로퍼티)은 필수적으로 존재하지 않아도 되며 선택적으로 사용될 수 있음을 나타낸다.
선택적 속성은 해당 속성에 값을 할당하지 않아도 되고 해당 속성이 없어도 오류가 발생하지 않는다.
이는 타입스크립트에서 좀 더 유연한 데이터 모델링과 사용자 정의 타입을 지원하기 위한 개념이다.
6. enum 타입
enum은 일종의 구조체를 만드는 타입 시스템이다.
enum을 사용해서 열거형을 정의할 수 있는데 열거형은 각각의 멤버를 가지고 있다.
타입스크립트는 명명한 각 멤버의 값을 스스로 추론한다.
기본적인 추론 방식은 숫자 0부터 1씩 늘려가며 값을 할당하는 것이다.
enum ProgrammingLanguage {
Typescript, // 0
Javascript, // 1
Java, // 2
Python, // 3
Kotlin, // 4
Rust, // 5
Go, // 6
}
// 각 멤버에게 접근하는 방식은 자바스크립트에서 객체의 속성에 접근하는 방식과 동일하다
ProgrammingLanguage.Typescript // 0
ProgrammingLanguage.Rust // 5
ProgrammingLanguage['Go'] // 6
// 또한 역방향으로도 접근이 가능하다
ProgrammingLanguage[2] // 'Java'
enum 타입은 주로 문자열 상수를 생성하는 데 사용된다.
이를 통해 응집력있는 집합 구조체를 만들 수 있으며, 사용자 입장에서도 간편하게 활용할 수 있다.
또한 열거형은 그 자체로 변수 타입으로 지정할 수 있다.
이때 열거형을 타입으로 가지는 변수는 해당 열거형이 가지는 모든 멤버를 값으로 받을 수 있다.
이런 특성은 코드의 가독성을 높여준다.
enum ItemStatusType {
배송_보류 = 'DELIVERY_HOLD',
배송_준비_중 = 'DELIVERY_READY',
배송_중 = 'DELIVERING',
배송_완료 = 'DELIVERED',
}
const checkItemAvailable = (itemStatus: ItemStatusType) => {
switch (itemStatus) {
case ItemStatusType.배송_보류:
case ItemStatusType.배송_준비_중:
case ItemStatusType.배송_중:
return false
case ItemStatusType.배송_완료:
default:
return true
}
}
checkItemAvailable 함수의 인자인 itemStatus는 ItemStatusType 열거형을 타입으로 가진다.
이를 통해 얻을 수 있는 효과는 itemStatus의 타입이 문자열로 지정된 경우와 비교했을 때 다음과 같다.
- 타입 안정성: ItemStatusType에 명시되지 않은 다른 문자열은 인자로 받을 수 없다. 따라서 타입 안정성이 우수하다.
- 명확한 의미 전달과 높은 응집력: ItemStatusType 타입이 다루는 값이 무엇인지 명확하다. 아이템 상태에 대한 값을 모아놓은 것으로 응집력이 뛰어나다.
- 가독성: 응집도가 높기 때문에 말하고자 하는 바가 더욱 명확하다. 따라서 열거형 멤버를 통해 어떤 상태를 나타내는지 쉽게 이해할 수 있다.
이처럼 열거형은 관련이 높은 멤버를 모아 문자열 상수처럼 사용하고자 할 때 유용하게 쓸 수 있다.
다만 열거형을 사용할 때는 주의해야 할 점이 있다.
숫자로만 이루어져 있거나 타입스크립트가 자동으로 추론한 열거형은 안전하지 않은 결과를 낳을 수 있다.
맨 처음 예시를 보면 역방향으로도 접근할 수 있음을 알 수 있다.
여기서 할당된 값을 넘어서는 범위로 역방향으로 접근하더라도 타입스크립트는 막지 않는다.
이러한 동작을 막기 위해 const enum으로 열거형을 선언하는 방법이 있다.
이 방식은 역방향으로의 접근을 허용하지 않기 때문에 자바스크립트에서의 객체에 접근하는 것과 유사한 동작을 보장한다.
그러나 const enum으로 열거형을 선언하더라도 숫자 상수로 관리되는 열거형은 선언한 값 이외의 값을 할당하거나 접근할 때 이를 방지하지 못한다.
반면 문자열 상수 방식으로 선언한 열거형은 미리 선언하지 않은 멤버로 접근을 방지한다.
문자열 상수 방식으로 열거형을 사용하는 것이 숫자 상수 방식보다 더 안전하며 의도하지 않은 값의 할당이나 접근을 방지하는 데 도움이 된다.
const enum NUMBER {
ONE = 1,
TWO = 2,
}
const myNumber: NUMBER = 100 // NUMBER enum에 정의되지 않은 값이지만, 숫자형 enum은 컴파일 시점에 값이 인라인 처리되어 타입 오류가 발생하지 않을 수 있다. (참고: 타입스크립트 프로그래밍 49p)
const enum STRING_NUMBER {
ONE = 'ONE',
TWO = 'TWO',
}
const myStringNumber: STRING_NUMBER = 'THREE' // Error
이외에도 열거형의 가장 큰 문제는 따로 존재한다.
앞서 열거형은 타입 공간과 값 공간에서 모두 사용된다고 말했다.
열거형은 타입스크립트 코드가 자바스크립트로 변환될 때 즉시 실행 함수(IIFE) 형식으로 변환되는 것을 볼 수 있다.
이때 일부 번들러에서 트리쉐이킹 과정 중 즉시 실행 함수로 변환된 값을 사용하지 않는 코드로 인식하지 못하는 경우가 발생할 수 있다.
따라서 불필요한 코드의 크기가 증가하는 결과를 초래할 수 있다.
이러한 문제를 해결하기 위해 const enum 또는 as const assertion을 사용해서 유니온 타입으로 열거형과 동일한 효과를 얻는 방법이 있다.