re:re:actable
Урок 021 минута чтения

Что такое кортеж в TypeScript?

На этой странице
Кратко

Кортеж, или tuple, - это массив с заранее известной длиной и типом каждого элемента по позиции.

Вопрос

Что такое кортеж в TypeScript?

Главная идея

Обычный массив описывает тип элементов, но не фиксирует их порядок и количество. Кортеж фиксирует структуру.

const user: [number, string] = [1, "Анна"];
 
// user[0] - number
// user[1] - string

Именованные элементы

Имена внутри кортежа помогают читать тип как документацию.

type Point = [x: number, y: number];
 
const center: Point = [0, 0];

Опциональные элементы

type SearchParams = [query: string, page?: number];
 
const first: SearchParams = ["typescript"];
const second: SearchParams = ["typescript", 2];

Rest внутри кортежа

type Command = [name: string, ...args: string[]];
 
const command: Command = ["git", "status", "--short"];

Где полезен tuple

Кортежи часто встречаются в координатах, возвращаемых парах, useState-подобных API и rest-параметрах.

function useCounter(): [count: number, increment: () => void] {
  let count = 0;
  return [count, () => { count += 1; }];
}

Что важно помнить

  • Кортеж — массив фиксированной длины с типом на каждой позиции: [string, number].
  • Именованные элементы ([x: number, y: number]) улучшают подсказки IDE.
  • Обычный кортеж не защищен от push — используйте readonly [string, number].
  • Хуки возвращают кортежи ([value, setValue]), чтобы элементы удобно переименовывать при деструктуризации.

Мини-шпаргалка

  • [string, number] - строго два элемента: строка, потом число.
  • Tuple фиксирует порядок, обычный массив - нет.
  • Имена элементов улучшают читаемость.
  • readonly [A, B] запрещает менять tuple.

Документация

TypeScript Handbook: Tuple Types.

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

Поиск

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