UI Bakery Docs
RoadmapRelease notesSign In
  • 👋Welcome to UI Bakery!
  • 🌟Overview
    • 💡Video intro
    • ✨Main features
    • 🔖Glossary
  • 🛠️Getting started
    • Create an application
    • Build UI
      • Data mocking methods
    • Link components
    • Connect a data source
    • Load data
    • Bind data to UI
    • Transform data with JavaScript
      • Data mapping & transforming
    • Change component data
    • Send a form
    • Create a filter
    • Note on debugging
    • Deploy your application & invite users
  • 📌Concepts
    • Components
      • Component basics
      • Component methods
      • Components best practices
        • Input validation
        • Linking a Table to a Form/Detail
        • Using a single Form to add and update data
        • Searching Table based on input value
        • Configuring server-side pagination
        • Managing Date object time zones
        • Role-based Menu component items
        • Field types & types recognition
          • Select/Tag field: Utilizing Tag mapper
        • Expanding component to fit screen/container
        • Controlling component's visibility
    • Custom components
      • Unrestricted custom components
    • Data sources
      • Data source environments
      • Connecting local database via ngrok
      • SSH Tunneling
    • Actions
      • Actions basics
        • Calling actions from code
      • Actions management & shortcuts
      • Actions settings
      • Actions library
      • Server actions
      • Logs and debugging
    • App & page triggers
    • UI Bakery variables
    • State variables
    • Local storage
    • Modules
    • Custom JavaScript
      • JavaScript files
    • Workspace management
      • Account & workspace
      • Seats & Shared permission groups in UI Bakery
      • Roles in UI Bakery
      • Role permissions
      • Explore the interface
      • App environments
        • Release management
      • Audit logs
      • Multi-factor authentication
    • Export & import an app
    • Mobile layout
    • Theme editor
      • Changing theme from the app
    • UI Bakery source control
      • Git controls overview
      • Migrating your app model to the latest version
  • ⚡How-tos
    • File management
      • Working with PDF files
      • CSV import & export
      • Uploading files using methods
      • Displaying files from Google Drive and Dropbox
      • Parsing and sending XML
    • Styling
      • Modifying components with CSS
    • Layout & navigation
      • Adding navigation to application
      • Reading query params from URL
      • Hiding UI Bakery loader in the Embedded mode
    • Data
      • Managing user data with the {{user.email}} variable
      • Using JS libraries
        • Internationalization (i18n) & Localization: Translating UI Bakery Apps
      • Implementing row-level security
      • Copying to clipboard
    • Custom code
      • Communicating with external sites via Iframe
      • Implementing custom app hotkeys
      • Retrying API with HTTP status code 202
  • 🔎Extras
    • UI Bakery Automations
      • Environment and release strategy
      • Git in automations
      • Using external Node libraries
    • UI Bakery Database
      • Database migration
  • 💻On-premise
    • UI Bakery on-premise
    • Install & update
      • Installing on-premise
        • Azure virtual machine
        • Azure container instance
        • AWS EC2 instance
        • Google Cloud Compute Engine VM instance
        • DigitalOcean 1-click droplet
        • Manual w/ docker compose
        • Manual w/ docker run
        • Windows installation
        • Kubernetes
          • AWS EKS with Fargate
          • Scaling and resource optimization
      • Troubleshooting installation errors
      • Updating on-premise
      • Updating license key
      • Updating environment variables
      • Recommendations
        • Architecture overview
        • UI Bakery in production
        • Resource optimization
        • Running a standalone database instance
        • Generating custom secrets
    • On-premise features
      • External analytics
      • Branding
      • Embedding
      • SCIM 2.0
      • Instance API
      • Activating features under a feature flag
    • Additional configurations
      • Health check API
      • Email configuration
      • Google Sheets connection setup
      • Salesforce connection setup
      • Azure blob storage configuration
      • Adding python backend code to existing installation
      • UI Bakery Postgres
    • Networking & security
      • Setting up a domain name
      • Configuring custom certificate authority
      • Custom base URL
      • Getting requests to the local network
      • Setting up SSL on Ubuntu
    • SSO
      • OpenID
        • Google OAuth2
        • Okta ODIC
        • Azure AD OAuth2
        • Token refresh
      • SAML
        • Okta SAML
        • Azure AD SAML
      • Role synchronization
      • Multiple SSO
      • Logout redirect
      • Troubleshooting
    • Git source control
      • Manage multi-instance deployment
      • Custom PR URL
      • Automate GitHub releases
      • Automate GitLab releases
      • Automate Bitbucket releases
    • Environment variables
  • 📚Reference
    • Data security measures
    • Improving app security
    • ✨AI Assistant
    • List of Components
      • Azure Blob Storage file uploader
      • Accordion
      • Alert
      • Avatar
      • Boolean
      • Breadcrumbs
      • Bubble map
      • Button
      • Card
      • Chart
      • Chat
      • Checkbox
      • Collapsible card
      • Color picker
      • Composite form
      • Container
      • Context menu button
      • Currency
      • Currency input
      • Date picker
      • Date & time
      • Date & time picker
      • Detail
      • Divider
      • Email input
      • Embedded App
      • File
      • File dropzone
      • File picker
      • Flex container
      • Form
      • Frame drawer
      • Grid view
      • Heading
      • Horizontal menu
      • Icon
      • iFrame
      • Image
      • Image picker
      • JSON editor
      • JSON viewer
      • Link
      • List view
      • Map
      • Menu
      • Metric
      • Modal
      • Multi-select
      • Number
      • Number input
      • Password input
      • PDF viewer
      • Percent
      • Pop-up form
      • Progress bar
      • QR code
      • Radio
      • Range slider
      • Rating
      • Reusable header
      • Reusable sidebar
      • Select
      • Signature
      • Slider
      • Steps
      • Stepper
      • S3 file uploader
      • Table
        • Conditional formatting based on cell value
        • Display name instead of ID for relation
        • Row context referencing
        • Select multiple table rows
        • How to Highlight Text in a Table Using mark.js
      • Tabs
      • Tabset
      • Tags
      • Text
      • Text annotate
      • Text input
      • Time picker
      • Toggle
      • Tree component
      • Video
      • Dynamic structure properties
      • Card (deprecated)
      • Input (deprecated)
    • Upgrading components
    • List of Data sources
      • Airtable
      • AWS API
      • AWS Athena
      • AWS DynamoDB
      • AWS Lambda
      • AWS Redshift
      • AWS S3
        • S3 compatible endpoints (DigitalOcean spaces)
      • Azure Blob Storage
      • Big Query
      • Databricks
      • Exasol
      • Firestore, Firebase Auth & Realtime DB
        • Firebase authentication
        • Managing database data
        • Firebase client-side SDK
        • Firebase libraries
      • GitHub
      • Google Sheets
      • GraphQL
      • HTTP API
        • API Authentication
      • HubSpot
      • JDBC
      • MariaDB
      • MongoDB
      • MySQL
      • OpenAI
      • OpenAPI
      • Oracle
      • PostgreSQL
      • Presto
      • Redis
      • Salesforce
      • SAP Hana
      • SendGrid
      • Slack
      • SMTP
      • Snowflake
      • Spanner
      • SSH
      • Stripe
      • SQL Server
      • Supabase
      • Twilio
      • UI Bakery AI
    • List of Action steps
      • AI Action
      • Azure Blob Storage Query
      • Bulk Create Rows
      • Bulk Delete Rows
      • Condition
      • Create Row
      • Delete Row
      • DynamoDB Request
      • Execute Action
      • Firebase Query
      • Generate File
      • GraphQL Query
      • HTTP Request
      • Interval
      • JavaScript Code
      • Load Table
      • Load Row
      • Loop Action
      • MongoDB Command
      • Navigate
      • Open API Request
      • Python Backend Code
      • Redis Command
      • Save to Local Storage
      • Save to State
      • Show Notification
      • Slack Message
      • SMTP Request
      • SSH Command
      • SQL Query
      • S3 Query
      • Update Row
    • Troubleshooting techniques
    • Performance optimization
