シングルスレッドで実行されるJavaScriptがどのように非同期処理を実現しているか①

# ちょっと踏み込んだ視点でJavaScriptの非同期処理をみてみる
シングルスレッドで実行されているJavaScriptが非同期処理をどのように実現しているのか、少し踏み込んで調べてみました。
正直このあたりを知らなくても開発に差し支えはないと思いますが、仕組みを理解していることで性能面を考慮した開発ができるようになったり、他言語との差別化にも繋がると思います。

JavaScript初・中級者の方にとって、ステップアップするきっかけになればと思います。

※下記の記事が非常に参考になったので、参考リンク等はここから引用させていただいてます。
もっと詳しく知りたい方はこちらからどうぞ。

https://zenn.dev/canalun/articles/js_async_and_company

一度でまとまり切らなかったため、②に続く予定です。

# 概要

- 調査に至った経緯
- JavaScriptが非同期処理をシングルスレッドで実現する仕組み

## 調査に至った経緯

調査に至った経緯としては、こちらの記事を見ていたことが始まりです。

https://qiita.com/KickJune/items/3e980d00102c5c7cf600

記事の中ではJavaScriptがシングルスレッドで実行されているということをコードベースで説明されており、処理順序に関する問題も出題されているのですが、見事に間違えてしまいました。

```js
console.log(`Start ${new Date()}`);

// 3秒後にCallbackと表示
setTimeout(() => {
    console.log(`Callback ${new Date()}`);
}, 3000);

// 5秒間かかる処理を実行する
const now = new Date().getTime();
while (new Date().getTime() - now < 5000) {
    // 適当な処理
}

console.log(`End ${new Date()}`);
```

この処理の順番ですが、正解はこのようになります。
![スクリーンショット (40).png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1021235/ca4d3926-c44f-db3f-b8f7-22580dab5ec1.png)

<br>
どうして...非同期処理なのだからwhile処理の途中で合流するはずじゃ？
<br>
<br>
これはシングルスレッドであるために、このような処理順となっています。

<br>
<br>
では、上記の処理の後に5秒かかる処理を実行するとどうなるでしょうか。

```js
const singleMain = (): void => {
    console.log(`Start ${new Date()}`);

    // 3秒後にCallbackと表示
    setTimeout(() => {
        console.log(`Callback ${new Date()}`);
    }, 3000);

    // 5秒間かかる処理を実行する
    const now = new Date().getTime();
    while (new Date().getTime() - now < 5000) {
        // 適当な処理
    }

    console.log(`End ${new Date()}`);

    // 5秒かかる非同期処理を追加
    setTimeout(() => {
        console.log(`5秒経過 ${new Date()}`);
    }, 5000);
}
```
結果
![スクリーンショット (42).png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1021235/f8563213-05a2-859c-6ee7-e69aa1076967.png)

最初に設定した「3秒待ってから実行する」方の非同期処理が、最後に設定した非同期処理の前に実行されている。

これはスタックされている非同期処理がFIFOで処理されているということか？（あくまでも推測ですが）

ここで、最後のsetTimeout()を同期処理に置き換えます。

```js
const singleMain = (): void => {
    console.log(`Start ${new Date()}`);

    // 3秒後にCallbackと表示
    setTimeout(() => {
        console.log(`Callback ${new Date()}`);
    }, 3000);

    // 5秒間かかる処理を実行する
    const now = new Date().getTime();
    while (new Date().getTime() - now < 5000) {
        // 適当な処理
    }

    console.log(`End ${new Date()}`);

    // 非同期処理を追加
    const afterEnd = new Date().getTime();
    while (new Date().getTime() - afterEnd < 5000) {
        // 適当な処理
    }

    console.log(`All End ${new Date()}`);
}
```
結果
![スクリーンショット (45).png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1021235/9176530d-d3a2-ddb2-80cc-99b516fd0f05.png)

やはり同期処理が一通り完了してから、非同期処理が呼ばれていることが分かります。


そこで、恐らく私の知識不足もあり以下の疑問が生まれます。

- シングルスレッドなのに、どうやって非同期処理を実現している？
- 非同期処理（`setTimeout()`等）が処理を待機している場合、後続処理がそれ以上時間がかかる場合もそうでない場合も、全て（上記だとローカルスコープ）の処理が完了してから非同期処理が実行されるの？
    - 上記が正しい場合、非同期処理と言いつつ結局のところはコールスタックの順番で処理されている？
- でも途中で合流する（ように見える）時もあるし、なにが違うんだ？
    - このように動くと勘違いしていた可能性。。
- 複数の非同期処理はFIFOで実行されている？

このような経緯から、JavaScriptの非同期処理について理解するために調査を始めました。

## JavaScriptが非同期処理をシングルスレッドで実現する仕組み

簡単に言うと下記の仕組みによって実現しています。

