兼容性

Nuxt Kit 工具可以在 Nuxt 3、Nuxt 2 桥接版以及甚至没有桥接版的 Nuxt 2 中使用。为了确保您的模块与所有版本兼容，您可以使用 checkNuxtCompatibility、assertNuxtCompatibility 和 hasNuxtCompatibility 函数。它们将检查当前 Nuxt 版本是否满足您提供的约束。您还可以使用 isNuxt2、isNuxt3 和 getNuxtVersion 函数进行更细致的检查。

checkNuxtCompatibility

检查当前 Nuxt 版本的约束是否满足。如果不满足，返回一个包含消息的数组。Nuxt 2 的版本也会检查 bridge 的支持。

类型

async function checkNuxtCompatibility(
  constraints: NuxtCompatibility,
  nuxt?: Nuxt
): Promise<NuxtCompatibilityIssues>;

interface NuxtCompatibility {
  nuxt?: string;
  bridge?: boolean;
  builder?: {
    // 如果您模块不兼容构建器，或者是一个语义兼容的字符串版本约束
    // 请设置为 `false`
    vite?: false | string;
    webpack?: false | string;
  };
}

interface NuxtCompatibilityIssue {
  name: string;
  message: string;
}

interface NuxtCompatibilityIssues extends Array<NuxtCompatibilityIssue> {
  toString(): string;
}

参数

constraints

类型: NuxtCompatibility

默认值: {}

要检查的约束。它接受以下属性：

• nuxt（可选）
  类型: string
  以 semver 格式定义的 Nuxt 版本。版本可能会以 Node.js 的方式定义，例如：>=2.15.0 <3.0.0。
• bridge（可选）
  类型: boolean
  如果设置为 true，它将检查当前 Nuxt 版本是否支持 bridge。

nuxt

类型: Nuxt

默认值: useNuxt()

Nuxt 实例。如果没有提供，它将通过 useNuxt() 调用从上下文中检索。

assertNuxtCompatibility

断言当前 Nuxt 版本的约束是否满足。如果不满足，则抛出一个带有问题列表作为字符串的错误。

类型

async function assertNuxtCompatibility(
  constraints: NuxtCompatibility,
  nuxt?: Nuxt
): Promise<true>;

interface NuxtCompatibility {
  nuxt?: string;
  bridge?: boolean;
}

参数

constraints

类型: NuxtCompatibility

默认值: {}

要检查的约束。它接受以下属性：

• nuxt（可选）
  类型: string
  以 semver 格式定义的 Nuxt 版本。版本可能会以 Node.js 的方式定义，例如：>=2.15.0 <3.0.0。
• bridge（可选）
  类型: boolean
  如果设置为 true，它将检查当前 Nuxt 版本是否支持 bridge。

nuxt

类型: Nuxt

默认值: useNuxt()

Nuxt 实例。如果没有提供，它将通过 useNuxt() 调用从上下文中检索。

hasNuxtCompatibility

检查当前 Nuxt 版本的约束是否满足。如果所有约束都满足，则返回 true，否则返回 false。Nuxt 2 的版本也会检查 bridge 的支持。

类型

async function hasNuxtCompatibility(
  constraints: NuxtCompatibility,
  nuxt?: Nuxt
): Promise<boolean>;

interface NuxtCompatibility {
  nuxt?: string;
  bridge?: boolean;
}

参数

constraints

类型: NuxtCompatibility

默认值: {}

要检查的约束。它接受以下属性：

• nuxt（可选）
  类型: string
  以 semver 格式定义的 Nuxt 版本。版本可能会以 Node.js 的方式定义，例如：>=2.15.0 <3.0.0。
• bridge（可选）
  类型: boolean
  如果设置为 true，它将检查当前 Nuxt 版本是否支持 bridge。

nuxt

类型: Nuxt

默认值: useNuxt()

Nuxt 实例。如果没有提供，它将通过 useNuxt() 调用从上下文中检索。

isNuxt2

检查当前 Nuxt 版本是否为 2.x。

类型

function isNuxt2(nuxt?: Nuxt): boolean;

参数

nuxt

类型: Nuxt

默认值: useNuxt()

Nuxt 实例。如果没有提供，它将通过 useNuxt() 调用从上下文中检索。

isNuxt3

检查当前 Nuxt 版本是否为 3.x。

类型

function isNuxt3(nuxt?: Nuxt): boolean;

参数

nuxt

类型: Nuxt

默认值: useNuxt()

Nuxt 实例。如果没有提供，它将通过 useNuxt() 调用从上下文中检索。

getNuxtVersion

返回当前 Nuxt 版本。

类型

function getNuxtVersion(nuxt?: Nuxt): string;

参数

nuxt

类型: Nuxt

默认值: useNuxt()

Nuxt 实例。如果没有提供，它将通过 useNuxt() 调用从上下文中检索。