Utility Types Essenciais (Parte 2): Dominando Pick, Omit, Exclude e Extract no TypeScript
Utility Types Essenciais (Parte 2): Dominando Pick, Omit, Exclude e Extract no TypeScript
Pick e Omit para estruturas de objetos, e Exclude e Extract para tipos de união. Você entenderá a diferença crucial entre filtrar propriedades versus filtrar uniões e como montar pipelines de DTOs blindados contra vazamento de dados sensíveis!
📑 Índice do Conteúdo
1. O Dilema Arquitetural: Objetos vs Uniões (A Linha Divisória)
Antes de escrever qualquer linha de código, existe uma distinção conceitual indispensável que separa desenvolvedores juniores de engenheiros sêniores de TypeScript:
| Utilitário | Alvo de Operação | Comportamento Semântico |
|---|---|---|
Pick<T, K> |
Objetos / Interfaces | Seleciona apenas as propriedades especificadas em K. |
Omit<T, K> |
Objetos / Interfaces | Remove as propriedades especificadas em K e mantém o restante. |
Exclude<T, U> |
Union Types (Uniões) | Exclui de uma união T todos os membros atribuíveis a U. |
Extract<T, U> |
Union Types (Uniões) | Extrai de uma união T apenas os membros atribuíveis a U. |
Omit para filtrar uma união de strings (ex: Omit<"a" | "b", "a"> falhará com erro inesperado de objeto). Para uniões, use sempre Exclude! Da mesma forma, nunca passe uma interface inteira como argumento para o Exclude.
2. Pick<T, K>: Seleção Cirúrgica de Propriedades
O utilitário Pick<T, K> constrói um novo tipo contendo apenas o subconjunto de propriedades K escolhidas a partir do tipo base T:
// Definição interna oficial:
// type Pick<T, K extends keyof T> = { [P in K]: T[P]; };
interface Colaborador {
id: string;
matricula: number;
nomeCompleto: string;
emailCorporativo: string;
salarioBruto: number;
dataAdmissao: Date;
senhaHash: string;
}
// 1. Criando um cartão público de exibição: precisamos apenas do ID, nome e email
type CartaoPublicoColaborador = Pick<Colaborador, "id" | "nomeCompleto" | "emailCorporativo">;
const cracha: CartaoPublicoColaborador = {
id: "EMP-2026-09",
nomeCompleto: "Juliana Mendes",
emailCorporativo: "[email protected]"
};
// Se tentar acessar campos que não foram selecionados:
// @ts-expect-error - "salarioBruto" não existe em CartaoPublicoColaborador
console.log(cracha.salarioBruto);
3. Omit<T, K>: Exclusão Segura e Sanitização de DTOs
O Omit<T, K> é o inverso exato do Pick. Ele recebe uma interface e remove as chaves que você não deseja, preservando todas as demais:
type Omit<T, K extends keyof any> = Pick<T, Exclude<keyof T, K>>;Ele extrai todas as chaves de
T com keyof T, remove as chaves K usando o utilitário Exclude e, por fim, aplica o Pick nas chaves restantes. Uma obra-prima de composição funcional de tipos!
// Em uma rota POST para cadastrar um novo colaborador:
// Não queremos que o usuário envie o "id" (gerado pelo banco) nem a "dataAdmissao":
type CriarColaboradorPayload = Omit<Colaborador, "id" | "dataAdmissao">;
function cadastrarNovoColaborador(dados: CriarColaboradorPayload): Colaborador {
return {
...dados,
id: `ID-${Math.random().toString(36).substring(2, 9)}`,
dataAdmissao: new Date()
};
}
4. Exclude<T, U>: Filtragem Negativa sobre Uniões
O Exclude<T, U> opera sobre tipos de união (Union Types). Ele percorre cada membro da união T e descarta qualquer membro que seja atribuível ao tipo U:
// Definição interna:
// type Exclude<T, U> = T extends U ? never : T;
type EventosGerais = "MOUSE_CLICK" | "MOUSE_MOVE" | "KEY_DOWN" | "KEY_UP" | "WINDOW_RESIZE" | "SCROLL";
// Queremos monitorar apenas eventos de interação direta do usuário, descartando resize e scroll:
type EventosInteracao = Exclude<EventosGerais, "WINDOW_RESIZE" | "SCROLL">;
// Resultado: "MOUSE_CLICK" | "MOUSE_MOVE" | "KEY_DOWN" | "KEY_UP"
// Filtrando tipos heterogêneos de uma união de respostas de API:
type RespostaBruta = string | number | boolean | Error | { token: string };
type RespostaValida = Exclude<RespostaBruta, Error>;
// Resultado: string | number | boolean | { token: string }
5. Extract<T, U>: Filtragem Positiva e Interseção de Uniões
O Extract<T, U> é o parceiro complementar do Exclude. Em vez de descartar, ele preserva apenas os membros da união T que correspondem ao critério U:
// Definição interna:
// type Extract<T, U> = T extends U ? T : never;
type CodigosStatusHTTP = 200 | 201 | 204 | 301 | 302 | 400 | 401 | 403 | 404 | 500 | 502;
// Extrair apenas os códigos da família 4xx (Erros de Cliente):
type ErrosCliente = Extract<CodigosStatusHTTP, 400 | 401 | 403 | 404>;
// Resultado: 400 | 401 | 403 | 404
// Extrair apenas funções de uma união de tipos variados:
type ValoresMistos = string | number | (() => void) | ((x: number) => string) | Date;
type ApenasFuncoes = Extract<ValoresMistos, Function>;
// Resultado: (() => void) | ((x: number) => string)
6. Exemplo Enterprise: Arquitetura Completa de DTOs para CRUD
Vamos construir a arquitetura padrão adotada em sistemas de alta escala (Clean Architecture / NestJS / Prisma): partindo de uma única entidade rica de banco de dados, derivamos cirurgicamente todos os DTOs do ciclo de vida da entidade sem duplicar nenhuma interface:
// 1. Entidade Mestre do Domínio (Modelo Completo do Banco de Dados)
interface EntidadeProduto {
id: string;
sku: string;
nome: string;
descricao: string;
precoCentavos: number;
estoqueDisponivel: number;
categoria: "ELETRONICOS" | "LIVROS" | "VESTUARIO" | "ALIMENTOS";
status: "RASCUNHO" | "ATIVO" | "DESCONTINUADO" | "BLOQUEADO";
dataCriacao: Date;
dataUltimaAtualizacao: Date;
}
// 2. DTO de Criação (POST /produtos):
// Remove chaves autogeradas pelo banco (id, datas) e força status inicial padrão
type CriarProdutoDTO = Omit<EntidadeProduto, "id" | "dataCriacao" | "dataUltimaAtualizacao" | "status">;
// 3. DTO de Atualização (PATCH /produtos/:id):
// O ID é obrigatório para localizar o registro, mas todos os outros campos editáveis são opcionais
type AtualizarProdutoDTO = Pick<EntidadeProduto, "id"> & Partial<Omit<EntidadeProduto, "id" | "dataCriacao">>;
// 4. DTO de Vitrine Pública (GET /catalogo):
// Não expõe custo interno, estoque real nem metadados administrativos
type ProdutoVitrineDTO = Pick<EntidadeProduto, "id" | "sku" | "nome" | "precoCentavos" | "categoria">;
// 5. Filtro de Categorias Físicas (excluindo produtos puramente digitais com Exclude):
type CategoriasProdutosFisicos = Exclude<EntidadeProduto["categoria"], "ELETRONICOS">;
// Demonstração do Serviço:
class ServicoCatalogoProdutos {
public async criar(dto: CriarProdutoDTO): Promise<EntidadeProduto> {
console.log(`[CRIANDO PRODUTO] SKU: ${dto.sku}, Preço: ${dto.precoCentavos}`);
return {
...dto,
id: "PRD-2026-X8",
status: "RASCUNHO",
dataCriacao: new Date(),
dataUltimaAtualizacao: new Date()
};
}
public async atualizar(dto: AtualizarProdutoDTO): Promise<void> {
console.log(`[ATUALIZANDO PRODUTO #${dto.id}] Alterando campos enviados.`);
}
}
7. Armadilhas Comuns e Boas Práticas Sênior
- A Flexibilidade Perigosa do
Omit: A assinatura doOmit<T, K extends keyof any>aceita qualquer string emK, mesmo chaves que não existem emT. Se você cometer um erro de digitação comoOmit<Usuario, "nomme">, o compilador não emitirá erro! Para projetos ultra-estritos, você pode criar uma versão tipada:type StrictOmit<T, K extends keyof T> = Omit<T, K>;. - Composição de Pick com Partial: Ao criar formulários de edição, o padrão
Pick<T, "id"> & Partial<Omit<T, "id">>é o padrão ouro da indústria: o identificador permanece estritamente obrigatório, enquanto todos os demais atributos tornam-se opcionais para atualizações atômicas.
Resumo da Lição 34
Pick<T, K>seleciona propriedades específicas de um objeto ou interface.Omit<T, K>remove propriedades específicas de um objeto, mantendo todas as demais.Exclude<T, U>atua sobre Union Types, removendo membros atribuíveis aU.Extract<T, U>atua sobre Union Types, isolando apenas os membros compatíveis comU.- Essa combinação permite a criação de DTOs de APIs robustos, evitando a exposição indevida de dados sigilosos e prevenindo o Interface Sprawl.
📝 Exercício Prático Desafiador da Lição 34
Imagine uma entidade de banco de dados TransacaoFinanceira com as propriedades: id, faturaId, pagadorCpf, valorCentavos, chavePix, cartaoNumeroHash, dataCriacao e status (sendo "PENDENTE" | "APROVADO" | "RECUSADO" | "ESTORNADO" | "FRAUDE_SUSPEITA").
1. Crie o DTO NovaTransacaoPIX utilizando Omit para remover campos desnecessários (como os dados de cartão e metadados internos).
2. Crie uma união StatusCriticos utilizando Extract para isolar apenas os estados que exigem atenção de segurança ("RECUSADO" | "FRAUDE_SUSPEITA").
Aplique o que você aprendeu nesta lição
Utilize nossas ferramentas online gratuitas para experimentar os conceitos ou teste o código ao vivo no Playground IDE.
Editor de Códigos Web Online
Ambiente com destaque de sintaxe para você testar tags, tabelas e scripts na hora.
Abrir Ferramenta OnlinePlayground Web Online
Escreva seu código HTML, CSS ou JavaScript e veja o resultado renderizado ao vivo no navegador com zero configuração.
⚡ Codificar no Playground IDE