Skip to main content
Deno 2 is finally here 🎉️
Learn more
Go to Latest
interface default.Runtime.EvaluateRequest
import { type default } from "https://deno.land/x/puppeteer@14.1.1/vendor/puppeteer-core/puppeteer/api-docs-entry.d.ts";
const { EvaluateRequest } = default.Runtime;

Properties

expression: string

Expression to evaluate.

optional
objectGroup: string

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

optional
includeCommandLineAPI: boolean

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

optional
silent: boolean

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

optional
contextId: ExecutionContextId

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.

optional
returnByValue: boolean

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

optional
generatePreview: boolean

Whether preview should be generated for the result.

optional
userGesture: boolean

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

optional
awaitPromise: boolean

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

optional
throwOnSideEffect: boolean

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

optional
timeout: TimeDelta

Terminate execution after timing out (number of milliseconds).

optional
disableBreaks: boolean

Disable breakpoints during execution.

optional
replMode: boolean

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.

optional
allowUnsafeEvalBlockedByCSP: boolean

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.

optional
uniqueContextId: string

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.