Бесплатный курс по TypeScript. Зарегистрируйтесь для отслеживания прогресса →

TypeScript: Тип Void

void указывается как возврат для функций, которые ничего не возвращают. Он автоматически выводится в том случае, когда внутри функции нет инструкции return или она пустая:

function noop() {
  // внутри пусто
}

В JavaScript подобные функции возвращают undefined, но в TypeScript void и undefined это разные вещи. Различие проявляется в контекстной типизации и появилось исходя из особенностей работы самого JavaScript. Самый яркий пример метод forEach().

Принцип работы метода forEach() подразумевает то, что он никак не использует данные возвращаемые переданным колбеком, который вызывается внутри. Кажется, что логично было бы определить возврат как undefined, но посмотрите на пример:

const numbers = [1, 2, 3];
const result = [];

numbers.forEach((n) => result.push(n));

Метод push() возвращает индекс добавленного элемента. Если бы forEach() требовал от колбека возврат undefined, то такой код бы привел к ошибке компиляции. Его пришлось бы переписать, например, так:

// Теперь колбек ничего не возвращает,
// соответственно результат вызова undefined
numbers.forEach((n) => {
  result.push(n);
});

Чтобы не создавать такой код и был введен Void. Void позволяет возвращать любые данные, но делает так, что их использование бессмысленно.

type voidFunc = () => void;

// Тип функции определяется через контекст
// присваивания ее переменной с типом voidFunc
const f: voidFunc = () => {
  return true;
};

const v = f();

Единственная ситуация, когда указание void явно запрещает возврат из функции это определение функции вне контекста использования, когда ее тип указывается явно:

function foo(): void {
  return true; // Error!
}

const bar = function(): void {
  return true; // Error!
};

Стоит также иметь в виду, что void также оператор JavaScript и не запутаться с ним. Он вычисляет выражение следующее за ним и возвращает undefined:
typescript
void 10 === undefined // true

Задание

Попробуйте самостоятельно определить функцию forEach() для чисел:

forEach([1, 2, 3], (n) => console.log(n));
// 1
// 2
// 3

const result = [];
forEach([1, 2, 3], (n) => result.push(n));
// [1, 2, 3]

Параметры функции:

  1. Массив чисел
  2. Анонимная функция, принимающая на вход число и возвращающая void. У этой функции есть необязательный параметр - индекс элемента в массиве.
forEach([8, 9], (n, index) => console.log(index + n));
// 8
// 10
Упражнение не проходит проверку — что делать? 😶

Если вы зашли в тупик, то самое время задать вопрос в «Обсуждениях». Как правильно задать вопрос:

  • Обязательно приложите вывод тестов, без него практически невозможно понять что не так, даже если вы покажете свой код. Программисты плохо исполняют код в голове, но по полученной ошибке почти всегда понятно, куда смотреть.
В моей среде код работает, а здесь нет 🤨

Тесты устроены таким образом, что они проверяют решение разными способами и на разных данных. Часто решение работает с одними входными данными, но не работает с другими. Чтобы разобраться с этим моментом, изучите вкладку «Тесты» и внимательно посмотрите на вывод ошибок, в котором есть подсказки.

Мой код отличается от решения учителя 🤔

Это нормально 🙆, в программировании одну задачу можно выполнить множеством способов. Если ваш код прошел проверку, то он соответствует условиям задачи.

В редких случаях бывает, что решение подогнано под тесты, но это видно сразу.

Прочитал урок — ничего не понятно 🙄

Создавать обучающие материалы, понятные для всех без исключения, довольно сложно. Мы очень стараемся, но всегда есть что улучшать. Если вы встретили материал, который вам непонятен, опишите проблему в «Обсуждениях». Идеально, если вы сформулируете непонятные моменты в виде вопросов. Обычно нам нужно несколько дней для внесения правок.

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

Нашли ошибку? Есть что добавить? Пулреквесты приветствуются https://github.com/hexlet-basics
Если вы столкнулись с трудностями и не знаете, что делать, задайте вопрос в нашем большом и дружном сообществе