Урок 012 минуты чтения
Type assertion (as)
На этой странице
Кратко
as не проверяет значение и не преобразует его. Это утверждение для компилятора: "считай это таким типом". Из-за этого as легко скрывает ошибку.
Вопрос
Почему type assertion через as может быть антипаттерном?
Что делает as
const value = document.querySelector("#app") as HTMLDivElement;TypeScript поверит, что value - HTMLDivElement. Но если элемента нет, на runtime там будет null.
value.innerText = "Hello"; // может упастьПлохой пример
type User = {
id: number;
name: string;
};
const user = JSON.parse("{}") as User;
console.log(user.name.toUpperCase()); // runtime-ошибкаas User не проверил, что поле name действительно существует.
Лучше: проверка или guard
function isUser(value: unknown): value is User {
return (
typeof value === "object" &&
value !== null &&
"id" in value &&
"name" in value
);
}
const data: unknown = JSON.parse("{}");
if (isUser(data)) {
console.log(data.name);
}Когда as уместен
as нормален, когда ты знаешь больше TypeScript и это знание подтверждено кодом: например, после проверки DOM-элемента или при работе с ограничениями внешней библиотеки.
const element = document.querySelector("#app");
if (element instanceof HTMLDivElement) {
element.innerText = "Hello";
}Что важно помнить
asне проверяет и не преобразует значение — это обещание компилятору.as unknown as Tпозволяет привести что угодно к чему угодно — признак проблемы с типами.- Вместо
asиспользуйте сужение, type guards,satisfiesи валидацию схемами. - Допустимые случаи: работа с DOM (
as HTMLInputElementпосле проверки),as const, тесты.
Мини-шпаргалка
asне меняет значение на runtime.asне валидирует данные.- Часто лучше narrowing, guard или runtime-валидация.
- Избегай двойного
as unknown as Typeбез очень веской причины.
Документация
TypeScript Handbook: Type Assertions, typescript-eslint: consistent-type-assertions.
Дочитали до конца?
Отметьте урок — прогресс сохранится в браузере.