moz.build |
|
348 |
script-command.js |
Execute a JavaScript expression.
@param {String} expression: The code you want to evaluate.
@param {Object} options: Options for evaluation:
@param {Object} options.frameActor: a FrameActor ID. The actor holds a reference to
a Debugger.Frame. This option allows you to evaluate the string in the frame
of the given FrameActor.
@param {String} options.url: the url to evaluate the script as. Defaults to "debugger eval code".
@param {TargetFront} options.selectedTargetFront: When passed, the expression will be
evaluated in the context of the target (as opposed to the default, top-level one).
@param {String} options.selectedNodeActor: A NodeActor ID that may be used by helper
functions that can reference the currently selected node in the Inspector, like $0.
@param {String} options.selectedObjectActor: the actorID of a given objectActor.
This is used by context menu entries to get a reference to an object, in order
to perform some operation on it (copy it, store it as a global variable, …).
@param {Number} options.innerWindowID: An optional window id to be used for the evaluation,
instead of the regular webConsoleActor.evalWindow.
This is used by functions that may want to evaluate in a different window (for
example a non-remote iframe), like getting the elements of a given document.
@param {object} options.mapped: An optional object indicating if the original expression
entered by the users have been modified
@param {boolean} options.mapped.await: true if the expression was a top-level await
expression that was wrapped in an async-iife
@param {boolean} options.disableBreaks: Set to true to avoid triggering any
type of breakpoint when evaluating the source. Also, the evaluated source won't be
visible in the debugger UI.
@param {boolean} options.preferConsoleCommandsOverLocalSymbols: Set to true to force
overriding local symbols defined by the page with same-name console commands.
@param {boolean} options.evalInTracer: Set to true to store the evaluation result object
actors within the Tracer Object Actor Pool.
So that if the evaluation result object has already been processed by the JS Tracer,
we will receive the same Object Actor.
This helps later match the object when doing a search per value.
@return {Promise}: A promise that resolves with the response.
|
6617 |
tests |
|
|