TypeScript · Essencial · Inglês · Técnico
readonly
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 leituraExemplos
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