如何使用Jint获取JavaScript函数内部的局部变量值？

问题场景 #

执行动态生成的JavaScript代码（无法修改原代码），需要获取函数内部定义的局部变量值。

示例JavaScript代码 #

var globalVar = 5;

function myFunc(a, b) {
    var localVar1 = { "Hello" : 987 };
    var localVar2 = a + b;
    return;
}

现有C#代码（仅作示例，方法不存在） #

jintEngine.Execute(testStr);

// 以下方法在Jint中不存在，仅作示例...
var valueStr = jintEngine.GoToFunc("myFunc").GetValue("localVar1").ToString();

需求：将localVar1的值转为字符串获取。

解决方案 #

Jint默认无法直接访问函数的局部变量（局部变量属于函数私有作用域），可以通过以下两种方法实现：

方法1：使用Jint调试API拦截执行 #

利用Jint的调试接口，在函数执行过程中捕获作用域内的变量。

using Jint;
using Jint.Debugger;

var testStr = @"
var globalVar = 5;

function myFunc(a, b) {
    var localVar1 = { ""Hello"" : 987 };
    var localVar2 = a + b;
    return;
}
";

var engine = new Engine();
var debugHandler = new DebugHandler();
engine.SetDebugHandler(debugHandler);

object localVar1Value = null;

// 注册调试步进事件
debugHandler.Step += (sender, e) =>
{
    // 确认当前在目标函数内，且已执行到localVar1定义后
    if (e.Function.Name == "myFunc" && e.Statement.ToString().Contains("var localVar2"))
    {
        // 从当前作用域提取变量
        localVar1Value = e.Environment.GetValue("localVar1").ToObject();
        // 终止调试流程
        e.Break();
    }
};

// 启用调试模式
engine.DebugMode = true;

// 调用目标函数（传入任意合法参数即可）
engine.Invoke("myFunc", 1, 2);

// 将变量转为JSON字符串
var valueStr = engine.Json.Stringify(localVar1Value);

方法2：动态修改函数代码暴露变量 #

在不修改原始JS代码文件的前提下，动态修改函数定义，将局部变量挂载到全局作用域，之后从全局获取。

using Jint;

var testStr = @"
var globalVar = 5;

function myFunc(a, b) {
    var localVar1 = { ""Hello"" : 987 };
    var localVar2 = a + b;
    return;
}
";

var engine = new Engine();
engine.Execute(testStr);

// 获取原函数的源代码
var originalFunc = engine.GetValue("myFunc").AsFunction();
var funcSource = originalFunc.ToString();

// 修改函数代码，在return前添加将localVar1挂载到全局的逻辑
var modifiedFuncSource = funcSource.Replace("return;", @"window.__capturedVar = localVar1; return;");

// 执行修改后的函数定义，覆盖原函数
engine.Execute(modifiedFuncSource);

// 调用函数触发变量挂载
engine.Invoke("myFunc", 1, 2);

// 从全局获取变量并转为字符串
var localVar1Value = engine.GetValue("__capturedVar").ToObject();
var valueStr = engine.Json.Stringify(localVar1Value);

// 可选：清理全局临时变量
engine.Execute("delete window.__capturedVar;");

方法对比 #

• 调试API法：无需修改函数代码，精度高，但调试事件逻辑稍复杂，适合对原代码完整性要求高的场景。
• 动态修改法：逻辑直观易实现，但依赖函数源代码的格式（如return语句的写法），需根据实际代码调整替换规则。

内容的提问来源于stack exchange，提问作者Hamid Z