v3.16
Nuxt on GitHub

导入元数据

使用 `import.meta` 了解你的代码运行环境。

import.meta 对象

通过 ES 模块，你可以从导入或编译你的 ES 模块的代码中获取一些元数据。 这是通过 import.meta 实现的，它是一个为你的代码提供这些信息的对象。 在 Nuxt 文档中，你可能会看到一些代码片段已经使用它来判断代码当前是在客户端还是服务器端运行。

了解更多关于 import.meta 的信息。

运行时（应用）属性

这些值是静态注入的，可用于在运行时进行代码树摇优化。

属性类型描述
import.meta.clientboolean在客户端评估时为 true。
import.meta.browserboolean在客户端评估时为 true。
import.meta.serverboolean在服务器端评估时为 true。
import.meta.nitroboolean在服务器端评估时为 true。
import.meta.devboolean运行 Nuxt 开发服务器时为 true。
import.meta.testboolean在测试环境中运行时为 true。
import.meta.prerenderboolean在构建的预渲染阶段渲染 HTML 时为 true。

构建器属性

这些值在模块和你的 nuxt.config 中均可用。

属性类型描述
import.meta.envobject等同于 process.env
import.meta.urlstring当前文件的可解析路径。

示例

使用 import.meta.url 在模块中解析文件

modules/my-module/index.ts
import { createResolver } from 'nuxt/kit'

// 相对于当前文件解析
const resolver = createResolver(import.meta.url)

export default defineNuxtModule({
  meta: { name: 'myModule' },
  setup() {
    addComponent({
      name: 'MyModuleComponent',
      // 解析为 '/modules/my-module/components/MyModuleComponent.vue'
      filePath: resolver.resolve('./components/MyModuleComponent.vue')
    })
  }
})