兼容性

Nuxt Kit 提供了一套工具,帮助您检查您的模块与不同 Nuxt 版本的兼容性。

Nuxt Kit 工具可以在 Nuxt 3、支持 Bridge 的 Nuxt 2 以及不支持 Bridge 的 Nuxt 2 中使用。为了确保您的模块与所有版本兼容,您可以使用 checkNuxtCompatibilityassertNuxtCompatibilityhasNuxtCompatibility 函数。它们会检查当前 Nuxt 版本是否符合您提供的约束条件。此外,您可以使用 isNuxt2isNuxt3getNuxtVersion 函数进行更细粒度的检查。

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
    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
    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
    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() 调用从上下文中获取。