在 QuickJS 中，JS_Eval() 函数用于在给定的 JavaScript 上下文（JSContext）中评估和执行一段 JavaScript 代码。这个函数是嵌入式 JavaScript 引擎的重要接口，允许您在 C 代码中动态执行 JavaScript 脚本。

别志华2024年9月19日大约 4 分钟

在 QuickJS 中，`JS_Eval()` 函数用于在给定的 JavaScript 上下文（`JSContext`）中评估和执行一段 JavaScript 代码。这个函数是嵌入式 JavaScript 引擎的重要接口，允许您在 C 代码中动态执行 JavaScript 脚本。

函数定义

JSValue JS_Eval(JSContext *ctx,
                const char *input,
                size_t input_len,
                const char *filename,
                int eval_flags);

参数说明

JSContext *ctx：JavaScript 上下文，表示当前的执行环境。所有的 JavaScript 操作都在这个上下文中进行。
const char *input：要评估和执行的 JavaScript 代码字符串。
size_t input_len：input 字符串的长度（以字节为单位）。如果 input 是以 '\0' 结尾的字符串，可以使用 strlen(input) 获取长度。
const char *filename：源代码的文件名，用于错误报告和调试信息。如果没有实际的文件名，可以传入 "eval" 或其他描述性的字符串。
int eval_flags：评估标志，控制代码的解析和执行方式。常用的标志包括：
- 代码类型标志：
  - JS_EVAL_TYPE_GLOBAL：将代码作为全局代码执行（默认）。
  - JS_EVAL_TYPE_MODULE：将代码作为模块代码执行，允许使用 import 和 export。
- 执行模式标志：
  - JS_EVAL_FLAG_STRICT：强制以严格模式执行代码。
  - JS_EVAL_FLAG_STRIP：移除调试信息，优化内存使用和安全性。

返回值

JSValue：表示评估结果的 JavaScript 值。如果执行成功，返回值可能是任意 JavaScript 类型（如数字、字符串、对象等）。如果发生错误，返回一个异常值，需要使用 JS_IsException() 进行检查。

使用方法

基本用法

以下是如何使用 JS_Eval() 函数的基本步骤：

准备 JavaScript 代码：定义要执行的 JavaScript 脚本。
调用 JS_Eval()：将代码和相关参数传递给函数。
处理返回值：检查是否有异常发生，处理结果。
释放资源：释放返回的 JSValue，防止内存泄漏。

示例代码

示例 1：执行全局代码

const char *code = "console.log('Hello, QuickJS!');";
size_t code_len = strlen(code);
JSValue result = JS_Eval(ctx, code, code_len, "mycode.js", JS_EVAL_TYPE_GLOBAL);

if (JS_IsException(result)) {
    // 处理异常
    JSValue exception = JS_GetException(ctx);
    const char *error_str = JS_ToCString(ctx, exception);
    printf("执行出错：%s\n", error_str);
    JS_FreeCString(ctx, error_str);
    JS_FreeValue(ctx, exception);
} else {
    // 正常执行
    // 处理结果（如果有必要）
}

JS_FreeValue(ctx, result);

示例 2：在严格模式下执行代码

const char *code = "'use strict'; var a = 10;";
// 设置标志为全局代码和严格模式
int eval_flags = JS_EVAL_TYPE_GLOBAL | JS_EVAL_FLAG_STRICT;

JSValue result = JS_Eval(ctx, code, strlen(code), "strict_code.js", eval_flags);

if (JS_IsException(result)) {
    // 处理异常
    // ...
}

JS_FreeValue(ctx, result);

示例 3：执行模块代码

const char *module_code = "export function add(a, b) { return a + b; }";
int eval_flags = JS_EVAL_TYPE_MODULE;

JSValue result = JS_Eval(ctx, module_code, strlen(module_code), "module_code.js", eval_flags);

if (JS_IsException(result)) {
    // 处理异常
    // ...
} else {
    // 模块已成功加载，可以使用 import 语句或其他方式访问导出的内容
}

JS_FreeValue(ctx, result);

详细说明

1. `JSContext *ctx`

作用：指定 JavaScript 代码执行的上下文环境。
注意事项：确保在创建的上下文中执行，并在使用完毕后正确释放上下文。

2. `const char *input` 和 `size_t input_len`

作用：提供要执行的 JavaScript 代码及其长度。
注意事项：代码可以是任何有效的 JavaScript 脚本，长度必须准确。

3. `const char *filename`

作用：用于错误报告和调试信息，指示代码的来源。
建议：即使代码不是来自文件，也应提供一个描述性的名称，便于调试。

4. `int eval_flags`

作用：控制代码的解析和执行方式。
常用标志：
- JS_EVAL_TYPE_GLOBAL：默认值，将代码作为全局脚本执行。
- JS_EVAL_TYPE_MODULE：将代码作为模块执行，支持模块语法。
- JS_EVAL_FLAG_STRICT：强制代码以严格模式执行，捕获潜在的错误。
- JS_EVAL_FLAG_STRIP：移除调试信息，减少内存占用，增强代码安全性。
标志组合：使用按位或操作符 | 组合多个标志。

5. 返回值处理

成功：返回 JavaScript 值，需要根据具体情况处理。
失败：返回异常，需要使用 JS_IsException() 检查，并使用 JS_GetException() 获取异常信息。

6. 内存管理

释放值：所有通过 JS_Eval() 返回的 JSValue，在使用完毕后都应调用 JS_FreeValue(ctx, val) 进行释放。
防止泄漏：及时释放异常信息和字符串，以防止内存泄漏。

注意事项

线程安全：QuickJS 的上下文不是线程安全的。在多线程环境中，需要确保线程同步。
错误处理：始终检查返回值是否为异常，避免程序崩溃。
安全性：执行动态代码可能带来安全风险，应确保代码来源可靠。

总结

JS_Eval() 函数是 QuickJS 中执行动态 JavaScript 代码的核心接口。通过理解其参数和使用方法，您可以在 C 应用程序中集成 JavaScript 解释器，实现灵活的脚本执行和扩展功能。

功能：在指定的上下文中评估并执行 JavaScript 代码。
用途：动态执行脚本、加载和运行模块、实现脚本化的逻辑控制。
使用方法：提供代码字符串、设置合适的标志、处理返回值和异常。

通过合理使用 JS_Eval()，您可以大大增强应用程序的可扩展性和动态性。