Powered by GitBook

© 2025 UI Bakery

On this page
  • Variables
  • Built-in variables
  • Using variables
  • Data transformation
  • Component values & methods
  • Merging data
  • Merging results of multiple steps
  • Calling and merging data from other actions
  • Custom validation
  • Debugging errors
  • Useful examples
  • Map data for the select component
  • Add a "Not Selected" option at the beginning of the array
  • Add color to the Select dropdown items
  • Refresh action data at a certain interval
  • Safely parse JSON result into a variable

Was this helpful?

Export as PDF
  1. Reference
  2. List of Action steps

JavaScript Code

PreviousIntervalNextLoad Table

Last updated 1 month ago

Was this helpful?

The JavaScript Code step allows you to write JavaScript code that will run when the step is executed with the Async/Await syntax support. Among the most common use cases for this action step are data mapping and transforming, validation, and preparing data before sending it to a database/API.

You can use the UI Bakery {{data}} variable to access the result of the previous step or {{ui.input.value}} to access the value of a specific UI component.

Additionally, you can also use the JS libraries included in UI Bakery as well as connect custom ones to utilize their functionality within your code. Learn more about them

Variables

Built-in variables

// result of the previous step
return {{data}};

// error response of the previous step
return {{error}};

// incoming action params, passed in by components,
// the Execution/Loop action steps or when calling the action from the code
return {{params}};

// the response of the request, if the Code step follows an HTTP API step
return {{res}};

While {{data}} and {{error}} are specific to a particular step, {{params}} is available in all steps.

Using variables

// use `{{data.<key>}}` to access a specific key
return {{data.name}};

// to access the first element of the array
return {{data[0]}};

// to access the `name` key of the first element
return {{data[0].name}};

Optional chaining and default values

If at some point a variable's value is null or undefined, an optional chaining operator ?. can be used to access a specific key, for example:

