Script Block

The Script Block enables you to execute JavaScript code within your application, providing a flexible way to implement custom logic.

Using the setVariable Function

To set variable values dynamically within a Script Block, use the setVariable function. This is particularly useful for server-side scripts. For simpler variable assignments, consider using the Set Variable Block instead.

Example of using setVariable:

if ({{MyVariable}} === 'foo') {
  setVariable('MyVariable', 'bar');
} else {
  setVariable('MyVariable', 'other');
}

Note: The setVariable function is only available for scripts executed on the server. It will not work if the "Execute on client?" option is enabled.

Limitations of Server-Side Scripts

Scripts executed on the server run in an isolated, secure environment, which imposes certain restrictions:

• Global Functions: Functions such as console.log, setTimeout, and setInterval are unavailable.

• Fetch API: The fetch function behaves differently from the native JavaScript fetch. You do not need to call await response.text() or await response.json(). The response is always returned as a string.

  // ❌ Incorrect: This will throw an error
  const response = await fetch('https://jsonplaceholder.typicode.com/todos/1');
  const data = await response.text();
   
  // ✅ Correct: Direct response as a string
  const data = await fetch('https://jsonplaceholder.typicode.com/todos/1');

  If the response is a JSON object, parse it using JSON.parse:

  // ❌ Incorrect: This will throw an error
  const response = await fetch('https://jsonplaceholder.typicode.com/todos/1');
  const data = await response.json();
   
  // ✅ Correct: Parse JSON response
  const response = await fetch('https://jsonplaceholder.typicode.com/todos/1');
  const data = JSON.parse(response);

• Module Imports: You cannot use import or require to include external libraries.

• Browser APIs: APIs like window, document, or localStorage are unavailable. To access these, enable the "Execute on client?" option to run the script in the user's browser.

Example Use Cases

Reloading the Page

To refresh the current page:

window.location.reload();

Conditional Redirect Based on Variable Value

To redirect users to a specific URL based on a variable's value:

if ({{Category}} === 'qualified') {
  window.location.href = 'https://my-site.com';
}