Add basic support for Jint in preparation for basic Mono support. Jint does not support JSX Transformation.

Author: Daniel15

src/React/Exceptions/JsxUnsupportedEngineException.cs

@@ -0,0 +1,47 @@
+/*
+ *  Copyright (c) 2014, Facebook, Inc.
+ *  All rights reserved.
+ *
+ *  This source code is licensed under the BSD-style license found in the
+ *  LICENSE file in the root directory of this source tree. An additional grant 
+ *  of patent rights can be found in the PATENTS file in the same directory.
+ */
+
+using System;
+using System.Runtime.Serialization;
+using System.Text;
+
+namespace React.Exceptions
+{
+	/// <summary>
+	/// Thrown when the JavaScript engine does not support JSX transformation
+	/// </summary>
+	[Serializable]
+	public class JsxUnsupportedEngineException : ReactException
+	{
+		/// <summary>
+		/// Initializes a new instance of the <see cref="JsxUnsupportedEngineException"/> class.
+		/// </summary>
+		public JsxUnsupportedEngineException() : base(GetMessage()) { }
+
+		/// <summary>
+		/// Used by deserialization
+		/// </summary>
+		protected JsxUnsupportedEngineException(SerializationInfo info, StreamingContext context)
+			: base(info, context) { }
+
+		/// <summary>
+		/// Gets a message that describes the current exception.
+		/// </summary>
+		private static string GetMessage()
+		{
+			return 
+				"The current JavaScript engine does not support compilation of JSX files. If " +
+				"you are on Windows, try upgrading your version of Internet Explorer to 9 or " +
+				"above to use the updated engine. \n\nJSX Transformation is currently " +
+				"unsupported on Mono. If you are using Mono, it is suggested to precompile all " +
+				"JSX files on Windows before deployment. Refer to the ReactJS.NET documentation " +
+				"for more details.";
+		}
+	}
+}

src/React/IReactEnvironment.cs

