Утверждение типа в TypeScript

Утверждение типа — это механизм, который сообщает компилятору: «Я знаю тип этого значения лучше, чем ты». Он позволяет разработчикам вручную переопределять результаты вывода типов TypeScript, подобно преобразованию типов в других языках, ноон действует только на этапе компиляции и не генерирует никакого исполняемого кода.。


Две синтаксические формы

Существуют два способа записи утверждений типа; рекомендуется постоянно использоватьasсинтаксис; синтаксис с угловыми скобками конфликтует с синтаксисом тегов в JSX-файлах.

Пример

// ① Синтаксис с угловыми скобками (не рекомендуется, нельзя использовать в .tsx-файлах)
const str1: any = "hello";
const len1: number = (<string>str1).length;

// ② синтаксис as (рекомендуется)
const str2: any = "world";
const len2: number = (str2 as string).length;

console.log(len1);  // 5
console.log(len2);  // 5

Вывод:

5
5

Примечание:В файлах React.tsxсинтаксис угловых скобок конфликтует с тегами JSX, поэтомуasсинтаксис должен использоваться.


Типичные случаи использования

1. Обработка типов any / unknown

Данные, полученные из внешних интерфейсов, при разборе JSON и в других сценариях, обычноany; утверждения могут восстановить подсказки типов.

Пример

const response: any = { name: "Alice", age: 25 };

// Привести к конкретному типу, чтобы получить подсказки типов
const user = response as { name: string; age: число };

console.log(user.name);  // Alice
console.log(user.age);   // 25

Вывод:

Alice
25

2. Сужение объединённых типов

Когда вы знаете конкретную ветвь объединённого типа, но компилятор не может автоматически её определить, вы можете использовать утверждение, чтобы явно указать тип.

Пример

type Shape =
    | { kind: "circle"; radius: number }
    | { kind: "rect"; width: number; height: number };

function getArea(shape: Shape): number {
    if (shape.kind === "circle") {
        return Math.PI * (shape as { kind: "circle"; radius: number }).radius ** 2;
    }
    const rect = shape as { kind: "rect"; width: number; height: number };
    return rect.width * rect.height;
}

console.log(getArea({ kind: "circle", radius: 5 }).toFixed(2));  // 78.54
console.log(getArea({ kind: "rect", width: 4, height: 6 }));     // 24

Вывод:

78.54
24

Совет:Предпочитайте использовать защитники типов (typeof / instanceof/ свойства-дискриминанты) для сужения типов; используйте утверждения только в сценариях, которые защитники не могут покрыть.

3. Манипулирование DOM-элементами

document.querySelectorТип возвращаемого значения:Element | null; только после утверждения его как конкретного типа элемента вы сможете получить доступ к его уникальным свойствам.

Пример

// querySelector возвращает Element | null
const input = document.querySelector("#username") as HTMLInputElement;

// После утверждения вы можете получить доступ к уникальным свойствам HTMLInputElement
// console.log(input.value);

// Более безопасный подход: сначала проверить на null, затем утверждать
const btn = document.querySelector("#submit");
if (btn) {
    (btn as HTMLButtonElement).disabled = true;
}

Утверждение non-null !

Add!после значения, чтобы сообщить компилятору, что значение неnullилиundefined; подходит для сценариев, когда вы уверены, что значение не null, но компилятор не может это вывести.

Пример

function printLength(str?: string) {
    // Используйте !, чтобы утверждать, что str точно имеет значение
    console.log(str!.length);
}

// Выполняется нормально
printLength("hello");  // 5

// Ошибка времени выполнения: Не удается прочитать свойства undefined
// printLength();

Вывод:

5

Предупреждение:Утверждение о ненулевом значении обходит проверку компилятора на null; если фактическое значениеnull / undefined, оно всё равно выбросит ошибку во время выполнения. Когда условия позволяют, предпочитайте использовать опциональную цепочку?.вместо этого.


