runscript.md

runScript

For more information regarding JavaScript, please refer to the Javascript section:

{% content-ref url="../../advanced/javascript/" %} javascript {% endcontent-ref %}

runScript command runs a provided JavaScript file.

appId: com.example
env:
    MY_NAME: John
---
- launchApp
- runScript: myScript.js
- inputText: ${output.myFlow}

A script would typically perform some action and set an output value that could be accessed later. See outputs.md for more information.

var uppercaseName = MY_NAME.toUpperCase()

output.myFlow = uppercaseName   // returns 'JOHN'

{% hint style="info" %} You can directly access env parameters from within JavaScript. See parameters-and-constants.md for more information. {% endhint %}

Passing parameters

runScript accepts env parameters, in the same way as runFlow does (see nested-flows.md).

- runScript:
    file: script.js
    env:
       myParameter: 'Parameter'

Running conditionally

You can use conditionals to run a JavaScript file when some condition is true. For more information, please refer to the conditionals documentation.

Console logging

Console logging is supported from the javascript files provided in runScript command. Logs from javascript are redirected to the console when using Maestro CLI.