---
title: スクリプトの読み込み
description: type="module"・defer・async 属性によるスクリプトの読み込み方法と、インラインスクリプトを使ってよい例外
---

スクリプトは `<head>` 内で `type="module"` または `defer` 属性を付けて読み込みます。これにより、HTML の解析を止めずにスクリプトを読み込めます。

## type="module"（推奨）

ES モジュールを利用する場合は、`type="module"` を指定して読み込みます。モジュールスクリプトは自動的に `defer` と同じタイミングで実行されるため、`defer` 属性は不要です。

```html
<head>
  <script type="module" src="/assets/js/main.js"></script>
</head>
```

## defer（モジュールを使わない場合）

モジュールを使わないスクリプトは、`defer` 属性を付与して読み込みます。

```html
<head>
  <script defer src="/assets/js/common.js"></script>
  <script defer src="/assets/js/page-specific.js"></script>
</head>
```

:::note[defer 属性の動作]
- **HTML の解析を中断しない**: 解析と並行してスクリプトをダウンロードする
- **実行順序を保証する**: 記述した順にスクリプトが実行される
- **DOM 構築後に実行する**: DOM の構築完了後、`DOMContentLoaded` イベントの前に実行される
:::

## async（実行順や DOM に依存しない外部スクリプト）

外部ファイルとして読み込むスクリプトのうち、ほかのスクリプトとの実行順や DOM の構築に依存しないもの（計測・広告・チャットウィジェットなど）は、`defer` ではなく `async` を付けて読み込みます。

```html
<script async src="https://example.com/widget.js"></script>
```

## インラインスクリプトの例外

次の場合に限り、インラインスクリプトを使います。インラインに書くのは必要最小限のコードだけにしてください。

### 構造化データ

JSON-LD はデータなので、HTML に直接記述して構いません。書き方は [SEO](/frontend/quality/seo#構造化データ)を参照してください。

### 計測タグ

Google Tag Manager などの計測タグは、提供元が指定するコードをそのまま `<head>` に貼り付けます。書き換えると計測できなくなることがあります。

```html
<head>
  <!-- Google Tag Manager（提供元のコードをそのまま貼り付ける） -->
  <script>
    (function (w, d, s, l, i) { /* ... */ })(window, document, "script", "dataLayer", "GTM-XXXXXXX");
  </script>
</head>
```

### 表示のちらつき防止

ダークモードなど、ページを描画する前に決める必要がある状態は、`<head>` 内のインラインスクリプトで設定します。
`defer` やモジュールで読み込むと、一度描画された後に切り替わるため、画面がちらつきます。

```html
<head>
  <script>
    document.documentElement.dataset.theme =
      localStorage.getItem("theme") ??
      (matchMedia("(prefers-color-scheme: dark)").matches ? "dark" : "light");
  </script>
  <link rel="stylesheet" href="/assets/css/style.css" />
</head>
```
