Псевдоним типа в TypeScript

Псевдоним типа используется для создания альтернативного имени для существующего типа, что делает код чище и удобнее для чтения.

С помощью псевдонимов типов можно задать короткое имя для сложных типов, что улучшает сопровождаемость кода.


Диаграмма SVG: псевдоним типа Background Title How type aliases work Original type Original complex type type User = { name: string; age: number; email: string; } Arrow Definition type alias type alias type UserID = User; // or type ID = string | number; Arrow Usage Usage Use in code var id: UserID; var uid: ID; Lower part: application scenarios Application scenarios for type aliases Scenario 1 Basic type alias Scenario 2 Union type alias Scenario 3 Function type alias Scenario 4 Generic type alias Arrow marker

Зачем нужны псевдонимы типов

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

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

Псевдонимы типов особенно полезны при работе со сложными типами, такими как объединённые типы, типы функций и кортежи.

Объяснение концепции:Использование псевдонима типаtypeопределяется с помощью ключевого слова `type`; он просто даёт существующему типу новое имя и не создаёт новый тип.


Базовое использование

Используйте ключевое слово `type`, чтобы определить псевдоним для типа.

Пример

// Псевдоним типа: определить псевдоним для объединённого типа
// ID может быть строкой или числом
type ID = string | number;

// Псевдоним типа: определить псевдоним для объектного типа
// Point представляет координатную точку
type Point = { x: number; y: number };

// Используйте псевдоним типа
var userId: ID = "123";
var productId: ID = 456;

// Используйте псевдоним типа Point
var point: Point = { x: 10, y: 20 };

console.log("ID пользователя: " + userId);
console.log("ID продукта: " + productId);
console.log("Координаты: " + JSON.stringify(point));

Вывод:

用户ID: 123
产品ID: 456
坐标: {"x":10,"y":20}

Объяснение:Псевдоним типа просто даёт типу новое имя; после компиляции он не создаёт фактического кода и используется исключительно для проверки типов во время разработки.


Интерфейс против псевдонима типа

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

Пример

// Используйте псевдоним типа для определения объектного типа
// type может определять любой тип, а не только объекты
type PersonType = {
    name: string;
    age: number;
};

// Используйте интерфейс для определения типа объекта
// Интерфейсы поддерживают слияние объявлений и могут быть реализованы классами
interface PersonInterface {
    name: string;
    age: number;
}

// Оба можно использовать для объявления типов переменных
var person1: PersonType = { name: "Alice", age: 25 };
var person2: PersonInterface = { name: "Bob", age: 30 };

console.log("PersonType: " + JSON.stringify(person1));
console.log("PersonInterface: " + JSON.stringify(person2));

Различия:type может определять любой тип (объединённые типы, кортежи, функциональные типы и т. д.), тогда как интерфейсы в основном используются для типов объектов. Интерфейсы поддерживают слияние объявлений, а type — нет.


Псевдонимы типов и объединённые типы

Псевдонимы типов идеально подходят для определения объединённых типов, делая код более понятным.

Пример

// Псевдоним объединённого типа: определение возможных значений для статуса
// Статус может быть только одним из этих трёх строковых литералов
type Status = "pending" | "success" | "error";

// Псевдоним объединённого типа: определение нескольких возможных типов возвращаемого значения
// Result может быть string, number или boolean
type Result = string | number | boolean;

// Использование псевдонима объединённого типа
function getStatus(status: Status): void {
    console.log("Статус: " + status);
}

getStatus("success");
getStatus("error");

// Использование типа Result
var result: Result = "hello";
result = 42;
console.log("Результат: " + result);

Вывод:

Status: success
Status: error
结果: 42

Сценарии применения:Псевдонимы объединённых типов часто используются для определения кодов состояния, типов ошибок, возвращаемых значений API и подобных сценариев.


Псевдонимы типов и кортежи

Псевдонимы типов также можно использовать для определения типов кортежей.

Пример

// Псевдоним типа кортежа: определить координаты
// Coordinate — это кортеж, содержащий два числа
type Coordinate = [number, number];

// Псевдоним типа кортежа: определить имя и возраст
// NameAge — это кортеж из строки и числа
type NameAge = [string, number];

// Используйте псевдоним типа кортежа
var coord: Coordinate = [10, 20];
var person: NameAge = ["Alice", 25];