@@ -15,6 +15,11 @@ namespace React
 	/// </summary>
 	public interface IReactEnvironment
 	{
+		/// <summary>
+		/// Determines if this JavaScript engine supports the JSX transformer.
+		/// </summary>
+		bool EngineSupportsJsxTransformer { get; }
+
 		/// <summary>
 		/// Executes the provided JavaScript code.
 		/// </summary>

src/React/JavaScriptEngineExtensions.cs

@@ -0,0 +1,31 @@
+/*
+ *  Copyright (c) 2014, Facebook, Inc.
+ *  All rights reserved.
+ *
+ *  This source code is licensed under the BSD-style license found in the
+ *  LICENSE file in the root directory of this source tree. An additional grant 
+ *  of patent rights can be found in the PATENTS file in the same directory.
+ */
+
+using JavaScriptEngineSwitcher.Core;
+using JavaScriptEngineSwitcher.Jint;
+
+namespace React
+{
+	/// <summary>
+	/// Extension methods for <see cref="IJsEngine" />.
+	/// </summary>
+	public static class JavaScriptEngineExtensions
+	{
+		/// <summary>
+		/// Determines if this JavaScript engine supports the JSX transformer.
+		/// </summary>
+		/// <param name="jsEngine">JavaScript engine</param>
+		/// <returns><c>true</c> if JSXTransformer is supported</returns>
+		public static bool SupportsJsxTransformer(this IJsEngine jsEngine)
+		{
+			// Jint overflows the stack if you attempt to run the JSX Transformer :(
+			return !(jsEngine is JintJsEngine);
+		}
+	}
+}

src/React/JavaScriptEngineFactory.cs

@@ -4,6 +4,7 @@
 using System.Diagnostics;
 using System.Threading;
 using JavaScriptEngineSwitcher.Core;
+using JavaScriptEngineSwitcher.Jint;
 using JavaScriptEngineSwitcher.Msie;
 using JavaScriptEngineSwitcher.Msie.Configuration;
 using React.Exceptions;
@@ -77,16 +78,16 @@ private static Func<IJsEngine> GetFactory()
 		{
 			var availableEngineFactories = new List<Func<IJsEngine>>
 			{
-				// TODO JS RT
-				() => new MsieJsEngine(new MsieConfiguration { EngineMode = JsEngineMode.ChakraActiveScript })
-				// TODO: Add Jint
-				// TODO: Add V8
+				() => new MsieJsEngine(new MsieConfiguration { EngineMode = JsEngineMode.ChakraActiveScript }),
+				() => new MsieJsEngine(new MsieConfiguration { EngineMode = JsEngineMode.Classic }),
+				() => new JintJsEngine()
 			};
 			foreach (var engineFactory in availableEngineFactories)
 			{
-				var engine = engineFactory();
+				IJsEngine engine = null;
 				try
 				{
+					engine = engineFactory();
 					// Perform a sanity test to ensure this engine is usable
 					if (engine.Evaluate<int>("1 + 1") == 2)
 					{

src/React/JsxTransformer.cs

@@ -86,6 +86,7 @@ public string TransformJsx(string input)
 				return input;
 			}
 
+			EnsureJsxTransformerSupported();
 			try
 			{
 				var encodedInput = JsonConvert.SerializeObject(input);
@@ -100,5 +101,17 @@ public string TransformJsx(string input)
 				throw new JsxException(ex.Message, ex);
 			}
 		}
+
+		/// <summary>
+		/// Ensures that the current JavaScript engine supports JSXTransformer. Throws an exception
+		/// if it doesn't.
+		/// </summary>
+		private void EnsureJsxTransformerSupported()
+		{
+			if (!_environment.EngineSupportsJsxTransformer)
+			{
+				throw new JsxUnsupportedEngineException();
+			}
+		}
 	}
 }

src/React/React.csproj

@@ -50,10 +50,18 @@
       <SpecificVersion>False</SpecificVersion>
       <HintPath>..\packages\JavaScriptEngineSwitcher.Core.1.1.3\lib\net40\JavaScriptEngineSwitcher.Core.dll</HintPath>
     </Reference>
+    <Reference Include="JavaScriptEngineSwitcher.Jint, Version=1.1.5.0, Culture=neutral, PublicKeyToken=c608b2a8cc9e4472, processorArchitecture=MSIL">
+      <SpecificVersion>False</SpecificVersion>
+      <HintPath>..\packages\JavaScriptEngineSwitcher.Jint.1.1.5\lib\net40\JavaScriptEngineSwitcher.Jint.dll</HintPath>
+    </Reference>
     <Reference Include="JavaScriptEngineSwitcher.Msie, Version=1.1.4.0, Culture=neutral, PublicKeyToken=c608b2a8cc9e4472, processorArchitecture=MSIL">
       <SpecificVersion>False</SpecificVersion>
       <HintPath>..\packages\JavaScriptEngineSwitcher.Msie.1.1.4\lib\net40\JavaScriptEngineSwitcher.Msie.dll</HintPath>
     </Reference>
+    <Reference Include="Jint, Version=2.1.0.0, Culture=neutral, PublicKeyToken=2e92ba9c8d81157f, processorArchitecture=MSIL">
+      <SpecificVersion>False</SpecificVersion>
+      <HintPath>..\packages\JavaScriptEngineSwitcher.Jint.1.1.5\lib\net40\Jint.dll</HintPath>
+    </Reference>
     <Reference Include="MsieJavaScriptEngine, Version=1.4.2.0, Culture=neutral, PublicKeyToken=a3a2846a37ac0d3e, processorArchitecture=MSIL">
       <SpecificVersion>False</SpecificVersion>
       <HintPath>..\packages\MsieJavaScriptEngine.1.4.2\lib\net40\MsieJavaScriptEngine.dll</HintPath>
@@ -75,6 +83,7 @@
       <Link>Properties\SharedAssemblyVersionInfo.cs</Link>
     </Compile>
     <Compile Include="AssemblyRegistration.cs" />
+    <Compile Include="Exceptions\JsxUnsupportedEngineException.cs" />
     <Compile Include="Exceptions\ReactConfigurationException.cs" />
     <Compile Include="Exceptions\ReactException.cs" />
     <Compile Include="Exceptions\ReactInvalidComponentException.cs" />
@@ -89,6 +98,7 @@
     <Compile Include="IReactEnvironment.cs" />
     <Compile Include="IReactSiteConfiguration.cs" />
     <Compile Include="Exceptions\JsxException.cs" />
+    <Compile Include="JavaScriptEngineExtensions.cs" />
     <Compile Include="JavaScriptEngineFactory.cs" />
     <Compile Include="JsxTransformer.cs" />
     <Compile Include="NullCache.cs" />

src/React/ReactEnvironment.cs

@@ -108,6 +108,14 @@ public IJsxTransformer JsxTransformer
 			get { return _jsxTransformer.Value; }
 		}
 
+		/// <summary>
+		/// Determines if this JavaScript engine supports the JSX transformer.
+		/// </summary>
+		public bool EngineSupportsJsxTransformer
+		{
+			get { return Engine.SupportsJsxTransformer(); }
+		}
+
 		/// <summary>
 		/// Loads standard React and JSXTransformer scripts into the engine.
 		/// </summary>
@@ -116,8 +124,13 @@ private void InitialiseEngine(IJsEngine engine)
 			var thisAssembly = GetType().Assembly;
 			engine.ExecuteResource("React.Resources.shims.js", thisAssembly);
 			engine.ExecuteResource("React.Resources.react-with-addons.js", thisAssembly);
-			engine.ExecuteResource("React.Resources.JSXTransformer.js", thisAssembly);
 			engine.Execute("var React = global.React");
+
+			// Only load JSX Transformer if engine supports it
+			if (engine.SupportsJsxTransformer())
+			{
+				engine.ExecuteResource("React.Resources.JSXTransformer.js", thisAssembly);
+			}
 		}
 
 		/// <summary>

src/React/packages.config

@@ -1,6 +1,7 @@
 <?xml version="1.0" encoding="utf-8"?>
 <packages>
   <package id="JavaScriptEngineSwitcher.Core" version="1.1.3" targetFramework="net40" />
+  <package id="JavaScriptEngineSwitcher.Jint" version="1.1.5" targetFramework="net40" />
   <package id="JavaScriptEngineSwitcher.Msie" version="1.1.4" targetFramework="net40" />
   <package id="MsieJavaScriptEngine" version="1.4.2" targetFramework="net40" />
   <package id="Newtonsoft.Json" version="5.0.4" targetFramework="net40" />