re:re:actable
Урок 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.

Дочитали до конца?
Отметьте урок — прогресс сохранится в браузере.

Поиск

Поиск по урокам