void in JavaScript and TypeScript

Stefan Baumgartner

Written by @ddprrt

More on TypeScript, JavaScript

If you come from traditional, strongly typed languages you might be familiar with the concept of void: A type telling you that functions and methods return nothing when called.

void exists in both JavaScript as an operator and in TypeScript as a primitive type. And in both worlds void works a little bit different than most people are used to.

void in JavaScript #

void in JavaScript is an operator which evaluates the expression next to it. No matter which expression is evaluated, void always returns undefined.

let i = void 2; // i === undefined

Why would we need something like this? First, in earlier times, people were able to override undefined and giving it an actual value. void always returned the real undefined.

Second, itโ€™s a nice way to call immediately invoked functions:

void function() {

All without polluting the global namespace:

void function aRecursion(i) {
if(i > 0) {

console.log(typeof aRecursion) // undefined

Since void always returns undefined, and void always evaluates the expression next to it, you have a very terse way of returning from a function without returning a value, but still calling a callback for example:

// returning something else than undefined would crash the app
function middleware(nextCallback) {
if(conditionApplies()) {
return void nextCallback();

Which brings me to the most important use case of void: Itโ€™s a security gate for your app. When your function is always supposed to return undefined, you can make sure that this is always the case.

button.onclick = () => void doSomething();

void in TypeScript #

void in TypeScript is a subtype of undefined. Functions in JavaScript always return something. Either itโ€™s a value, or undefined:

function iHaveNoReturnValue(i) {
} // returns undefined

Since functions without a return value always return undefined, and void always returns undefined in JavaScript, void in TypeScript is a proper type for telling developers that this function returns undefined:

declare function iHaveNoReturnValue(i: number): void

void as type can also be used for parameters and all other declarations. The only value that can be passed is undefined:

declare function iTakeNoParameters(x: void): void

iTakeNoParameters() // ๐Ÿ‘
iTakeNoParameters(undefined) // ๐Ÿ‘
iTakeNoParameters(void 2) // ๐Ÿ‘

So void and undefined are pretty much the same. Thereโ€™s one little difference though, and this difference is significant: void as a return type can be substituted with different types, to allow for advanced callback patterns:

function doSomething(callback: () => void) {
// at this position, callback always returns undefined
let c = callback()
//c is also of type undefiend

// this function returns a number
function aNumberCallback(): number {
return 2;

// works ๐Ÿ‘ type safety is ensured in doSometing

This is desired behaviour and often used in JavaScript applications. Read more on this pattern called substitutability in my other articles.

If you want to make sure to pass functions who only return undefined (as in โ€œnothingโ€), be sure to adapt your callback method signature:

- function doSomething(callback: () => void) {
+ function doSomething(callback: () => undefined) { /* ... */ }

function aNumberCallback(): number { return 2; }

// ๐Ÿ’ฅ types don't match

Youโ€™ll propably be good with void most of the time.

More articles on TypeScript

My new book: TypeScript in 50 Lessons

this in JavaScript and TypeScript

TypeScript and ECMAScript Modules

Stay up to date!

3-4 updates per month, spam-free, hand-crafted. Our newsletter gives you links, updates on fettblog.eu, conference talks, coding soundtracks, and much more.