- 外部APIを使用
    - ここで言う外部APIは「**実行環境が提供するAPI**」のこと（ブラウザやnode.js）
    - `fetch()`や`setTimeout()`もこの一つ
    - [ブラウザが提供するAPI](https://developer.mozilla.org/ja/docs/Web/API)
    - 一般的にjsの機能だと思って使用しているものは、**jsの言語規格(ECMAScript)＋実行環境が提供するAPI**となる
    - DOM APIもブラウザ（実行環境）が提供している
- 上記の外部APIを指揮する「**イベントループ**」が存在する
    - イベントループは処理の順番を整理してくれている（後述）
    - jsを実行し、画面の再描画を繰り返す

### 外部APIを使用

箇条書きでも説明してますが、jsの機能だけでは非同期処理を実現することはまず難しいため、**実行環境が提供するAPI**（外部API）を使用してます。

ブラウザが提供するAPIについてはこちらを参照。

https://developer.mozilla.org/ja/docs/Web/API

普段なにげなく使用しているsetTimeout()もこのうちの一つになり、一般的にjsの機能だと思って使用しているものは、**jsの言語規格(ECMAScript)＋実行環境が提供するAPI**ということになります。

DOM APIもブラウザが提供するAPIです。

### 外部APIを取りまとめるイベントループ

イベントループは簡単に言うと「処理の順番を整理してくれる」ようなもので、jsを実行→画面の再描画を繰り返すような仕組みを実現しています。

下記の記事が非常にわかりやすいです。

https://ja.javascript.info/event-loop#ref-3818

![スクリーンショット (46).png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1021235/cc02a0e9-11e2-f8fa-36af-83c0563f3778.png)

![スクリーンショット (47).png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1021235/e2f99fb6-3213-aaea-d828-2e6953e8bfd2.png)

ここでいう「scriptの実行でビジーである間」というのは、最初にお話しした「同期処理が実行されている間」と考えてもよさそう？（これについては②で解説予定）

で、その間に非同期処理（`setTimeout()`等）の処理が来るとキューに入り、script（同期処理）の完了後にキューから処理が呼ばれるような形になっています。

また、再描画については処理が完了した後のみに実行されるみたいですね。

実際にイベントループの動きを確認できるサイト

http://latentflip.com/loupe/

これを見ると、

タスクを取得
↓
コールスタックに積んで消化
↓
レンダリング
↓
タスクを取得
↓
以下繰り返し
 
という流れが非常にわかりやすいです。

つまり、`setTimeout()`や`setInterval()`は、「**〇秒後にキューにタスクを追加する**」ということで、**厳密に〇秒後に実行されるわけではない**ということが分かります。

また、イベントループの細かな仕様はjsそのものではなくて実行環境ごとに定義されています。

https://dev.to/jasmin/difference-between-the-event-loop-in-browser-and-node-js-1113

https://hiroppy.me/blog/nodejs-event-loop/

抽象的ではありますが、ECMAScriptでもイベントループが定義されているみたいです。

https://tc39.es/ecma262/multipage/executable-code-and-execution-contexts.html#sec-jobs

今回はここまで！

# 最後に

はじめにも挙げましたが、こちらの記事の多くは下記を参考にさせていただいています。

https://zenn.dev/canalun/articles/js_async_and_company

個人的にわかりやすくまとめようかと思いましたが一度ではまとまり切らなかったので、今回は

- 外部APIを使用
- 上記の外部APIを指揮する「**イベントループ**」が存在する

ということが理解できたところで終わろうかと思います。

落ち着いたタイミングで

- イベントループの仕組み
- Microtaskについて
    - 簡単に触れておくと、「タスクの合間にまとめて処理されるようなタスク。Promiseなど」

ここら辺を読み直した後、②として執筆予定です。
最後まで読んでいただきありがとうございました。

参考記事

- [JavaScriptはシングルスレッドで実行される](https://qiita.com/KickJune/items/3e980d00102c5c7cf600)
- [jsが非同期処理をシングルスレッドで実現する仕組み〜Web API、イベントループ、MicrotaskとしてのPromise〜](https://zenn.dev/canalun/articles/js_async_and_company)
- [イベントループ(event loop): microtask と macrotask](https://ja.javascript.info/event-loop#ref-3818)
- [JavaScriptはなぜシングルスレッドでも非同期処理ができるのか/Why Can JavaSctipt Invoke Asynchronous in Single Thread?](https://speakerdeck.com/task4233/why-can-javasctipt-invoke-asynchronous-in-single-thread?slide=3)
- [JavaScriptがブラウザでどのように動くのか](https://engineering.mercari.com/blog/entry/20220128-3a0922eaa4/)
- [setTimeoutの挙動について](https://memowomome.hatenablog.com/entry/2015/07/28/210638)
- [[JavaScript] スレッドの仕組みから、非同期処理を説明してみる](https://juncleit.com/?p=185#toc9)
- [非同期処理を理解するためのロードマップ](https://zenn.dev/estra/articles/js-async-programming-roadmap)
- [JavaScript Visualizer](https://www.jsv9000.app/)
- [How to work callstack](http://latentflip.com/loupe)