Module inject

You can use injectCode to simply run code in the page's context and evaluateCode if you need to pass a value back.

Using real functions in your code

The code needs to be written in Javascript that can be executed by the browser. It isn't processed in any way. If possible, write an actual function which you then convert to a string to leverage the power of TypeScript.

example

// write the function like you would for any other function, this way it'll
// be compiled to the targeted javascript version
function test(value: any): string {
    return value.toString();
}

const code = `
     // test now holds the compiled test function code
     const test = ${test.toString()};
     return test(5);
`;

// returns "5"
await evaluateCode(code);

Getting something from the page

Let's say you want to access the variable USER_NAME which the page conveniently exposes to the global scope, you can simply grab it using evaluateCode.

example

const username = await evaluateCode(`USER_NAME`);

Running code

If you have to call a function in the page to perform some action, say, changing the colour of the background (called "changeBackgroundColour"), you can use injectCode to simply run it.

example

injectCode(`changeBackgroundColour("green");`);