JsEngineOptions Class

Gets or sets whether the scripts can compile code given as a string: eval, new Function(...), the constructors of the generator and async functions, and ShadowRealm.prototype.evaluate. When it is false, they throw an EvalError, before JsHost.EnsureCanCompileStrings is called. The default is true.

Gets or sets whether the scripts can block the thread with Atomics.wait (the [[CanBlock]] field of the agent). When false, Atomics.wait throws a TypeError, as on the main thread of a browser; Atomics.waitAsync still works. A blocking wait is bounded by JsEngineOptions.Timeout and JsEngineOptions.CancellationToken either way.

Gets or sets the token that stops the running script when it is canceled.

Gets or sets the debugger that receives the execution events of the scripts (a statement runs, a debugger statement), or null. The code compiled while it is null raises no event and does not pay for it.

Gets or sets the default locale of Intl (ECMA-402 DefaultLocale), a BCP 47 language tag such as "fr-FR". The engine uses its own copy of the CLDR data, so the results do not depend on the operating system; a tag that is not valid or that matches no locale of the data is replaced by "en-US".

Gets or sets whether the realms have the stack trace API of V8 (https://v8.dev/docs/stack-trace-api), used by some npm packages: Error.captureStackTrace(object, constructorOpt) defines the stack property of an object, and Error.stackTraceLimit (10 by default) sets the number of frames of the stack traces. They are not part of ECMAScript, so they are disabled by default. Error.prepareStackTrace is not supported.

Gets or sets the host-defined operations (promise rejection tracking, job callbacks, compilation of strings...), or null for the default ones.

Gets or sets the maximum number of statements of an entry into JavaScript, or null for no limit. The engine counts the iterations of the loops and the calls, which bound the work of a script as the statements do.

Gets or sets the maximum number of bytes allocated by the thread during an entry into JavaScript (a script, a callback...), or null for no limit. The allocations are measured with GC.GetAllocatedBytesForCurrentThread.

Gets or sets the loader of the modules imported by the scripts and the modules, or null when the scripts cannot import modules.

Gets or sets the maximum depth of the calls (JavaScript functions and re-entries from .NET); a deeper call throws a RangeError.

Gets or sets the maximum duration of a regular expression match, or null for no limit (the matches are still bounded by JsEngineOptions.Timeout). A match that exceeds it stops the script (JsTerminationReason.Timeout).

Gets or sets the clock of Date.now(), new Date() and the time zone of the dates.

Gets or sets the identifier of the IANA time zone of the local time of the scripts (e.g. "Europe/Paris"), or null to use the local time zone of JsEngineOptions.TimeProvider (a Windows identifier is mapped to its IANA identifier). The engine uses its own copy of the IANA time zone database, so the local times do not depend on the operating system. A local time zone that is not in the database, such as a zone created by TimeZoneInfo.CreateCustomTimeZone, uses its own rules: a zone without daylight saving time is an offset time zone ("+05:00"), and a zone with daylight saving time keeps its identifier. Set this property to "UTC" to use UTC instead. An identifier that is not a time zone of the database (such as an offset) throws an InvalidOperationException when the scripts first use the local time zone.

Gets or sets the maximum duration of an entry into JavaScript (a script, a callback...), or null for no limit.