// if `data` is `null` or `undefined`, `name` will not produce an error
return {{data?.name}};
// if `data` is `null` or `undefined`, `name` will not produce an error
return {{data?.[0]?.name}};

If a variable is null or undefined, a default value can be provided using the nullish coalescing operator ??:

// the default value will be returned
return {{data?.name ?? 'default'}};

It can also be used in combination with the if statement:

const userRole = {{data?.role ?? 'user'}};
if (userRole === 'admin') {
  // do something
}

Using variables inside strings

If you need to add a variable inside a string, you can do it by placing it in the ${ } expression, for example:

const name = `Hello ${ {{user.name}} }`;

Data transformation

If the API returns its data in a different format than expected for the components, you can use the JavaScript Code step to transform it. For example, a Table component expects an array of objects but the API returns an object with the items key that contains the array. In this case, you can use the following code to transform it into the desired format:

return {{data.items}};

In some cases, the API may return an object with the data key inside:

return {{data.data}};
  • Access an inner array object and map it to a new array:

return {{data}}.map(item => {
  return {
    id: item.id,
    name: item.name.toUpperCase(),
  };
});
  • Add a new key to the array of objects:

return {{data}}.map(item => {
  return {
    ...item, // put all the keys from the original object
    created_at: new Date(), // add a new property
  };
});
  • Filter an array of objects (short version):

return {{data}}.filter(item => item.id > 10);

Multiline version:

return {{data}}.filter((item) => {
  return item.id > 10;
});

Component values & methods

In the JavaScript Code step, you can access the values of UI components and call their methods. For example, if you have a Form component, you can access its value using the {{ui.form.value}} variable.

const formValue = {{ui.form.value}};
delete formValue.password;

return formValue;

You can also call component methods, for example, {{ui.form.submit()}} will submit the form.

// ui.form.submit() can also be used without the parentheses
{{ui.form.submit()}}

Another example is hiding the modal - you can use the {{ui.modal.close()}} method:

// ui.modal.close() can also be used without the parentheses
{{ui.modal.close()}}

Merging data

Merging results of multiple steps

In some cases, you may need to merge the results of multiple steps into a single object. Here, you can use {{steps.<step_name>.data}} to access the output of any previous step:

const users = {{steps.loadUsers.data}};
const orders = {{steps.loadOrders.data}};

return users.map(user => {
  const userOrders = orders
    .filter(order => order.userId === user.id);

  return {
    ...user,
    userOrders,
  };
});

Some steps, such as Save to State or Show Notification, do not have a variable as they do not produce any output.

Action step must have a name to be accessible as a variable.

Calling and merging data from other actions

Sometimes, you may need to call another action to get some data and then merge it with your current data. For example, you have a list of users, and you want to get a list of their orders. You can use the following code to call another action and merge its result with your current data:

const orders = await {{actions.loadOrders.trigger()}};
// Note that the `async` keyword is required
return {{data}}.map(async (item) => {
  return {
    ...item,
    // user id will be passed as a {{params}} to the action
    orders: await {{actions.loadOrders.trigger(item.id)}},
};
});

Another example is loading two different lists of data and merge them into one array:

const users = await {{actions.loadUsers.trigger()}};
const orders = await {{actions.loadOrders.trigger()}};

return {{users}}.map(item => {
  return {
    ...item,
    orders: orders.filter(order => order.user_id === item.id),
  };
});

Custom validation

If you need to validate the data before submitting it to a database or an API, you can simply throw an error with a custom message:

if (!{{data.name}}) {
  throw new Error('User name is a required field');
}

This will prevent the action from executing the next steps.

Alternatively, you can also select the Allow next step execution when this step has failed checkbox in the action's settings and use the message in the Show Notification step as the {{error.message}}.

Debugging errors

If the code fails or produces unexpected results you can try doing the following:

// commented to test
// if ({{data}}.length > 10) {
//   return {{data}};
// }

console.log({{data}});

Useful examples

Map data for the select component

return {{data}}.map(item => {
  return {
    label: item.name,
    value: item.id,
  };
});

Add a "Not Selected" option at the beginning of the array

const items = {{data}}.map(item => {
  return {
    label: item.name,
    value: item.id,
  };
});

items.unshift({ value: null, label: 'Not Selected' });

return items;

Add color to the Select dropdown items

const colors = ['success', 'warning', 'danger', 'info', 'basic', 'control', 'primary'];
const items = {{data}}.map((item, index) => {
  const color = colors[index] ? colors[index] : 0;
  return { value: item.productLine, label: item.productLine, color };
});

items.unshift({ value: null, label: 'Not Selected' });
return items;

Refresh action data at a certain interval

Create an action, select the JavaScript Code action step and add the following code:

const { interval } = await requireAsync('rxjs');
// internal is specified in miliseconds
return interval(5000);

For the second step in this action, add the Load Table action or any other load data step.

Safely parse JSON result into a variable

const items = {};
try {
  items = JSON.parse(data['items']);
} catch (e) {}

return items;
📚
👇
Using JS libraries