Restrições genéricas: restringindo parâmetros de tipo

Boas-vindas

Recapitulação das restrições

function len<T extends { length: number }>(val: T): number {
  return val.length;
}

Restringindo a métodos específicos

interface Stringable { toString(): string; }
function stringify<T extends Stringable>(val: T): string {
  return val.toString();
}

Inferindo a partir de uma restrição

function pluck<T, K extends keyof T>(items: T[], key: K): T[K][] {
  return items.map(item => item[key]);
}
const names = pluck(users, 'name'); // string[]

Restrições de tipos de ordem superior (simuladas)

Restringindo a tipos primitivos

type Primitive = string | number | boolean | bigint | symbol | null | undefined;
function isPrimitive<T extends Primitive>(val: T): true { return true; }

Restrições recursivas

interface Comparable<T> { compareTo(other: T): number; }
function sort<T extends Comparable<T>>(items: T[]): T[] {
  return [...items].sort((a, b) => a.compareTo(b));
}

Restrição com valor padrão

function process<T extends object = Record<string, unknown>>(data: T): void {
  console.log(Object.keys(data));
}

T extends Record<string, unknown>

function getValue<T extends Record<string, unknown>>(obj: T, key: string): unknown {
  return obj[key];
}

Inferência de restrições nos tipos de retorno

function firstKey<T extends object>(obj: T): keyof T {
  return Object.keys(obj)[0] as keyof T;
}

Utilitário NoInfer (TS 5.4)

function createState<T>(initial: T, fallback: NoInfer<T>): T {
  return initial ?? fallback;
}

Verificação rápida

Recapitulação