Pick, Omit, Exclude e Extract no TypeScript: Guia
⚡ Curso de TypeScript • Web-ZoneWare

Utility Types Essenciais (Parte 2): Dominando Pick, Omit, Exclude e Extract no TypeScript

Lição 34 de 50

Utility Types Essenciais (Parte 2): Dominando Pick, Omit, Exclude e Extract no TypeScript

Módulo 5: Utility Types, Decorators & Metaprogramação
Lição 34 de 50
Nível: Avançado
⏱ Tempo de Leitura e Prática: 30 minutos

Utility Types Essenciais (Parte 2): Dominando Pick, Omit, Exclude e Extract no TypeScript

💡
O Que Você Vai Aprender Hoje: Na Lição 33, aprendemos a alterar modificadores e criar dicionários. Hoje, você dominará os quatro utilitários mais fundamentais para selecionar, recortar e filtrar dados em projetos enterprise: 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!

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.
⚠
Erro Comum de Iniciante: Nunca tente usar 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:

TypeScript: Definição Interna e Uso Prático de Pick

TypeScript 25 linhas
// 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:

📚
Como o TypeScript implementa o Omit por debaixo dos panos:
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!

TypeScript: Sanitização de Payloads com Omit

TypeScript 11 linhas
// 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:

TypeScript: Filtrando Uniões com Exclude

TypeScript 13 linhas
// 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:

TypeScript: Extraindo Subconjuntos com Extract

TypeScript 13 linhas
// 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:

TypeScript: Arquitetura Enterprise de DTOs com Pick, Omit e Exclude

TypeScript 46 linhas
// 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.`);
    }
}
⚗️ Teste no Playground IDE Web-ZoneWare
Crie DTOs com Pick e Omit, teste exclusões de uniões com Exclude e veja erros de chaves em tempo real.

Abrir Playground TypeScript →

7. Armadilhas Comuns e Boas Práticas Sênior

  • A Flexibilidade Perigosa do Omit: A assinatura do Omit<T, K extends keyof any> aceita qualquer string em K, mesmo chaves que não existem em T. Se você cometer um erro de digitação como Omit<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 a U.
  • Extract<T, U> atua sobre Union Types, isolando apenas os membros compatíveis com U.
  • 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").

🛠️ Laboratório Prático & Prática Imediata

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.

💻 Desenvolvedor & Código

Editor de Códigos Web Online

Ambiente com destaque de sintaxe para você testar tags, tabelas e scripts na hora.

Abrir Ferramenta Online
⚡ Live Code Studio

Playground 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
Foto de Web-Zoneware
✓ Verificado
🎓 Tutor & Coordenador da Web Academy

Web-Zoneware

Tutor Técnico & Desenvolvedor Full-Stack

Desenvolvedor web e instrutor focado na formação prática de novos programadores. Defensor ferrenho de código semântico, arquitetura limpa e acessibilidade W3C/WCAG, dedicando-se a construir cursos estruturados em metodologia passo a passo com execução ao vivo no Playground IDE.

Especialidades: HTML5 Semântico CSS3 & Flexbox/Grid JavaScript Moderno Acessibilidade WCAG 2.2 Didática Prática
Rolar para cima