Что такое кортеж — и почему 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 коротких урока на телефоне.





