TypeScript · Essencial · Inglês · Técnico
Partial
Utility type que cria um tipo igual ao original, mas com todas as propriedades opcionais. Serve para representar atualizações parciais de um objeto.
Onde usar
Comum em funções de update, em que o chamador passa só os campos alterados, como mudar(u, patch: Partial<U>). No corpo de um PATCH de API é o tipo natural.
Em código
interface U { id: number; nome: string }
function mudar(u: U, p: Partial<U>): U {
return { ...u, ...p };
}
mudar({ id: 1, nome: 'A' }, { nome: 'B' });Exemplos
The patch body is a Partial of the user.
O corpo do patch é um Partial do usuário.
Partial only makes the top-level fields optional.
Partial só deixa opcionais os campos do primeiro nível.
Cuidado
É raso: só afeta o primeiro nível, e objetos aninhados continuam exigindo todos os seus campos.
Antônimos
Required