namespace MsieJavaScriptEngine

{

using System;

using System.Reflection;

using System.Text;

using ActiveScript;

using Helpers;

using JsRt;

using Resources;

using Utilities;

/// <summary>

/// .NET-wrapper for working with the Internet Explorer's JavaScript engines

/// </summary>

public sealed class MsieJsEngine : IDisposable

{

/// <summary>

/// JavaScript engine

/// </summary>

private IInnerJsEngine _jsEngine;

/// <summary>

/// Flag that object is destroyed

/// </summary>

private bool _disposed;

/// <summary>

/// Gets a name of JavaScript engine mode

/// </summary>

public string Mode

{

get { return _jsEngine.Mode; }

}

/// <summary>

/// Constructs instance of MSIE JavaScript engine

/// </summary>

/// <exception cref="MsieJavaScriptEngine.JsEngineLoadException">Failed to load a JavaScript engine.</exception>

/// <exception cref="System.NotSupportedException">Selected mode of JavaScript engine is not supported.</exception>

public MsieJsEngine()

: this(new JsEngineSettings())

{ }

/// <summary>

/// Constructs instance of MSIE JavaScript engine

/// </summary>

/// <param name="engineMode">JavaScript engine mode</param>

/// <exception cref="MsieJavaScriptEngine.JsEngineLoadException">Failed to load a JavaScript engine.</exception>

/// <exception cref="System.NotSupportedException">Selected mode of JavaScript engine is not supported.</exception>

[Obsolete]

public MsieJsEngine(JsEngineMode engineMode)

: this(new JsEngineSettings

{

EngineMode = engineMode

})

{ }

/// <summary>

/// Constructs instance of MSIE JavaScript engine

/// </summary>

/// <param name="engineMode">JavaScript engine mode</param>

/// <param name="useEcmaScript5Polyfill">Flag for whether to use the ECMAScript 5 Polyfill</param>

/// <exception cref="MsieJavaScriptEngine.JsEngineLoadException">Failed to load a JavaScript engine.</exception>

/// <exception cref="System.NotSupportedException">Selected mode of JavaScript engine is not supported.</exception>

[Obsolete]

public MsieJsEngine(JsEngineMode engineMode, bool useEcmaScript5Polyfill)

: this(new JsEngineSettings

{

EngineMode = engineMode,

UseEcmaScript5Polyfill = useEcmaScript5Polyfill

})

{ }

/// <summary>

/// Constructs instance of MSIE JavaScript engine

/// </summary>

/// <param name="useEcmaScript5Polyfill">Flag for whether to use the ECMAScript 5 Polyfill</param>

/// <exception cref="MsieJavaScriptEngine.JsEngineLoadException">Failed to load a JavaScript engine.</exception>

/// <exception cref="System.NotSupportedException">Selected mode of JavaScript engine is not supported.</exception>

[Obsolete]

public MsieJsEngine(bool useEcmaScript5Polyfill)

: this(new JsEngineSettings

{

UseEcmaScript5Polyfill = useEcmaScript5Polyfill

})

{ }

/// <summary>

/// Constructs instance of MSIE JavaScript engine

/// </summary>

/// <param name="useEcmaScript5Polyfill">Flag for whether to use the ECMAScript 5 Polyfill</param>

/// <param name="useJson2Library">Flag for whether to use the JSON2 library</param>

/// <exception cref="MsieJavaScriptEngine.JsEngineLoadException">Failed to load a JavaScript engine.</exception>

/// <exception cref="System.NotSupportedException">Selected mode of JavaScript engine is not supported.</exception>

[Obsolete]

public MsieJsEngine(bool useEcmaScript5Polyfill, bool useJson2Library)

: this(new JsEngineSettings

{

UseEcmaScript5Polyfill = useEcmaScript5Polyfill,

UseJson2Library = useJson2Library

})

{ }

/// <summary>

/// Constructs instance of MSIE JavaScript engine

/// </summary>

/// <param name="engineMode">JavaScript engine mode</param>

/// <param name="useEcmaScript5Polyfill">Flag for whether to use the ECMAScript 5 Polyfill</param>

/// <param name="useJson2Library">Flag for whether to use the JSON2 library</param>

/// <exception cref="MsieJavaScriptEngine.JsEngineLoadException">Failed to load a JavaScript engine.</exception>

/// <exception cref="System.NotSupportedException">Selected mode of JavaScript engine is not supported.</exception>

[Obsolete]

public MsieJsEngine(JsEngineMode engineMode, bool useEcmaScript5Polyfill, bool useJson2Library)

: this(new JsEngineSettings

{

EngineMode = engineMode,

UseEcmaScript5Polyfill = useEcmaScript5Polyfill,

UseJson2Library = useJson2Library

})

{ }

/// <summary>

/// Constructs instance of MSIE JavaScript engine

/// </summary>

/// <param name="settings">JavaScript engine settings</param>

/// <exception cref="MsieJavaScriptEngine.JsEngineLoadException">Failed to load a JavaScript engine.</exception>

/// <exception cref="System.NotSupportedException">Selected mode of JavaScript engine is not supported.</exception>

public MsieJsEngine(JsEngineSettings settings)

{

JsEngineMode engineMode = settings.EngineMode;

JsEngineMode processedEngineMode = engineMode;

if (engineMode == JsEngineMode.Auto)

{

if (ChakraJsRtJsEngine.IsSupported())

{

processedEngineMode = JsEngineMode.ChakraJsRt;

}

else if (ChakraActiveScriptJsEngine.IsSupported())

{

processedEngineMode = JsEngineMode.ChakraActiveScript;

}

else if (ClassicActiveScriptJsEngine.IsSupported())

{

processedEngineMode = JsEngineMode.Classic;

}

else

{

throw new JsEngineLoadException(Strings.Runtime_JsEnginesNotFound);

}

}

switch (processedEngineMode)

{

case JsEngineMode.ChakraJsRt:

_jsEngine = new ChakraJsRtJsEngine();

break;

case JsEngineMode.ChakraActiveScript:

_jsEngine = new ChakraActiveScriptJsEngine();

break;

case JsEngineMode.Classic:

_jsEngine = new ClassicActiveScriptJsEngine(settings.UseEcmaScript5Polyfill,

settings.UseJson2Library);

break;

default:

throw new NotSupportedException(

string.Format(Strings.Runtime_JsEngineModeNotSupported, processedEngineMode));

}

}

private void VerifyNotDisposed()

{

if (_disposed)

{

throw new ObjectDisposedException(ToString());

}

}

/// <summary>

/// Evaluates an expression

/// </summary>

/// <param name="expression">JavaScript expression</param>

/// <returns>Result of the expression</returns>

/// <exception cref="System.ObjectDisposedException">Operation is performed on a disposed MSIE

/// JavaScript engine.</exception>

/// <exception cref="System.ArgumentException" />

/// <exception cref="MsieJavaScriptEngine.JsRuntimeException">JavaScript runtime error.</exception>

public object Evaluate(string expression)

{

VerifyNotDisposed();

if (string.IsNullOrWhiteSpace(expression))

{

throw new ArgumentException(

string.Format(Strings.Common_ArgumentIsEmpty, "expression"), "expression");

}

return _jsEngine.Evaluate(expression);

}

/// <summary>

/// Evaluates an expression

/// </summary>

/// <typeparam name="T">Type of result</typeparam>

/// <param name="expression">JavaScript expression</param>

/// <returns>Result of the expression</returns>

/// <exception cref="System.ObjectDisposedException">Operation is performed on a disposed MSIE

/// JavaScript engine.</exception>

/// <exception cref="System.ArgumentException" />

/// <exception cref="MsieJavaScriptEngine.NotSupportedTypeException">The type of return value

/// is not supported.</exception>

/// <exception cref="MsieJavaScriptEngine.JsRuntimeException">JavaScript runtime error.</exception>

public T Evaluate<T>(string expression)

{

VerifyNotDisposed();

if (string.IsNullOrWhiteSpace(expression))

{

throw new ArgumentException(

string.Format(Strings.Common_ArgumentIsEmpty, "expression"), "expression");

}

Type returnValueType = typeof(T);

if (!ValidationHelpers.IsSupportedType(returnValueType))

{

throw new NotSupportedTypeException(

string.Format(Strings.Runtime_ReturnValueTypeNotSupported, returnValueType.FullName));

}

object result = _jsEngine.Evaluate(expression);

return TypeConverter.ConvertToType<T>(result);

}

/// <summary>

/// Executes a code

/// </summary>

/// <param name="code">JavaScript code</param>

/// <exception cref="System.ObjectDisposedException">Operation is performed on a disposed MSIE

/// JavaScript engine.</exception>

/// <exception cref="System.ArgumentException" />

/// <exception cref="MsieJavaScriptEngine.JsRuntimeException">JavaScript runtime error.</exception>

public void Execute(string code)

{

VerifyNotDisposed();

if (string.IsNullOrWhiteSpace(code))

{

throw new ArgumentException(

string.Format(Strings.Common_ArgumentIsEmpty, "code"), "code");

}

_jsEngine.Execute(code);

}

/// <summary>

/// Executes a code from JS-file

/// </summary>

/// <param name="path">Path to the JS-file</param>

/// <param name="encoding">Text encoding</param>

/// <exception cref="System.ObjectDisposedException">Operation is performed on a disposed MSIE

/// JavaScript engine.</exception>

/// <exception cref="System.ArgumentException" />

/// <exception cref="System.IO.FileNotFoundException">Specified JS-file not found.</exception>

/// <exception cref="MsieJavaScriptEngine.JsRuntimeException">JavaScript runtime error.</exception>

public void ExecuteFile(string path, Encoding encoding = null)

{

VerifyNotDisposed();

if (string.IsNullOrWhiteSpace(path))

{

throw new ArgumentException(

string.Format(Strings.Common_ArgumentIsEmpty, "path"), "path");

}

string code = Utils.GetFileTextContent(path, encoding);

Execute(code);

}

/// <summary>

/// Executes a code from embedded JS-resource

/// </summary>

/// <param name="resourceName">JS-resource name</param>

/// <param name="type">Type from assembly that containing an embedded resource</param>

/// <exception cref="System.ObjectDisposedException">Operation is performed on a disposed MSIE

/// JavaScript engine.</exception>

/// <exception cref="System.ArgumentException" />

/// <exception cref="System.ArgumentNullException" />

/// <exception cref="MsieJavaScriptEngine.JsRuntimeException">JavaScript runtime error.</exception>

public void ExecuteResource(string resourceName, Type type)

{

VerifyNotDisposed();

if (string.IsNullOrWhiteSpace(resourceName))

{

throw new ArgumentException(

string.Format(Strings.Common_ArgumentIsEmpty, "resourceName"), "resourceName");

}

if (type == null)

{

throw new ArgumentNullException(

"type", string.Format(Strings.Common_ArgumentIsNull, "type"));

}

string code = Utils.GetResourceAsString(resourceName, type);

Execute(code);

}

/// <summary>

/// Executes a code from embedded JS-resource

/// </summary>

/// <param name="resourceName">JS-resource name</param>

/// <param name="assembly">Assembly that containing an embedded resource</param>

/// <exception cref="System.ObjectDisposedException">Operation is performed on a disposed MSIE

/// JavaScript engine.</exception>

/// <exception cref="System.ArgumentException" />

/// <exception cref="System.ArgumentNullException" />

/// <exception cref="MsieJavaScriptEngine.JsRuntimeException">JavaScript runtime error.</exception>

public void ExecuteResource(string resourceName, Assembly assembly)

{

VerifyNotDisposed();

if (string.IsNullOrWhiteSpace(resourceName))

{

throw new ArgumentException(

string.Format(Strings.Common_ArgumentIsEmpty, "resourceName"), "resourceName");

}

if (assembly == null)

{

throw new ArgumentNullException(

"assembly", string.Format(Strings.Common_ArgumentIsNull, "assembly"));

}

string code = Utils.GetResourceAsString(resourceName, assembly);

Execute(code);

}

/// <summary>

/// Calls a function

/// </summary>

/// <param name="functionName">Function name</param>

/// <param name="args">Function arguments</param>

/// <returns>Result of the function execution</returns>

/// <exception cref="System.ObjectDisposedException">Operation is performed on a disposed MSIE

/// JavaScript engine.</exception>

/// <exception cref="System.ArgumentException" />

/// <exception cref="System.FormatException">The function name has incorrect format.</exception>

/// <exception cref="MsieJavaScriptEngine.NotSupportedTypeException">The type of one function

/// parameter is not supported.</exception>

/// <exception cref="MsieJavaScriptEngine.JsRuntimeException">JavaScript runtime error.</exception>

public object CallFunction(string functionName, params object[] args)

{

VerifyNotDisposed();

if (string.IsNullOrWhiteSpace(functionName))

{

throw new ArgumentException(

string.Format(Strings.Common_ArgumentIsEmpty, "functionName"), "functionName");

}

if (!ValidationHelpers.CheckNameFormat(functionName))

{

throw new FormatException(

string.Format(Strings.Runtime_InvalidFunctionNameFormat, functionName));

}

int argumentCount = args.Length;

if (argumentCount > 0)

{

for (int argumentIndex = 0; argumentIndex < argumentCount; argumentIndex++)

{

object argument = args[argumentIndex];

if (argument != null)

{

Type argType = argument.GetType();

if (!ValidationHelpers.IsSupportedType(argType))

{

throw new NotSupportedTypeException(

string.Format(Strings.Runtime_FunctionParameterTypeNotSupported,

functionName, argType.FullName));

}

}

}

}

object result = _jsEngine.CallFunction(functionName, args);

return result;

}

/// <summary>

/// Calls a function

/// </summary>

/// <typeparam name="T">Type of function result</typeparam>

/// <param name="functionName">Function name</param>

/// <param name="args">Function arguments</param>

/// <returns>Result of the function execution</returns>

/// <exception cref="System.ObjectDisposedException">Operation is performed on a disposed MSIE

/// JavaScript engine.</exception>

/// <exception cref="System.ArgumentException" />

/// <exception cref="System.FormatException">The function name has incorrect format.</exception>

/// <exception cref="MsieJavaScriptEngine.NotSupportedTypeException">The type of return value or

/// one function parameter is not supported.</exception>

/// <exception cref="MsieJavaScriptEngine.JsRuntimeException">JavaScript runtime error.</exception>

public T CallFunction<T>(string functionName, params object[] args)

{

VerifyNotDisposed();

if (string.IsNullOrWhiteSpace(functionName))

{

throw new ArgumentException(

string.Format(Strings.Common_ArgumentIsEmpty, "functionName"), "functionName");

}

Type returnValueType = typeof(T);

if (!ValidationHelpers.IsSupportedType(returnValueType))

{

throw new NotSupportedTypeException(

string.Format(Strings.Runtime_ReturnValueTypeNotSupported, returnValueType.FullName));

}

if (!ValidationHelpers.CheckNameFormat(functionName))

{

throw new FormatException(

string.Format(Strings.Runtime_InvalidFunctionNameFormat, functionName));

}

int argumentCount = args.Length;

if (argumentCount > 0)

{

for (int argumentIndex = 0; argumentIndex < argumentCount; argumentIndex++)

{

object argument = args[argumentIndex];

if (argument != null)

{

Type argType = argument.GetType();

if (!ValidationHelpers.IsSupportedType(argType))

{

throw new NotSupportedTypeException(

string.Format(Strings.Runtime_FunctionParameterTypeNotSupported,

functionName, argType.FullName));

}

}

}

}

object result = _jsEngine.CallFunction(functionName, args);

return TypeConverter.ConvertToType<T>(result);

}

/// <summary>

/// Сhecks for the existence of a variable

/// </summary>

/// <param name="variableName">Name of variable</param>

/// <returns>Result of check (true - exists; false - not exists</returns>

/// <exception cref="System.ObjectDisposedException">Operation is performed on a disposed MSIE

/// JavaScript engine.</exception>

/// <exception cref="System.ArgumentException" />

/// <exception cref="System.FormatException">The variable name has incorrect format.</exception>

/// <exception cref="MsieJavaScriptEngine.JsRuntimeException">JavaScript runtime error.</exception>

public bool HasVariable(string variableName)

{

VerifyNotDisposed();

if (string.IsNullOrWhiteSpace(variableName))

{

throw new ArgumentException(

string.Format(Strings.Common_ArgumentIsEmpty, "variableName"), "variableName");

}

if (!ValidationHelpers.CheckNameFormat(variableName))

{

throw new FormatException(

string.Format(Strings.Runtime_InvalidVariableNameFormat, variableName));

}

return _jsEngine.HasVariable(variableName);

}

/// <summary>

/// Gets a value of variable

/// </summary>

/// <param name="variableName">Name of variable</param>

/// <returns>Value of variable</returns>

/// <exception cref="System.ObjectDisposedException">Operation is performed on a disposed MSIE

/// JavaScript engine.</exception>

/// <exception cref="System.ArgumentException" />

/// <exception cref="System.FormatException">The variable name has incorrect format.</exception>

/// <exception cref="MsieJavaScriptEngine.JsRuntimeException">JavaScript runtime error.</exception>

public object GetVariableValue(string variableName)

{

VerifyNotDisposed();

if (string.IsNullOrWhiteSpace(variableName))

{

throw new ArgumentException(

string.Format(Strings.Common_ArgumentIsEmpty, "variableName"), "variableName");

}

if (!ValidationHelpers.CheckNameFormat(variableName))

{

throw new FormatException(

string.Format(Strings.Runtime_InvalidVariableNameFormat, variableName));

}

return _jsEngine.GetVariableValue(variableName);

}

/// <summary>

/// Gets a value of variable

/// </summary>

/// <typeparam name="T">Type of variable</typeparam>

/// <param name="variableName">Name of variable</param>

/// <returns>Value of variable</returns>

/// <exception cref="System.ObjectDisposedException">Operation is performed on a disposed MSIE

/// JavaScript engine.</exception>

/// <exception cref="System.ArgumentException" />

/// <exception cref="System.FormatException">The variable name has incorrect format.</exception>

/// <exception cref="MsieJavaScriptEngine.NotSupportedTypeException">The type of return value

/// is not supported.</exception>

/// <exception cref="MsieJavaScriptEngine.JsRuntimeException">JavaScript runtime error.</exception>

public T GetVariableValue<T>(string variableName)

{

VerifyNotDisposed();

if (string.IsNullOrWhiteSpace(variableName))

{

throw new ArgumentException(

string.Format(Strings.Common_ArgumentIsEmpty, "variableName"), "variableName");

}

Type returnValueType = typeof(T);

if (!ValidationHelpers.IsSupportedType(returnValueType))

{

throw new NotSupportedTypeException(

string.Format(Strings.Runtime_ReturnValueTypeNotSupported, returnValueType.FullName));

}

if (!ValidationHelpers.CheckNameFormat(variableName))

{

throw new FormatException(

string.Format(Strings.Runtime_InvalidVariableNameFormat, variableName));

}

object result = _jsEngine.GetVariableValue(variableName);

return TypeConverter.ConvertToType<T>(result);

}

/// <summary>

/// Sets a value of variable

/// </summary>

/// <param name="variableName">Name of variable</param>

/// <param name="value">Value of variable</param>

/// <exception cref="System.ObjectDisposedException">Operation is performed on a disposed MSIE

/// JavaScript engine.</exception>

/// <exception cref="System.ArgumentException" />

/// <exception cref="System.FormatException">The variable name has incorrect format.</exception>

/// <exception cref="MsieJavaScriptEngine.NotSupportedTypeException">The type of variable value

/// is not supported.</exception>

/// <exception cref="MsieJavaScriptEngine.JsRuntimeException">JavaScript runtime error.</exception>

public void SetVariableValue(string variableName, object value)

{

VerifyNotDisposed();

if (string.IsNullOrWhiteSpace(variableName))

{

throw new ArgumentException(

string.Format(Strings.Common_ArgumentIsEmpty, "variableName"), "variableName");

}

if (!ValidationHelpers.CheckNameFormat(variableName))

{

throw new FormatException(

string.Format(Strings.Runtime_InvalidVariableNameFormat, variableName));

}

if (value != null)

{

Type variableType = value.GetType();

if (!ValidationHelpers.IsSupportedType(variableType))

{

throw new NotSupportedTypeException(

string.Format(Strings.Runtime_VariableTypeNotSupported,

variableName, variableType.FullName));

}

}

_jsEngine.SetVariableValue(variableName, value);

}

/// <summary>

/// Removes a variable

/// </summary>

/// <param name="variableName">Name of variable</param>

/// <exception cref="System.ObjectDisposedException">Operation is performed on a disposed MSIE

/// JavaScript engine.</exception>

/// <exception cref="System.ArgumentException" />

/// <exception cref="System.FormatException">The variable name has incorrect format.</exception>

/// <exception cref="MsieJavaScriptEngine.JsRuntimeException">JavaScript runtime error.</exception>

public void RemoveVariable(string variableName)

{

VerifyNotDisposed();

if (string.IsNullOrWhiteSpace(variableName))

{

throw new ArgumentException(

string.Format(Strings.Common_ArgumentIsEmpty, "variableName"), "variableName");

}

if (!ValidationHelpers.CheckNameFormat(variableName))

{

throw new FormatException(

string.Format(Strings.Runtime_InvalidVariableNameFormat, variableName));

}

_jsEngine.RemoveVariable(variableName);

}

#region IDisposable implementation

/// <summary>

/// Destroys object

/// </summary>

public void Dispose()

{

if (!_disposed)

{

_disposed = true;

if (_jsEngine != null)

{

_jsEngine.Dispose();

_jsEngine = null;

}

}

}

#endregion

}

}