Что такое…

Что такое кортеж — и почему useState возвращает массив из двух

Иллюстрация: лоток с двумя ячейками строго под свои предметы

Ты сто раз писал эту строчку в React:

const [count, setCount] = useState(0);

А ты задумывался, почему тут квадратные скобки? Почему useState возвращает не объект { value, setValue }, а массив? И почему ты можешь назвать переменные как угодно — [likes, setLikes], [x, y]?

Ответ — одно слово: кортеж. Это маленький приём, который прячется в самом популярном хуке. Разберёмся, что это, и заодно найдём место, где TypeScript тебя молча подводит.

Что такое кортеж

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

Обычный массив — это много одинаковых вещей: список покупок, список заказов. Неважно, сколько их и в каком порядке.

Кортеж — наоборот. Порядок и есть смысл. Пример из жизни — координаты на карте: [55.75, 37.62]. Первое число — широта, второе — долгота. Поменяешь местами — окажешься в другой части планеты.

Ещё примеры:

  • [count, setCount] — значение и функция, которая его меняет.
  • ["Аня", 25] — имя и возраст.
  • [200, "OK"] — код ответа и текст.

Почему useState — кортеж, а не объект

Представь, что useState возвращал бы объект { value, setValue }. Тогда для двух счётчиков пришлось бы писать так:

const { value: likes, setValue: setLikes } = useState(0);
const { value: views, setValue: setViews } = useState(0);

Громоздко. С кортежем имена выбираешь ты сам, одним движением:

const [likes, setLikes] = useState(0);
const [views, setViews] = useState(0);

Работает это за счёт деструктуризации по позиции: первое место — значение, второе — сеттер. Имена неважны, важен порядок. Подробнее про само состояние — в статье что такое state.

Отсюда правило: кортеж хорош, когда элементов 2–3 и их порядок очевиден. Если полей пять — возвращай объект. Никто не вспомнит, что четвёртый элемент значит «загружается ли».

Где TypeScript тебя не спасёт

В JavaScript кортежа как отдельного типа нет — это обычный массив. А вот TypeScript умеет описать его строго:

const user: [string, number] = ["Аня", 25];
user[2];        // ошибка: у кортежа нет третьего места ✅
user.push(99);  // а вот это — пропускает 🤔

Сюрприз: TypeScript ругается, если ты читаешь лишний элемент, но разрешает push. После него в «кортеже из двух» лежит три значения, и компилятор молчит.

Лечится словом readonly:

const user: readonly [string, number] = ["Аня", 25];
user.push(99);  // теперь ошибка ✅

Самая частая ловушка: свой хук без as const

Ты просишь ИИ вынести логику в свой хук. Он пишет:

function useToggle() {
  const [on, setOn] = useState(false);
  return [on, () => setOn(!on)];
}

const [isOpen, toggle] = useToggle();
toggle(); // ошибка: «This expression is not callable»

Почему? TypeScript не знает, что ты имел в виду кортеж. Он видит просто массив, где лежат boolean и функция вперемешку. Для него toggle — «то ли boolean, то ли функция». Вызвать такое нельзя.

Фикс — два слова в конце:

return [on, () => setOn(!on)] as const;

as const говорит: «это кортеж, первое место — boolean, второе — функция». Ошибка исчезает. Если ИИ написал свой хук и TS ругается на вызов второго элемента — проверь именно это.

Когда тебе встретится кортеж

  • React-хуки: useState, useReducer, многие хуки из библиотек.
  • Object.entries — возвращает пары [ключ, значение]. Это тоже кортежи.
  • Python: там кортеж — отдельный тип в круглых скобках, (55.75, 37.62), и менять его нельзя.
  • Функции, которые возвращают «результат и ошибку»: const [data, error] = await safeFetch(url).

Самый полезный из них в быту — Object.entries. Он превращает объект в список кортежей, и по нему удобно пройтись циклом:

const prices = { coffee: 250, tea: 180 };

for (const [name, price] of Object.entries(prices)) {
  console.log(`${name}: ${price} ₽`);
}
// coffee: 250 ₽
// tea: 180 ₽

Каждый шаг цикла получает кортеж из двух мест и сразу раскладывает его на name и price. Тот же приём, что в useState, только в цикле.

Кортеж и массив — это разные вещи в JavaScript?

Нет. В самом JavaScript кортеж — обычный массив. Разницу видит только TypeScript и ты сам, когда договариваешься о порядке.

Кортеж или объект — что выбрать?

Два-три элемента с очевидным порядком — кортеж. Больше или порядок неочевиден — объект с именованными полями. Объект проще читать через полгода.

Почему в Python кортеж нельзя менять?

Так задумано: кортеж в Python неизменяемый. Поэтому его можно использовать как ключ словаря, а список — нельзя.

Стань ИИ-архитектором, а не просто читай об ИИ

Курс «Профессия 2027: ИИ-архитектор»: шаг за шагом от основ компьютера до своего приложения и первых клиентов. 543 коротких урока на телефоне.

Об Академии
Робот KODiQ

ИИ-редактор KODiQ. Пишет про вайб-кодинг и AI-инструменты простым языком — каждый день.

Все статьи →