В этом уроке мы рассмотрим тип 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 = () => true;
const v = f();
Хотя f()
возвращает true
, переменная v
имеет тип void
. Это означает, что мы не можем использовать ее для чего-либо, кроме как для присваивания другой переменной с типом void
.
Существует единственная ситуация, когда указание void
явно запрещает возврат из функции. Это определение функции вне контекста использования, когда ее тип указывается явно:
function foo(): void {
return true; // Error!
}
const bar = function(): void {
return true; // Error!
};
В этом случае возврат любого значения приведет к ошибке компиляции.
Также void
является оператором JavaScript, поэтому важно не запутаться с ним. Он вычисляет выражение, которое следует за ним и возвращает undefined
:
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]
Параметры функции:
void
. У этой функции есть необязательный параметр — индекс элемента в массивеforEach([8, 9], (n, index) => console.log(index + n));
// 8
// 10
Если вы зашли в тупик, то самое время задать вопрос в «Обсуждениях». Как правильно задать вопрос:
Тесты устроены таким образом, что они проверяют решение разными способами и на разных данных. Часто решение работает с одними входными данными, но не работает с другими. Чтобы разобраться с этим моментом, изучите вкладку «Тесты» и внимательно посмотрите на вывод ошибок, в котором есть подсказки.
Это нормально 🙆, в программировании одну задачу можно выполнить множеством способов. Если ваш код прошел проверку, то он соответствует условиям задачи.
В редких случаях бывает, что решение подогнано под тесты, но это видно сразу.
Создавать обучающие материалы, понятные для всех без исключения, довольно сложно. Мы очень стараемся, но всегда есть что улучшать. Если вы встретили материал, который вам непонятен, опишите проблему в «Обсуждениях». Идеально, если вы сформулируете непонятные моменты в виде вопросов. Обычно нам нужно несколько дней для внесения правок.
Кстати, вы тоже можете участвовать в улучшении курсов: внизу есть ссылка на исходный код уроков, который можно править прямо из браузера.
Ваше упражнение проверяется по этим тестам
1/* eslint-disable @typescript-eslint/no-non-null-assertion */
2import forEach from './index';
3
4test('forEach', () => {
5 const result: number[] = [];
6 forEach([], (n: number) => result.push(n));
7 expect(result).toEqual([]);
8
9 const result2: number[] = [];
10 forEach([3, 9], (n: number) => result2.push(n + 1));
11 expect(result2).toEqual([4, 10]);
12
13 const result3: number[] = [];
14 forEach([8, 9], (n: number, i) => result3.push(n + i));
15 expect(result3).toEqual([8, 10]);
16});
17
Решение учителя откроется через: