There are no tracking or monitoring cookies on this site. There are only cookies used for documentation examples related to cookies.Close
Processing...
This may take a few seconds.

run

Syntax

run: {= (javascript) =} [every (time)] [after (time)][, (javascript)...];

A safer alternative to eval.

Example:

body:init {
    run: {=
        alert('Hi! I'm a popup!');
=};
}

Under the hood it does something like this:

Function(..., '"use strict"; ...' + yourFunction)(...);

Use this instead of eval.

This works with the "vars" syntax, so if you declare your Active CSS variables with "vars" in your JavaScript, then you can get access to the variables that are applicable to the scope the run command is running in.

runButton:click {
var: myVariable "awesome";
    run: {=
/* This is just regular JavaScript with the addition of the Active CSS special "vars" command. */
vars myVariable;
alert('myVariable is: ' + myVariable);
=}
}

References:

https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function

https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/eval

Don't forget to put the semi-colon at the end of your command after the final "=}" or it won't run.

Alternatives

These other alternatives are safer than using eval:

@command or create-command - creates your own Active CSS action command, like all the other Active CSS commands, which is scoped to the "ActiveCSS" global variable and not the window scope.

func - calls an external function that you have already pre-written in a JavaScript file.

Note: The run command isn't allowed in browser extension JavaScript files due to browser security policies, but it works fine on websites.

 

Here is an example of run in action:

run