MSIE JavaScript Engine 技术文档

1. 安装指南

MSIE JavaScript Engine 可以通过 NuGet 进行安装。在 NuGet 包管理器中搜索 MsieJavaScriptEngine 并安装即可。

2. 项目使用说明

MSIE JavaScript Engine 是一个 .NET 的包装器，用于与 Internet Explorer 和 Edge Legacy 的 JavaScript 引擎（JsRT 版本的 Chakra，ActiveScript 版本的 Chakra 和经典 JavaScript 引擎）进行交互。

项目支持以下五种模式，通过 JsEngineMode 枚举定义：

• Auto：自动选择机上可用的最新 JavaScript 引擎。
• Classic：经典 MSIE JavaScript 引擎（支持 ECMAScript 3，可通过使用 ECMAScript 5 Polyfill 和 JSON2 库）。需要机器上安装 Internet Explorer 6 或更高版本。.NET Core 版本不支持此模式。
• ChakraActiveScript：ActiveScript 版本的 Chakra JavaScript 引擎（支持 ECMAScript 5）。需要机器上安装 Internet Explorer 9 或更高版本。.NET Core 版本不支持此模式。
• ChakraIeJsRt：IE JsRT 版本的 Chakra JavaScript 引擎（支持 ECMAScript 5）。需要机器上安装 Internet Explorer 11 或 Microsoft Edge Legacy。
• ChakraEdgeJsRt：Edge JsRT 版本的 Chakra JavaScript 引擎（支持 ECMAScript 5）。需要机器上安装 Microsoft Edge Legacy。

支持的 .NET 类型包括：

• MsieJavaScriptEngine.Undefined
• System.Boolean
• System.Int32
• System.Double
• System.String

3. 项目 API 使用文档

以下是一个使用 MSIE JavaScript Engine 的简单示例：

using System;

using MsieJavaScriptEngine;
using MsieJavaScriptEngine.Helpers;

namespace MsieJavaScriptEngine.Example.Console
{
    class Program
    {
        static void Main(string[] args)
        {
            try
            {
                using (var jsEngine = new MsieJsEngine())
                {
                    const string expression = "7 * 8 - 20";
                    var result = jsEngine.Evaluate<int>(expression);

                    Console.WriteLine("{0} = {1}", expression, result);
                }
            }
            catch (JsEngineLoadException e)
            {
                Console.WriteLine("加载 JavaScript 引擎时发生错误。");
                Console.WriteLine();
                Console.WriteLine(JsErrorHelpers.GenerateErrorDetails(e));
            }
            catch (JsScriptException e)
            {
                Console.WriteLine("处理 JavaScript 代码时发生错误。");
                Console.WriteLine();
                Console.WriteLine(JsErrorHelpers.GenerateErrorDetails(e));
            }
            catch (JsException e)
            {
                Console.WriteLine("JavaScript 引擎运行时发生未知错误。");
                Console.WriteLine();
                Console.WriteLine(JsErrorHelpers.GenerateErrorDetails(e));
            }

            Console.ReadLine();
        }
    }
}

当创建 MsieJsEngine 类的实例时，可以通过构造函数传递 JavaScript 引擎设置。

以下 JsEngineSettings 类的属性详情：

属性名称	数据类型	默认值	描述
AllowReflection	Boolean	false	是否允许在脚本代码中使用反射 API。此选项影响 Object.GetType、Exception.GetType、Exception.TargetSite 和 Delegate.Method。
EnableDebugging	Boolean	false	是否允许通过在脚本代码中添加 debugger 语句来在 Visual Studio 中进行调试。
EngineMode	JsEngineMode 枚举	Auto	JavaScript 引擎模式。
MaxStackSize	Int32	503 808 或 1 007 616	最大堆栈大小，以字节为单位。设置为 0 使用可执行文件头部指定的默认最大堆栈大小。
UseEcmaScript5Polyfill	Boolean	false	是否使用 ECMAScript 5 Polyfill。
UseJson2Library	Boolean	false	是否使用 JSON2 库。

4. 项目安装方式

如前所述，您可以通过 NuGet 包管理器安装 MSIE JavaScript Engine。在 Visual Studio 的 NuGet 包管理器中搜索 MsieJavaScriptEngine 并执行安装操作即可。