Nuxt Nation 大会即将到来。加入我们,时间为 11 月 12 日至 13 日。

程序化使用

Nuxt Kit 提供了一套实用程序,可帮助您以编程方式使用 Nuxt。这些函数允许您加载 Nuxt、构建 Nuxt 和加载 Nuxt 配置。

程序化使用在您希望以编程方式使用 Nuxt 时非常有用,例如,在构建 CLI 工具测试工具 时。

loadNuxt

以编程方式加载 Nuxt。它将加载 Nuxt 配置,实例化并返回包含 Nuxt 实例的 Promise。

类型

async function loadNuxt (loadOptions?: LoadNuxtOptions): Promise<Nuxt>

interface LoadNuxtOptions extends LoadNuxtConfigOptions {
  dev?: boolean
  ready?: boolean
}

参数

loadOptions

类型: LoadNuxtOptions

默认值: {}

Nuxt 的加载条件。 loadNuxt 在内部使用 c12,因此它接受与 c12.loadConfig 相同的选项,以及一些其他选项

  • dev (可选)
    类型: boolean
    默认值: false
    如果设置为 true,则 Nuxt 将在开发模式下加载。
  • ready (可选)
    类型: boolean
    默认值: true
    如果设置为 true,则在 loadNuxt 调用后,Nuxt 将可以使用。如果设置为 false,则需要调用 nuxt.ready() 以确保 Nuxt 已准备好使用。

buildNuxt

以编程方式构建 Nuxt。它将调用构建器(目前是 @nuxt/vite-builder@nuxt/webpack-builder)来捆绑应用程序。

类型

async function buildNuxt (nuxt: Nuxt): Promise<any>

参数

nuxt

类型: Nuxt

必填: true

要构建的 Nuxt 实例。可以通过 useNuxt() 调用从上下文中获取。

loadNuxtConfig

加载 Nuxt 配置。它将返回包含配置对象的 Promise。

类型

async function loadNuxtConfig (options: LoadNuxtConfigOptions): Promise<NuxtOptions>

参数

options

类型: LoadNuxtConfigOptions

必填: true

传递给 c12 loadConfig 调用的选项。

writeTypes

生成 tsconfig.json 并将其写入项目 buildDir。

类型

function writeTypes (nuxt?: Nuxt): void

interface Nuxt {
  options: NuxtOptions
  hooks: Hookable<NuxtHooks>
  hook: Nuxt['hooks']['hook']
  callHook: Nuxt['hooks']['callHook']
  addHooks: Nuxt['hooks']['addHooks']
  ready: () => Promise<void>
  close: () => Promise<void>
  server?: any
  vfs: Record<string, string>
  apps: Record<string, NuxtApp>
}

参数

nuxt

类型: Nuxt

必填: true

要构建的 Nuxt 实例。可以通过 useNuxt() 调用从上下文中获取。