In JavaScriptEngineSwitcher.V8 in configuration settings of the V8 JS engine was added 3 new properties: HeapSizeSampleInterval (default TimeSpan.Zero), MaxHeapSize (default UIntPtr.Zero) and MaxStackUsage (default UIntPtr.Zero)

Author: Taritsyn

NuGet/JavaScriptEngineSwitcher.V8/JavaScriptEngineSwitcher.V8.nuspec

@@ -17,7 +17,9 @@ This package does not contain the native ClearScript and V8 assemblies. Therefor
  * JavaScriptEngineSwitcher.V8.Native.win-x86
  * JavaScriptEngineSwitcher.V8.Native.win-x64</description>
 		<summary>JavaScriptEngineSwitcher.V8 contains adapter `V8JsEngine` (wrapper for the Microsoft ClearScript.V8 version of May 13, 2017).</summary>
-		<releaseNotes>Improved implementation of the `CallFunction` method.</releaseNotes>
+		<releaseNotes>1. Improved implementation of the `CallFunction` method;
+2. Removed unnecessary locks from the `V8JsEngine` class;
+3. In configuration settings of the V8 JS engine was added 3 new properties: `HeapSizeSampleInterval` (default `TimeSpan.Zero`), `MaxHeapSize` (default `UIntPtr.Zero`) and `MaxStackUsage` (default `UIntPtr.Zero`).</releaseNotes>
 		<copyright>Copyright (c) 2013-2018 Andrey Taritsyn - http://www.taritsyn.ru</copyright>
 		<language>en-US</language>
 		<tags>JavaScriptEngineSwitcher JavaScript ECMAScript V8 ClearScript</tags>

NuGet/JavaScriptEngineSwitcher.V8/readme.txt

@@ -25,7 +25,11 @@
    =============
    RELEASE NOTES
    =============
-   Improved implementation of the `CallFunction` method.
+   1. Improved implementation of the `CallFunction` method;
+   2. Removed unnecessary locks from the `V8JsEngine` class;
+   3. In configuration settings of the V8 JS engine was added 3 new properties:
+      `HeapSizeSampleInterval` (default `TimeSpan.Zero`), `MaxHeapSize` (default
+      `UIntPtr.Zero`) and `MaxStackUsage` (default `UIntPtr.Zero`).
 
    =============
    DOCUMENTATION

src/JavaScriptEngineSwitcher.V8/V8JsEngine.cs

@@ -117,6 +117,9 @@ public V8JsEngine(V8Settings settings)
 			try
 			{
 				_jsEngine = new V8ScriptEngine(constraints, flags, debugPort);
+				_jsEngine.MaxRuntimeHeapSize = v8Settings.MaxHeapSize;
+				_jsEngine.RuntimeHeapSizeSampleInterval = v8Settings.HeapSizeSampleInterval;
+				_jsEngine.MaxRuntimeStackUsage = v8Settings.MaxStackUsage;
 			}
 			catch (Exception e)
 			{

src/JavaScriptEngineSwitcher.V8/V8Settings.cs

@@ -1,4 +1,6 @@
-namespace JavaScriptEngineSwitcher.V8
+using System;
+
+namespace JavaScriptEngineSwitcher.V8
 {
 	/// <summary>
 	/// Settings of the V8 JS engine
@@ -33,6 +35,57 @@ public bool DisableGlobalMembers
 			set;
 		}
 
+		/// <summary>
+		/// Gets or sets a minimum time interval between consecutive heap size samples
+		/// </summary>
+		/// <remarks>
+		/// <para>
+		/// This property is effective only when heap size monitoring is enabled (see
+		/// <see cref="MaxHeapSize"/> property)
+		/// </para>
+		/// </remarks>
+		public TimeSpan HeapSizeSampleInterval
+		{
+			get;
+			set;
+		}
+
+		/// <summary>
+		/// Gets or sets a maximum size of the executable code heap in mebibytes
+		/// </summary>
+		public int MaxExecutableSize
+		{
+			get;
+			set;
+		}
+
+		/// <summary>
+		/// Gets or sets a soft limit for the size of the V8 runtime's heap in bytes
+		/// </summary>
+		/// <remarks>
+		/// <para>
+		/// When it is set to the default value, heap size monitoring is disabled, and
+		/// scripts with memory leaks or excessive memory usage can cause unrecoverable
+		/// errors and process termination.
+		/// </para>
+		/// <para>
+		/// A V8 runtime unconditionally terminates the process when it exceeds its resource
+		/// constraints. This property enables external heap size monitoring that can prevent
+		/// termination in some scenarios. To be effective, it should be set to a value that
+		/// is significantly lower than <see cref="MaxOldSpaceSize"/> property. Note that
+		/// enabling heap size monitoring results in slower script execution.
+		/// </para>
+		/// <para>
+		/// Exceeding this limit causes the V8 runtime to interrupt script execution and throw
+		/// an exception.
+		/// </para>
+		/// </remarks>
+		public UIntPtr MaxHeapSize
+		{
+			get;
+			set;
+		}
+
 		/// <summary>
 		/// Gets or sets a maximum size of the new object heap in mebibytes
 		/// </summary>
@@ -52,9 +105,21 @@ public int MaxOldSpaceSize
 		}
 
 		/// <summary>
-		/// Gets or sets a maximum size of the executable code heap in mebibytes
+		/// Gets or sets a maximum amount by which the V8 runtime is permitted to grow
+		/// the stack during script execution in bytes
 		/// </summary>
-		public int MaxExecutableSize
+		/// <remarks>
+		/// <para>
+		/// When it is set to the default value, no stack usage limit is enforced, and
+		/// scripts with unchecked recursion or other excessive stack usage can cause
+		/// unrecoverable errors and process termination.
+		/// </para>
+		/// <para>
+		/// Note that the V8 runtime does not monitor stack usage while a host call is in progress.
+		/// Monitoring is resumed when control returns to the runtime.
+		/// </para>
+		/// </remarks>
+		public UIntPtr MaxStackUsage
 		{
 			get;
 			set;
@@ -69,9 +134,12 @@ public V8Settings()
 			EnableDebugging = false;
 			DebugPort = 9222;
 			DisableGlobalMembers = false;
+			HeapSizeSampleInterval = TimeSpan.Zero;
+			MaxExecutableSize = 0;
+			MaxHeapSize = UIntPtr.Zero;
 			MaxNewSpaceSize = 0;
 			MaxOldSpaceSize = 0;
-			MaxExecutableSize = 0;
+			MaxStackUsage = UIntPtr.Zero;
 		}
 	}
 }