JavaScript task

The JavaScript task lets you write custom JavaScript code snippets for your integration.

Using theJavaScript Editor, you can code complex data mapping logic for your integration, perform variable assignments, and add or modify integration variables.

TheJavaScript Editor supports the following features:

• A minimap that displays a high-level overview of the script code and helps with quick navigation.
• Syntax/code highlighting, indentation, and line numbering for easier code readability and structure recognition.
• Error highlighting to find and track errors in code.
• Folding to expand and collapse regions of the script code.
• Click-to-copy option to copy the script code to the clipboard.

Configure the JavaScript task

To add a JavaScript task to your integration, perform the following steps:

1. In the Google Cloud console, go to theApplication Integration page.

   Go to Application Integration

2. In the navigation menu, clickIntegrations.

   TheIntegrations page appears listing all the integrations available in the Google Cloud project.

3. Select an existing integration or clickCreate integration to create a new one.

   If you are creating a new integration:

   1. Enter a name and description in theCreate Integration pane.
   2. Select a region for the integration.Note: TheRegions dropdown only lists the regions provisioned in your Google Cloud project. To provision a new region, clickEnable Region. SeeEnable new region for more information.
   3. Select a service account for the integration. You can change or update the service account details of an integration any time from theinfoIntegration summary pane in the integration toolbar.Note: The option to select a service account is displayed only if you have enabled integration governance for the selected region.
   4. ClickCreate. The newly created integration opens in theintegration editor.

4. In theintegration editor navigation bar, clickTasks to view the list of available tasks and connectors.
5. Click and place theJavaScript element in the integration editor.
6. Click theJavaScript element on the designer to view theJavaScript task configuration pane.
7. ClickOpen script editor to view and edit theJavaScript Editor. You can also use Gemini to generate JavaScript code by clickScript with Gemini. For information about using Gemini to generate JavaScript code, seeConfigureJavaScript tasks with Gemini assistance.
8. Write your JavaScript code inside theexecutesScript(event) function that is automatically created in theJavaScript Editor. Close the editor once complete, any changes will be autosaved.Warning: Don't delete theexecutesScript(event) function. This function is called when theJavaScript task executes.

   For information about accessing integration variables and the supported functions, see Using the JavaScript Editor.

   For information about viewing the generated execution logs, seeExecution logs.

The following image shows a sample layout of theJavaScript Editor:

Use the JavaScript Editor

To view and edit theJavaScript Editor, go to theJavaScript task configuration pane and clickOpen script editor. TheJavaScript Editor by default contains a function namedexecutesScript(event), where:

• executesScript(): the function that is called when Application Integration executes theJavaScript task during an integration's run.
• event: thein-memory object of Application Integration.

  For information about the supported methods of theevent object, see Access integration variables.

Application Integration previously supported Rhino as the JavaScript execution engine for runningJavaScript tasks. To leverage the performance and security benefits of Google's open-source high-performance JavaScript engine, Rhino will be deprecated and all JavaScript executions will now utilize V8, Google's open-source high-performance JavaScript engine.

Benefits of V8

The V8 JavaScript engine offers the following benefits:

• Performance: V8 is significantly faster than Rhino, leading to improved execution speeds for yourJavaScript tasks. Scripts with large sized variables and complex computations can be executed faster.
• Standards Compliance: V8 supports ECMAScript 2024, ensuring better compatibility and maintainability.
• Security: V8 benefits from ongoing security updates and improvements, providing a more secure environment for your integrations.
• Modern Features: V8 supports the latest JavaScript features, allowing you to leverage modern language constructs and libraries.

Migrate existing JavaScript tasks to V8

To migrate your existingJavaScript tasks running on Rhino to V8, do the following:

1. Identify the published integrations that containJavaScript tasks and unpublish them.
2. For eachJavaScript, clickOpen script editor from the task configuration pane.

   Application Integration automatically updates the existing script to use V8.

3. Review and test the JavaScript code.
4. Publish the integrations.

Access integration variables

Variables defined in your integration can be accessed from theJavaScript Editor using the Application Integration in-memoryevent object.

The following methods are supported to access integration variables from yourJavaScript Editor:

functionexecuteScript(event){event.getEventExecutionInfoId();}

functionexecuteScript(event){event.getGcpProjectId();}

functionexecuteScript(event){event.getIntegrationName();}

functionexecuteScript(event){event.getParameter("var1");}

functionexecuteScript(event){event.getRegion();}

functionexecuteScript(event){event.log(event.getParameter("var1"));}

functionexecuteScript(event){event.log("Lorem ipsum");}

functionexecuteScript(event){event.setParameter("`responseBody`","NewStringValue");}

Set task parameters

If your integration has multiple large sized parameters that are not used by the JavaScript task, you can set theTaskParameter field for the JavaScript task to improve performance.

To set theTaskParameter field for the JavaScript task, select one of the following options:

Error handling strategy

An error handling strategy for a task specifies the action to take if the task fails due to atemporary error. For information about how to use an error handling strategy, and to know about the different types of error handling strategies, seeError handling strategies.

Quotas and limits

For information about quotas and limits, seeQuotas and limits.

What's next

• Learn about the following:
  • Configuring JavaScript tasks with Gemini assistance
  All tasks and triggers
  • Testing and publishing integrations
  • Error handling
  • Integration execution logs