evaluate

suspend fun evaluate(args: Runtime.EvaluateParameter, mode: CommandMode = CommandMode.DEFAULT): Runtime.EvaluateReturn

Evaluates expression on global object.


suspend fun evaluate(expression: String, objectGroup: String? = null, includeCommandLineAPI: Boolean? = null, silent: Boolean? = null, contextId: Int? = null, returnByValue: Boolean? = null, generatePreview: Boolean? = null, userGesture: Boolean? = null, awaitPromise: Boolean? = null, throwOnSideEffect: Boolean? = null, timeout: Double? = null, disableBreaks: Boolean? = null, replMode: Boolean? = null, allowUnsafeEvalBlockedByCSP: Boolean? = null, uniqueContextId: String? = null, serializationOptions: Runtime.SerializationOptions? = null): Runtime.EvaluateReturn

Evaluates expression on global object.

Parameters

expression

Expression to evaluate.

objectGroup

Symbolic group name that can be used to release multiple objects.

includeCommandLineAPI

Determines whether Command Line API should be available during the evaluation.

silent

In silent mode exceptions thrown during evaluation are not reported and do not pause execution. Overrides setPauseOnException state.

contextId

Specifies in which execution context to perform evaluation. If the parameter is omitted the evaluation will be performed in the context of the inspected page. This is mutually exclusive with uniqueContextId, which offers an alternative way to identify the execution context that is more reliable in a multi-process environment.

returnByValue

Whether the result is expected to be a JSON object that should be sent by value.

generatePreview

Whether preview should be generated for the result.

userGesture

Whether execution should be treated as initiated by user in the UI.

awaitPromise

Whether execution should await for resulting value and return once awaited promise is resolved.

throwOnSideEffect

Whether to throw an exception if side effect cannot be ruled out during evaluation. This implies disableBreaks below.

timeout

Terminate execution after timing out (number of milliseconds).

disableBreaks

Disable breakpoints during execution.

replMode

Setting this flag to true enables let re-declaration and top-level await. Note that let variables can only be re-declared if they originate from replMode themselves.

allowUnsafeEvalBlockedByCSP

The Content Security Policy (CSP) for the target might block 'unsafe-eval' which includes eval(), Function(), setTimeout() and setInterval() when called with non-callable arguments. This flag bypasses CSP for this evaluation and allows unsafe-eval. Defaults to true.

uniqueContextId

An alternative way to specify the execution context to evaluate in. Compared to contextId that may be reused across processes, this is guaranteed to be system-unique, so it can be used to prevent accidental evaluation of the expression in context different than intended (e.g. as a result of navigation across process boundaries). This is mutually exclusive with contextId.

serializationOptions

Specifies the result serialization. If provided, overrides generatePreview and returnByValue.