🛡

[TypeScript] 何も返さない関数には、戻り値の型(void)を使う

に公開
2026/09/27

🌱 はじめに

この記事では、TypeScript の戻り値の型voidを解説します。
voidを指定すると、「この関数は値を返さない」ことを型で表せます。値を返さないつもりの関数で誤って値を返すと、コンパイルエラーで気付けます。

本記事のコードは、TypeScript Playground(https://www.typescriptlang.org/play )に貼り付けると、エラーの有無を確認できます。

🌱 結論

🌱 1. return 文がない関数

エラーなくコンパイルできます。

const log = (): void => {
  console.log("Hello World");
};

🌱 2. 値を返さない return 文を持つ関数

エラーなくコンパイルできます。

const log = (): void => {
  console.log("Hello World");
  return;
};

🌱 3. 値を返す return 文を持つ関数(エラーになる例)

const log = (): void => {
  console.log("Hello World");
  return true;
};

🌱 never との違い

voidの関数は、処理が最後まで終わって呼び出し元に戻ります(実行時にはundefinedが返ります)。
一方、必ず例外を投げるなど、呼び出し元に戻らない関数の戻り値にはneverを使います。

🌱 まとめ

  • voidは、値を返さない関数の戻り値に使う型
  • return 文がない関数や、return;だけの関数に指定できる
  • 値を返すとコンパイルエラーになるので、誤って値を返すミスに気付ける
GitHubで編集を提案

Discussion