Filter
Filter
는 튜플(T)과 필터링할 타입(F)을 받아 해당 타입에 해당하는 요소만 포함하는 새 튜플을 반환하는 TypeScript 유틸리티 타입입니다.
팁
튜플에서 특정 타입의 요소만 필터링하여 추출해야 할 때 유용합니다.
사용법
import { A } from 'utilscript';
type T = A.Filter<[0, 1, 2], 2>; // [2]
type T2 = A.Filter<[0, 1, 2], 0 | 1>; // [0, 1]
type T3 = A.Filter<[0, 1, 2], Falsy>; // [0]
주의 사항
경고
튜플이 아닌 일반 Array 타입이 입력으로 주어질 경우 예상과 다른 결과(빈 배열 []
)가 나올 수 있습니다.
import { A } from 'utilscript';
const arr = [1, 2, 3, 4, 5];
type T = A.Filter<typeof arr, 1>; // []
지원 버전
Filter
유틸리티 타입은 다음 버전부터 안정적으로 사용할 수 있습니다:
버전 | 지원 여부 |
---|---|
0.0.18+ | ✅ |
0.0.13+ | ✅ |
0.0.8+ | ✅ |
업데이트 내역
노트
0.0.18 버전부터 내부 로직의 성능이 개선되어 더 빠른 타입 계산이 가능해졌습니다.
노트
0.0.13 버전부터 any
타입과 readonly
속성을 가진 튜플에 대한 처리가 개선되었습니다. 이전 버전에서는 이러한 특수 케이스에 대한 처리가 제대로 되지 않았습니다.