JavaScript / コードを試す
SyntaxError: await is only valid in async functions
await を書ける場所は決まっています。async を付け忘れた関数、コールバックの中、昔の書き方のファイル。それぞれの直し方と、直った後に起きやすい間違いまで載せています。
固定例はNode 24.22.3の実行記録を照合しています()。下の入力欄の結果は今回の実行で確認してください。
同じエラー名でも原因は異なります。発生した行とその時点の値を確かめ、該当する修正例へ進んでください。
コードを編集して試す
ブラウザー内で実行します。コードの送信・自動実行・自動保存はしません。このタブを閉じると入力は失われます。機密情報は入力しないでください。
8,192 UTF-8 byte・実行1.5秒・出力60行/8KiB以内。Ctrl / ⌘ + Enterでも実行できます。
パネルを開くと編集できます。
現在の入力は未実行です。
入力中のコードをこの例へ置き換えます。
実行画面や検索画面の間の通常クリックでは入力をこのタブのRAMで保持します。元の教材は別タブで開きます。再読み込み・タブ終了ではRAMの入力は失われます。
await を書ける場所は決まっています。
try { new Function('return await Promise.resolve(1);'); } catch (error) { console.log(error.name + ': ' + error.message); }
SyntaxError: await is only valid in async functions and the top level bodies of modules
実行する前に弾かれます。 1行も動きません。
ここでは文言を見せるために new Function() を使っています。ふつうに書いた場合は、ファイルを読み込んだ時点で止まります。
書ける場所
| 場所 | 書けるか |
|---|---|
async を付けた関数の中 |
書ける |
| モジュールの一番外側 | 書ける(ES2022) |
async の無い関数の中 |
書けない |
コールバックの中(そのコールバックに async が無い) |
書けない |
| モジュールでないファイルの一番外側 | 書けない |
原因1: async の付け忘れ
いちばん多い原因です。
function load() {
return await fetch('/api');
}async を付けます。
async function load() { return await Promise.resolve('読み込んだ'); } console.log(await load());
読み込んだ
アロー関数も同じです。async は矢印の前に書きます。
const load = async () => await Promise.resolve('読み込んだ'); console.log(await load());
読み込んだ
オブジェクトのメソッドとクラスのメソッドは、名前の前に書きます。
const api = { async load() { return await Promise.resolve('メソッド'); }, }; class Client { async load() { return await Promise.resolve('クラス'); } } console.log(await api.load()); console.log(await new Client().load());
メソッド クラス
原因2: コールバックの中に書いた
外側に async があっても、届きません。
async function main() {
[1, 2].forEach(function (n) {
await save(n);
});
}await があるのは function (n) の中で、そこには async がありません。
ここで内側のコールバックに async を付けるのは、たいてい間違いです。
const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms)); const order = []; [1, 2].forEach(async (n) => { await sleep(1); order.push(n); }); order.push('forEach を抜けた'); await sleep(30); console.log(order.join(' -> '));
forEach を抜けた -> 1 -> 2
構文の誤りは消えますが、待ってくれません。
forEach() はコールバックが返した Promise を見ないからです。
for...of に替えてください。
const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms)); const order = []; for (const n of [1, 2]) { await sleep(1); order.push(n); } order.push('for...of を抜けた'); console.log(order.join(' -> '));
1 -> 2 -> for...of を抜けた
同時に走らせてよいなら map() と Promise.all() です。
const double = async (n) => n * 2; console.log(await Promise.all([1, 2].map(double)));
[ 2, 4 ]
原因3: モジュールとして読まれていない
文言の後半にある「the top level bodies of modules」がこれです。
モジュールなら、関数の外側でも await を書けます。
<script type="module">で読み込む- 拡張子を
.mjsにする、またはpackage.jsonに"type": "module"を書く
import / export が使えない環境なら、囲って呼びます。
async function main() { return await Promise.resolve('囲んだ'); } main().then((value) => console.log(value)); await new Promise((resolve) => setTimeout(resolve, 10));
囲んだ
このページの実行パネルは中身を非同期の関数として扱うので、一番外側の await がそのまま動きます。自分のファイルでも同じとは限りません。
直った後に起きやすい間違い
await を付け忘れる
こちらは構文エラーになりません。静かに壊れます。
async function get() {
return { name: 'あ' };
}
const user = get();
console.log(user);
console.log(user.name);Promise {}
undefinedasync を付けた関数は、必ず Promise を返します。
await を付けないと、中身ではなく入れ物が返ります。
async function get() { return { name: 'あ' }; } const user = await get(); console.log(user.name);
あ
undefined が出たら、まず await の付け忘れを疑ってください。
失敗を受け止めない
async function fail() { throw new Error('だめ'); } try { await fail(); } catch (error) { console.log('catch:', error.message); }
catch: だめ
await を付けていれば、ふつうの try / catch で受けられます。
付けていないと、try の外に抜けてしまいます。
→ Error と try / catch / finally / throw
探しかたの順序
awaitを書いた行から、いちばん近い関数を探す- その関数に
asyncが付いているか見る- 付いていない → 付ける
- その関数がコールバックだった →
for...ofに替えるか、Promise.all()にする
- 関数の外側なら、そのファイルがモジュールとして読まれているか確かめる
- 直ったら、
awaitの付け忘れが無いか見直す
実行結果は、記事冒頭に示したNodeの版で確認しています。文言は処理系と版によって変わります。
まとめ
awaitはasync を付けた関数の中とモジュールの一番外側だけ- 外側に
asyncがあっても、コールバックの中には届かない forEach()にasyncを付けても待ってくれない。for...ofかPromise.all()- 順番に待つなら
for...of、同時でよいならmap()とPromise.all() - 直った後は
awaitの付け忘れに注意。undefinedが出たらまずそこ