Home

Awesome

MSIE JavaScript Engine for .NET NuGet version Download count

MSIE JS Engine Logo

This project is a .NET wrapper for working with the JavaScript engines of Internet Explorer and Edge Legacy (JsRT versions of Chakra, ActiveScript version of Chakra and Classic JavaScript Engine). Project was based on the code of SassAndCoffee.JavaScript, Chakra Sample Hosts and jsrt-dotnet.

MSIE JavaScript Engine requires a installation of Internet Explorer or Edge Legacy on the machine and can work in 5 modes, that are defined in the <code title="MsieJavaScriptEngine.JsEngineMode">JsEngineMode</code> enumeration:

The supported .NET types are as follows:

Installation

This library can be installed through NuGet - https://www.nuget.org/packages/MsieJavaScriptEngine.

Usage

Consider a simple example of usage of the 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("During loading of JavaScript engine an error occurred.");
                Console.WriteLine();
                Console.WriteLine(JsErrorHelpers.GenerateErrorDetails(e));
            }
            catch (JsScriptException e)
            {
                Console.WriteLine("During processing of JavaScript code an error occurred.");
                Console.WriteLine();
                Console.WriteLine(JsErrorHelpers.GenerateErrorDetails(e));
            }
            catch (JsException e)
            {
                Console.WriteLine("During working of JavaScript engine an unknown error occurred.");
                Console.WriteLine();
                Console.WriteLine(JsErrorHelpers.GenerateErrorDetails(e));
            }

            Console.ReadLine();
        }
    }
}

First we create an instance of the <code title="MsieJavaScriptEngine.MsieJsEngine">MsieJsEngine</code> class. Then we evaluate a JavaScript expression by using of the Evaluate method and output its result to the console. In addition, we provide handling of the following exception types: <code title="MsieJavaScriptEngine.JsEngineLoadException">JsEngineLoadException</code>, <code title="MsieJavaScriptEngine.JsScriptException">JsScriptException</code> and <code title="MsieJavaScriptEngine.JsException">JsException</code>. In the MSIE JavaScript Engine, exceptions have the following hierarchy:

Also, when you create an instance of the <code title="MsieJavaScriptEngine.MsieJsEngine">MsieJsEngine</code> class, then you can pass the JavaScript engine settings via the constructor. Consider in detail properties of the <code title="MsieJavaScriptEngine.JsEngineSettings">JsEngineSettings</code> class:

<table border="1" style="font-size: 0.7em"> <thead> <tr valign="top"> <th>Property name</th> <th>Data&nbsp;type</th> <th>Default value</th> <th>Description</th> </tr> </thead> <tbody> <tr valign="top"> <td><code>AllowReflection</code></td> <td><code title="System.Boolean">Boolean</code></td> <td><code>false</code></td> <td> <p>Flag for whether to allow the usage of reflection API in the script code.</p> <p>This affects <code>Object.GetType</code>, <code>Exception.GetType</code>, <code>Exception.TargetSite</code> and <code>Delegate.Method</code>.</p> </td> </tr> <tr valign="top"> <td><code>EnableDebugging</code></td> <td><code title="System.Boolean">Boolean</code></td> <td><code>false</code></td> <td>Flag for whether to allow debugging in Visual Studio by adding the <code>debugger</code> statement to script code.</td> </tr> <tr valign="top"> <td><code>EngineMode</code></td> <td><code title="MsieJavaScriptEngine.JsEngineMode">JsEngineMode</code> enumeration</td> <td><code>Auto</code></td> <td>JavaScript engine mode.</td> </tr> <tr valign="top"> <td><code>MaxStackSize</code></td> <td><code title="System.Int32">Int32</code></td> <td><code>503 808</code> or <code>1 007 616</code></td> <td> <p>Maximum stack size in bytes.</p> <p>Set a <code>0</code> to use the default maximum stack size specified in the header for the executable.</p> </td> </tr> <tr valign="top"> <td><code>UseEcmaScript5Polyfill</code></td> <td><code title="System.Boolean">Boolean</code></td> <td><code>false</code></td> <td>Flag for whether to use the ECMAScript 5 Polyfill.</td> </tr> <tr valign="top"> <td><code>UseJson2Library</code></td> <td><code title="System.Boolean">Boolean</code></td> <td><code>false</code></td> <td>Flag for whether to use the <a href="https://github.com/douglascrockford/JSON-js">JSON2</a> library</td> </tr> </tbody> </table>

Release History

See the changelog.

License

Apache License Version 2.0

Credits

Who's Using MSIE JavaScript Engine

If you use the MSIE JavaScript Engine in some project, please send me a message so I can include it in this list: