본문으로 건너뛰기

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 속성을 가진 튜플에 대한 처리가 개선되었습니다. 이전 버전에서는 이러한 특수 케이스에 대한 처리가 제대로 되지 않았습니다.