プログラムによる使用
Nuxt Kit は、Nuxt をプログラムで操作するための一連のユーティリティを提供します。これらの関数を使用すると、Nuxt の読み込み、ビルド、Nuxt 設定の読み込みが可能です。
プログラムによる使用は、例えば CLI ツール や テストユーティリティ を構築する際に、Nuxt をプログラムで使用したい場合に役立ちます。
loadNuxt
Nuxt をプログラムで読み込みます。Nuxt の設定を読み込み、インスタンス化し、Nuxt インスタンスを持つプロミスを返します。
型
function loadNuxt (loadOptions?: LoadNuxtOptions): Promise<Nuxt>
パラメータ
loadOptions
: Nuxt の読み込み条件。loadNuxt
は内部で c12
を使用しているため、c12.loadConfig
と同じオプションを受け入れ、いくつかの追加オプションがあります:
プロパティ | 型 | 必須 | 説明 |
---|---|---|---|
dev | boolean | false | true に設定すると、Nuxt は開発モードで読み込まれます。 |
ready | boolean | true | true に設定すると、loadNuxt 呼び出し後に Nuxt を使用する準備が整います。false に設定すると、Nuxt を使用する準備が整っていることを確認するために nuxt.ready() を呼び出す必要があります。 |
buildNuxt
Nuxt をプログラムでビルドします。ビルダー(現在は @nuxt/vite-builder または @nuxt/webpack-builder)を呼び出してアプリケーションをバンドルします。
型
function buildNuxt (nuxt: Nuxt): Promise<any>
パラメータ
nuxt
: ビルドする Nuxt インスタンス。コンテキストから useNuxt()
呼び出しを通じて取得できます。
loadNuxtConfig
Nuxt 設定を読み込みます。設定オブジェクトを持つプロミスを返します。
型
function loadNuxtConfig (options: LoadNuxtConfigOptions): Promise<NuxtOptions>
パラメータ
options
: c12
の loadConfig
呼び出しに渡すオプション。
writeTypes
tsconfig.json
を生成し、プロジェクトの buildDir に書き込みます。
型
function writeTypes (nuxt?: Nuxt): void
パラメータ
nuxt
: ビルドする Nuxt インスタンス。コンテキストから useNuxt()
呼び出しを通じて取得できます。
※このページは Nuxt.js 公式ドキュメントの翻訳ページ(非公式)です。
公式ドキュメントの該当ページはこちら:
https://nuxt.com/docs/3.x/api/kit/programmatic