在 javascript es modules 中,import.meta 是一个元数据对象,用于提供当前模块的上下文信息。它最核心的用途是获取当前模块的绝对 url(通过 import.meta.url),从而让模块能够基于自身位置解析相对路径的资源或子模块。要使用它,只需在模块顶层直接访问该属性即可,无需任何导入操作。

如何获取当前模块的绝对 URL
开发者通常需要通过 import.meta.url 获取当前脚本的绝对地址,以便构建相对于模块位置的资源路径。这在 Web 开发中非常常见,例如加载同目录下的 JSON 配置文件或图片。直接使用 new URL() 构造函数结合 import.meta.url 可以安全地拼接路径,避免硬编码带来的维护问题。

const baseUrl = new URL('.', import.meta.url);
const configUrl = new URL('config.json', baseUrl);
fetch(configUrl)
.then(res => res.json())
.then(data => console.log(data));
上述代码首先定义了一个指向当前模块所在目录的基础 URL,然后在此基础上拼接了 config.json。当这个脚本被浏览器或 Node.js 执行时,import.meta.url 会返回类似 file:///path/to/script.js 或 https://example.com/script.js 的字符串。最终生成的 configUrl 将是一个完整的绝对路径,确保 fetch 请求能正确定位到资源。
如何在 Node.js 中实现 require 的功能
在 Node.js 环境中,ES Modules 取代了传统的 CommonJS 模式。虽然 require() 是同步的且只能加载本地文件,但可以通过 import.meta.url 配合 fs 和 url 模块来实现类似的同步读取功能。这对于需要读取同目录下的配置文件或模板文件非常有用。
使用Atmosphere构建通过WebSocket、SSE、gRPC、WebTransport、MCP、A2A和AG-UI流传输的JVM代理网关,并带有治理钩子。

import { readFileSync } from 'fs';
import { fileURLToPath } from 'url';
import path from 'path';
// 模拟 __dirname 和 __filename
const __filename = fileURLToPath(import.meta.url);
const __dirname = path.dirname(__filename);
const data = readFileSync(path.join(__dirname, 'data.txt'), 'utf-8');
console.log(data);
这段代码展示了如何在 ES Module 中模拟 CommonJS 的全局变量。首先通过 fileURLToPath 将 import.meta.url 转换为文件系统路径,然后使用 path.dirname 获取目录名。最后利用 path.join 拼接出目标文件的完整路径并读取。这种方式保证了无论模块部署在哪里,都能准确找到相邻的文件。
import.meta 在非模块环境中的行为
如果在非 ES Module 环境(如普通 HTML 中的 <script></script> 标签)中使用 import.meta,会导致语法错误。这是因为 import.meta 是 ES Modules 规范的一部分,仅在模块上下文中有效。浏览器在解析传统脚本时不会识别该关键字,从而抛出 ReferenceError 或 SyntaxError。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南










