TypeScript

Nuxt3は完全に型付けされており、コーディング中に正確な型情報にアクセスできるように便利なショートカットが提供されています。

型チェック

デフォルトでは、パフォーマンス上の理由から、Nuxtはnuxi devやnuxi buildを実行する際には型チェックを行いません。ただし、vue-tscとtypescriptをdevDependenciesとしてインストールし、nuxt.config ファイルで typescript.typeCheckオプションを有効にするか、nuxiを使用して手動で型をチェックすることで、ビルド時または開発時に型チェックを有効にすることができます。

yarn nuxi typecheck

自動生成された型

nuxi devやnuxi buildを実行すると、Nuxtは以下のファイルを生成し、IDEの型サポート（および型チェック）を提供します。

.nuxt/nuxt.d.ts

このファイルには、使用しているモジュールの型と、Nuxt3が必要とするキータイプが含まれています。IDEはこれらの型を自動的に認識するはずです。

このファイル内のいくつかの参照は、buildDir（.nuxtディレクトリ）内でのみ生成されるファイルを指しています。したがって、完全な型情報を得るためには、nuxi devやnuxi buildを実行する必要があります。

.nuxt/tsconfig.json

このファイルには、お勧めの基本的なTypeScriptの設定が含まれています。Nuxtによって解決されたエイリアスや使用しているモジュールなどが注入されているため、~/fileや#build/fileのようなエイリアスに対して完全な型サポートとパスの自動補完を得ることができます。

この設定を拡張する方法について詳細を読む

厳格なチェック

TypeScriptは、プログラムの安全性と解析を向上させるための特定のチェックを提供しています。

一度コードベースをTypeScriptに変換し、それに慣れてきたら、より高い安全性のためにこれらのチェックを有効にすることができます（詳細はこちらを参照してください）。

厳格な型チェックを有効にするには、nuxt.configを更新する必要があります。

export default defineNuxtConfig({
  typescript: {
    strict: true,
  },
});