Утверждение типа в TypeScript
Утверждение типа — это механизм, который сообщает компилятору: «Я знаю тип этого значения лучше, чем ты». Он позволяет разработчикам вручную переопределять результаты вывода типов TypeScript, подобно преобразованию типов в других языках, ноон действует только на этапе компиляции и не генерирует никакого исполняемого кода.。
Две синтаксические формы
Существуют два способа записи утверждений типа; рекомендуется постоянно использоватьasсинтаксис; синтаксис с угловыми скобками конфликтует с синтаксисом тегов в JSX-файлах.
Пример
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 user = response as { name: string; age: число };
console.log(user.name); // Alice
console.log(user.age); // 25
Вывод:
Alice 25
2. Сужение объединённых типов
Когда вы знаете конкретную ветвь объединённого типа, но компилятор не может автоматически её определить, вы можете использовать утверждение, чтобы явно указать тип.
Пример
| { 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; только после утверждения его как конкретного типа элемента вы сможете получить доступ к его уникальным свойствам.
Пример
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, но компилятор не может это вывести.
Пример
// Используйте !, чтобы утверждать, что str точно имеет значение
console.log(str!.length);
}
// Выполняется нормально
printLength("hello"); // 5
// Ошибка времени выполнения: Не удается прочитать свойства undefined
// printLength();
Вывод:
5
Предупреждение:Утверждение о ненулевом значении обходит проверку компилятора на null; если фактическое значение
null/undefined, оно всё равно выбросит ошибку во время выполнения. Когда условия позволяют, предпочитайте использовать опциональную цепочку?.вместо этого.
Утверждение const as const
as constВыводит литералы как наиболее узкие литеральные типы readonly, обычно используется для определения значений enum, констант конфигурации и кортежей.
Пример
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, во время выполнения это всё ещё строка.
Пример
// Утверждён как 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в качестве посредника, но это опасная операция, и её следует по возможности избегать.
Пример
// Прямое утверждение: 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 и может легко вызвать ошибки времени выполнения. Используйте его только в особых случаях, например при неточных типах в сторонних библиотеках, и указывайте причину в коде.
Сравнение методов утверждения
| Метод утверждения | Синтаксис | Типичный сценарий | Риск |
|---|---|---|---|
| утверждение as | value as Type | Преобразование any в конкретный тип, операции с DOM | Низкая (есть проверка на пересечение) |
| Утверждение о ненулевом значении | value! | Подтверждение, что значение не null/undefined | Средний (пропускает проверку на null) |
| Утверждение const | value as const | Литеральные константы, значения enum | Отсутствует |
| Двойное утверждение | value as unknown as T | Принудительное преобразование, когда типы не пересекаются | Высокий (полностью обходит проверки) |
Итог
- Выбор синтаксиса:Последовательно используйте
asсинтаксис и избегайте синтаксиса с угловыми скобками в JSX - Утверждение против преобразования:Утверждение влияет только на типы времени компиляции и не создаёт код времени выполнения; реальное преобразование значений требует использования
Number()、String()и других подобных функций - Утверждение ненулевого значения:Перед использованием
!, убедитесь, что значение действительно не null; иначе во время выполнения возникнет ошибка. Когда условия позволяют, предпочитайте использовать?. - Утверждение const:
as constявляется безопасным и практичным утверждением, рекомендуемым для объектов конфигурации и константных массивов - Двойное утверждение:это крайняя мера; при использовании необходимо прокомментировать причину
Другие связанные материалы