Утверждение const as const

as constВыводит литералы как наиболее узкие литеральные типы readonly, обычно используется для определения значений enum, констант конфигурации и кортежей.

Пример

// Обычное объявление: выводится как string[], элементы можно изменять
const colors1 = ["red", "green", "blue"];
colors1.push("yellow");  // Разрешено

// as const: выводится как readonly ["red", "green", "blue"]; и элементы, и длина неизменяемы
const colors2 = ["red", "green", "blue"] as const;
// colors2.push("yellow"); // Ошибка: нельзя вызывать push для readonly-массива

// То же для объектов: все свойства становятся readonly-литеральными типами
const config = {
    host: "localhost",
    port: 3000
} as const;
// config.port = 8080; // Ошибка: readonly-свойство нельзя изменить

console.log(colors2);         // ['red', 'green', 'blue']
console.log(config.host);     // localhost
console.log(config.port);     // 3000

Вывод:

['red', 'green', 'blue']
localhost
3000

Утверждение типа — это не преобразование типа

Утверждение типа влияет только на проверку типов компилятором и не генерирует никакого кода преобразования после компиляции. Даже если утверждать"42"asnumber, во время выполнения это всё ещё строка.

Пример

const strNum: any = "42";

// Утверждён как number, но во время выполнения это всё ещё строка
const wrongNum = strNum as number;
console.log(typeof wrongNum);    // string (not number!)
console.log(wrongNum + 1);       // 421 (конкатенация строк, а не числовое сложение)

// Для реального преобразования типов требуются функции преобразования
const realNum = Number(strNum);
console.log(typeof realNum);     // number
console.log(realNum + 1);        // 43

Вывод:

string
421
number
43

Двойное утверждение

Когда между двумя типами нет пересечения, TypeScript откажется от прямого утверждения. В этом случае вы можете использоватьunknownв качестве посредника, но это опасная операция, и её следует по возможности избегать.

Пример

const num = 42;

// Прямое утверждение: number и string не пересекаются, компилятор сообщает об ошибке
// const str = num as string;

// Двойное утверждение: сначала утверждаем как unknown, затем утверждаем как целевой тип
const str = num as unknown as string;

console.log(str);          // 42
console.log(typeof str);   // number (тип во время выполнения не изменяется; утверждение действует только во время компиляции)

Вывод:

42
number

Предупреждение:Двойное утверждение полностью обходит систему типов TypeScript и может легко вызвать ошибки времени выполнения. Используйте его только в особых случаях, например при неточных типах в сторонних библиотеках, и указывайте причину в коде.


Сравнение методов утверждения

Метод утверждения Синтаксис Типичный сценарий Риск
утверждение asvalue as TypeПреобразование any в конкретный тип, операции с DOMНизкая (есть проверка на пересечение)
Утверждение о ненулевом значенииvalue!Подтверждение, что значение не null/undefinedСредний (пропускает проверку на null)
Утверждение constvalue as constЛитеральные константы, значения enumОтсутствует
Двойное утверждениеvalue as unknown as TПринудительное преобразование, когда типы не пересекаютсяВысокий (полностью обходит проверки)

Итог

  • Выбор синтаксиса:Последовательно используйтеasсинтаксис и избегайте синтаксиса с угловыми скобками в JSX
  • Утверждение против преобразования:Утверждение влияет только на типы времени компиляции и не создаёт код времени выполнения; реальное преобразование значений требует использованияNumber()、String()и других подобных функций
  • Утверждение ненулевого значения:Перед использованием!, убедитесь, что значение действительно не null; иначе во время выполнения возникнет ошибка. Когда условия позволяют, предпочитайте использовать?.
  • Утверждение const:as constявляется безопасным и практичным утверждением, рекомендуемым для объектов конфигурации и константных массивов
  • Двойное утверждение:это крайняя мера; при использовании необходимо прокомментировать причину

Другие связанные материалы