console.log("Координаты: " + coord);
console.log("Информация: " + person[0] + ", " + person[1]);

Пояснение:Псевдонимы типов кортежей делают использование кортежей более понятным и позволяют избежать необходимости каждый раз писать полный тип кортежа.


Псевдонимы типов и функции

Псевдонимы типов могут упростить объявления типов функций.

Пример

// Псевдоним типа функции: определение типа функции обратного вызова
// Callback принимает параметр типа string и возвращает void
type Callback = (result: string) => void;

// Псевдоним типа функции: определение типа функции математической операции
// MathOperation принимает два параметра типа number и возвращает number
type MathOperation = (a: number, b: number) => number;

// Использование псевдонима типа функции
var add: MathOperation = function(a, b) { return a + b; };
var multiply: MathOperation = function(a, b) { return a * b; };

console.log("Сложение: " + add(2, 3));
console.log("Умножение: " + multiply(4, 5));

Вывод:

加法: 5
乘法: 20

Преимущества:Псевдонимы типов функций делают объявления типов функций более краткими, особенно когда одна и та же сигнатура функции требуется несколько раз.


Псевдонимы типов и обобщения

Псевдонимы типов можно использовать вместе с обобщениями для создания переиспользуемых определений типов.

Пример

// Обобщённый псевдоним типа: определить тип результата
// Result<T> — обобщённый тип; T — тип данных при успехе
type Result<T> = { success: boolean; data?: T; error?: string };

// Обобщённый псевдоним типа: определить тип пары ключ-значение
// Pair<K, V> имеет два параметра типа
type Pair<K, V> = { key: K; value: V };

// Использовать обобщённый псевдоним типа
var result: Result<string> = { success: true, data: "Hello" };
var pair: Pair<string, number> = { key: "age", value: 25 };

console.log("Результат: " + JSON.stringify(result));
console.log("Пара ключ-значение: " + JSON.stringify(pair));

Вывод:

结果: {"success":true,"data":"Hello"}
键值对: {"key":"age","value":25}

Преимущества обобщений:Обобщённые псевдонимы типов могут адаптироваться к разным типам данных, повышая переиспользуемость кода.


Псевдонимы типов и отображаемые типы

Псевдонимы типов можно комбинировать с отображаемыми типами, чтобы создавать мощные преобразования типов.

Пример

// Сопоставленный тип: сделать все свойства readonly
// Readonly<T> перебирает все свойства T и добавляет readonly
type Readonly<T> = { readonly [P in keyof T]: T[P] };

// Сопоставленный тип: сделать все свойства необязательными
// Partial<T> перебирает все свойства T и добавляет ?
type Partial<T> = { [P in keyof T]?: T[P] };

// Определяем интерфейс пользователя
interface User {
    name: string;
    age: number;
}

// Используйте псевдонимы отображаемых типов
var readonlyUser: Readonly<User> = { name: "Alice", age: 25 };
// readonlyUser.name = "Bob"; // Ошибка: свойство readonly нельзя изменить

var partialUser: Partial<User> = { name: "Bob" };

console.log("Пользователь только для чтения: " + JSON.stringify(readonlyUser));
console.log("Частичный пользователь: " + JSON.stringify(partialUser));

Совет:Сопоставленные типы — очень мощная возможность TypeScript, позволяющая создавать новые вариации типов на основе существующих типов.


Примечания

  • Нельзя переопределить:Один и тот же псевдоним типа нельзя переопределить (интерфейсы можно объединять с помощью слияния объявлений)
  • Действительны только во время компиляции:Псевдонимы типов не порождают код после компиляции
  • Читаемость прежде всего:Не злоупотребляйте псевдонимами типов; лаконичный и понятный код лучше

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


Итог

Псевдонимы типов — очень полезная возможность в TypeScript.

  • Базовое использование:Используйте ключевое слово `type`, чтобы определить псевдоним для сложных типов
  • Объединённые типы:Определяйте комбинации нескольких возможных типов
  • Типы функций:Упростите объявления типов функций
  • Обобщения:Создание переиспользуемых обобщённых типов
  • Сопоставленные типы:Создание новых типов на основе существующих типов

Рекомендация:Правильное использование псевдонимов типов может сделать код понятнее, но не злоупотребляйте ими. Самое главное — сохранять код кратким и читаемым.

Другие расширения