`as const` în TypeScript

Aserțiuni și operatori pentru null TypeScript 3.4

Face un literal complet readonly și păstrează valorile exacte ca tipuri: "Iași" în loc de string.

Sintaxă

const x = { a: 1, b: "text" } as const;
const lista = ["a", "b"] as const;

Ce face `as const`

as const pus după un obiect sau un tablou literal spune: „valoarea aceasta nu se va schimba”. TypeScript face trei lucruri: toate proprietățile devin readonly (la orice adâncime), tablourile devin tuple-uri readonly, iar valorile își păstrează tipul literal ("Iași", 200) în loc de tipul general (string, number).

Este felul obișnuit de a defini constante din care derivi tipuri: o listă de orașe din care faci un union cu (typeof ORASE)[number], un obiect de coduri din care faci un union cu (typeof CODURI)[keyof typeof CODURI]. Este o alternativă la enum care nu generează cod special.

Ca orice aserțiune de tip, as const lucrează doar la compilare; la rulare obiectul se poate modifica în continuare (pentru asta există Object.freeze). Se poate pune doar pe literale, nu pe variabile sau rezultate de funcții. Combinat cu satisfies ({...} as const satisfies Tip) obții și verificare, și valori exacte.

Exemple

Exemplul 1: Listă de valori și union derivat din ea

const MATERII = ["matematică", "informatică", "fizică"] as const;
type Materie = (typeof MATERII)[number];   // "matematică" | "informatică" | "fizică"

const note: Record<Materie, number> = { "matematică": 9, "informatică": 10, "fizică": 8 };

for (const m of MATERII) {
    console.log(m.padEnd(12), note[m]);
}

Rezultat

matematică   9
informatică  10
fizică       8

Exemplul 2: Cu și fără as const

Fără as const, metoda are tipul string și nu poate fi dată funcției care acceptă doar "GET" | "POST".

function cerere(url: string, metoda: "GET" | "POST"): string {
    return `${metoda} ${url}`;
}

const c1 = { url: "/api/elevi", metoda: "GET" } as const;
console.log(cerere(c1.url, c1.metoda));

const c2 = { url: "/api/note", metoda: "POST" };
console.log(cerere(c2.url, c2.metoda));

Eroarea afișată de tsc

exemplu.mts(9,28): error TS2345: Argument of type 'string' is not assignable to parameter of type '"GET" | "POST"'.

Exemplul 3: Totul devine readonly

const SETARI = { limba: "ro", orase: ["Iași", "Cluj"] } as const;
SETARI.limba = "en";
SETARI.orase.push("Brașov");