Set Variables

In this section, we will learn how to use the Set Variables block.

Use Cases

When you need to perform conditional checks or create some preparing data, you can accomplish this through the Set Variables block. To learn more about the concept of variables, please refer to the Variables section.

set-variables

💡 Note:
Although it is somewhat similar to Set Arguments, they are not the same, so please don't confuse them.

Adding Variables

Adding a variable is straightforward. You need to give the variable a name, such as Hello.

add-variables

💡 Note:
Variable names cannot contain special characters such as spaces, [], {{}}, etc.
Avoid using duplicate variable names unless you intentionally want to update an existing variable.

For details on other options, continue reading below.

Type

The variable type offers 5 options: String, Number, Boolean, Array, and Json. For more information, please see the Data Types section.

Data Source

There are 3 options for the data source of a variable: Element, Dynamic, and Static. Let's delve into the differences between them.

  • Element

    This is a commonly used data source. When selected, you need to specify a Target Element, indicating that the data comes from an element on the page.

    data-source-element

  • Dynamic

    When you choose this option, you can reference other variables using the Template Syntax.

    data-source-dynamic

  • Static

    In this case, the variable acts as a constant, and you need to set a default value.

    data-source-static

Default Value

A default value is an optional fallback value. When a value cannot be obtained from the specified data source, the default value will be assigned to the variable.

Data Transformation

If the extracted data format does not meet your needs, you can perform data transformation here. Refer to the Data Transformation section for more information.

transform-data

Consuming Variables

Before using a variable, it must be defined. Once defined, variables are stored in the @vars scope and can be referenced using the Template Syntax.

Examples

We can input the value of a variable into a webpage's input field through the Input Text block, referencing the variable using {{@vars.Hello}}.

use-variable

Updating Variables

To update a previously defined variable, simply set a variable with the same name.

Examples

First, define a variable called Foo, then update it after a 3-second delay.

update-variable