Tipos mapeados

Quando você não quer se repetir, às vezes um tipo precisa ser baseado em outro tipo.

Tipos mapeados são construídos sobre a sintaxe de assinaturas de índice, que servem para declarar os tipos de propriedades que não foram declaradas antecipadamente:

ts
type OnlyBoolsAndHorses = {
[key: string]: boolean | Horse;
};
 
const conforms: OnlyBoolsAndHorses = {
del: true,
rodney: false,
};
Try

Um tipo mapeado é um tipo genérico que usa uma união de PropertyKeys (geralmente criada via keyof) para percorrer as chaves e criar um tipo:

ts
type OptionsFlags<Type> = {
[Property in keyof Type]: boolean;
};
Try

Neste exemplo, OptionsFlags pega todas as propriedades do tipo Type e muda os valores delas para booleano.

ts
type Features = {
darkMode: () => void;
newUserProfile: () => void;
};
 
type FeatureOptions = OptionsFlags<Features>;
type FeatureOptions = { darkMode: boolean; newUserProfile: boolean; }
Try

Modificadores de mapeamento

Existem dois modificadores adicionais que podem ser aplicados durante o mapeamento: readonly e ?, que afetam, respectivamente, a mutabilidade e a opcionalidade.

Você pode remover ou adicionar esses modificadores com o prefixo - ou +. Se você não colocar um prefixo, o + é assumido.

ts
// Removes 'readonly' attributes from a type's properties
type CreateMutable<Type> = {
-readonly [Property in keyof Type]: Type[Property];
};
 
type LockedAccount = {
readonly id: string;
readonly name: string;
};
 
type UnlockedAccount = CreateMutable<LockedAccount>;
type UnlockedAccount = { id: string; name: string; }
Try
ts
// Removes 'optional' attributes from a type's properties
type Concrete<Type> = {
[Property in keyof Type]-?: Type[Property];
};
 
type MaybeUser = {
id: string;
name?: string;
age?: number;
};
 
type User = Concrete<MaybeUser>;
type User = { id: string; name: string; age: number; }
Try

Remapeamento de chaves via as

A partir do TypeScript 4.1, você pode remapear chaves em tipos mapeados com uma cláusula as dentro do tipo mapeado:

ts
type MappedTypeWithNewProperties<Type> = {
[Properties in keyof Type as NewKeyType]: Type[Properties]
}

Você pode usar recursos como tipos de template literal para criar novos nomes de propriedade a partir dos anteriores:

ts
type Getters<Type> = {
[Property in keyof Type as `get${Capitalize<string & Property>}`]: () => Type[Property]
};
 
interface Person {
name: string;
age: number;
location: string;
}
 
type LazyPerson = Getters<Person>;
type LazyPerson = { getName: () => string; getAge: () => number; getLocation: () => string; }
Try

Você pode filtrar chaves produzindo never por meio de um tipo condicional:

ts
// Remove the 'kind' property
type RemoveKindField<Type> = {
[Property in keyof Type as Exclude<Property, "kind">]: Type[Property]
};
 
interface Circle {
kind: "circle";
radius: number;
}
 
type KindlessCircle = RemoveKindField<Circle>;
type KindlessCircle = { radius: number; }
Try

Você pode mapear sobre uniões arbitrárias, não apenas uniões de string | number | symbol, mas uniões de qualquer tipo:

ts
type EventConfig<Events extends { kind: string }> = {
[E in Events as E["kind"]]: (event: E) => void;
}
 
type SquareEvent = { kind: "square", x: number, y: number };
type CircleEvent = { kind: "circle", radius: number };
 
type Config = EventConfig<SquareEvent | CircleEvent>
type Config = { square: (event: SquareEvent) => void; circle: (event: CircleEvent) => void; }
Try

Exploração adicional

Tipos mapeados funcionam bem com outros recursos desta seção de manipulação de tipos. Por exemplo, aqui está um tipo mapeado que usa um tipo condicional, que retorna true ou false dependendo de o objeto ter a propriedade pii definida com o literal true:

ts
type ExtractPII<Type> = {
[Property in keyof Type]: Type[Property] extends { pii: true } ? true : false;
};
 
type DBFields = {
id: { format: "incrementing" };
name: { type: string; pii: true };
};
 
type ObjectsNeedingGDPRDeletion = ExtractPII<DBFields>;
type ObjectsNeedingGDPRDeletion = { id: false; name: true; }
Try

The TypeScript docs are an open source project. Help us improve these pages by sending a Pull Request ❤

Contributors to this page:
OTOrta Therox  (7)
SFSergey Falinsky  (2)
UMDFUlisses, Mago do Flutter  (1)
Nnavya9singh  (1)
LLuke  (1)
7+

Last updated: Nov 16, 2026