QuickJS模块返回值机制解析

模块与脚本的差异

在QuickJS引擎中，模块(module)和普通脚本(script)的执行机制存在重要区别。当开发者使用JS_EVAL_FUNCTION和JS_STD_AWAIT处理模块代码时，经常会遇到返回值获取不到的问题，这实际上是QuickJS的预期行为。

返回值处理机制

对于普通脚本，QuickJS会直接返回脚本的执行结果。例如，当执行一个包含return语句的函数时，eval_buf函数能够正确获取到返回值。然而，模块的执行机制完全不同：

1. 模块总是异步执行：模块的加载和执行过程是异步的，即使代码看起来是同步的
2. 默认返回undefined：模块顶层代码的返回值会被忽略，默认返回undefined
3. 异常处理：模块执行过程中如果抛出异常，会通过异常机制传递

技术实现细节

在QuickJS的eval_buf函数实现中，模块和脚本采用了不同的处理路径：

• 对于模块代码，会先进行编译(JS_EVAL_FLAG_COMPILE_ONLY)，然后设置import.meta信息，最后执行并等待(js_std_await)
• 对于普通脚本，直接执行并返回结果

这种差异源于ES模块规范的设计，模块需要处理可能的异步加载和依赖关系，因此不能简单地同步返回执行结果。

实际应用建议

开发者如果需要获取模块的执行结果，可以考虑以下方案：

1. 使用导出机制：通过export导出需要返回的值
2. 回调函数：在模块执行完成后调用回调函数
3. Promise封装：将模块执行过程封装为Promise

理解QuickJS的这种设计差异对于正确使用模块系统至关重要，特别是在需要获取模块执行结果的场景下。