ExpertiDict

TypeScript · Essencial · Inglês · Técnico

readonly

/ˈɹiːdˌoʊnli/palavra-chave

Modificador que impede reatribuir uma propriedade depois da inicialização ou, em arrays e tuplas, impede mutações. A proteção vale só na compilação.

Onde usar

Usado em props, estado imutável e configurações: readonly id: string. Ao receber um array que não vai alterar, tipar como readonly string[] documenta a intenção para quem chama.

Em código

interface Pt {
  readonly x: number;
  readonly y: number;
}
const p: Pt = { x: 1, y: 2 };
// p.x = 5; // erro: somente leitura

Exemplos

Mark the id as readonly so nobody reassigns it.

Marque o id como readonly para ninguém reatribuí-lo.

readonly only exists at compile time, it doesn't freeze the object.

readonly só existe na compilação, ele não congela o objeto.

Cuidado

readonly é raso e só existe no tipo: não congela o objeto em runtime (isso é Object.freeze) e não impede alterar o conteúdo de um objeto aninhado.

Sinônimos

somente leitura

Veja também

Todos os termos de TypeScript