プログラムによる使用
Nuxt Kitは、Nuxtをプログラムで操作するためのユーティリティセットを提供します。これらの関数を使用すると、Nuxtの読み込み、ビルド、Nuxt設定の読み込みが可能です。
プログラムによる使用は、例えばCLIツールやテストユーティリティを構築する際に、Nuxtをプログラムで使用したい場合に役立ちます。
loadNuxt
Nuxtをプログラムで読み込みます。Nuxtの設定を読み込み、インスタンス化し、Nuxtインスタンスを持つPromiseを返します。
型
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設定を読み込みます。設定オブジェクトを持つPromiseを返します。
型
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/4.x/api/kit/programmatic