Code / Source (legacy)

Node type: code · Version: 1 · Category: Data Author a source block or migrate it to a dedicated Code node. sndbox classifies this node as side-effecting, so tests or automatic runs can require additional confirmation and permission review.

When to use this node

Transform data when built-in mapping and parser nodes are not enough.
Author reusable HTML, JavaScript, or CSS source for Web Builder.

Example: Transform mapped JSON with JavaScript

Run JavaScript locally, reading the mapped value from SNDBOX_INPUT and printing a JSON result.

Example settings

{
  "language": "javascript",
  "sourceCode": "const input = JSON.parse(process.env.SNDBOX_INPUT ?? \"null\");\nconsole.log(JSON.stringify({ count: input.rows.length }));",
  "executionMode": "run",
  "timeoutMs": 30000
}

This shows the important settings, not a complete exported node. Local paths must be selected, mapped from a trusted path, or covered by the runner’s approved boundary.

Map the source value to input.
Run in the full editor and resolve diagnostics.
Inspect result, stdout, and exit behavior before connecting downstream nodes.

Configuration

Field	Type	Default	What it controls
`language`	string	`"javascript"`	Language used for highlighting, diagnostics, AI-assisted authoring, and optional execution. Values: `python`, `html`, `javascript`, `css`.
`sourceCode`	string	`"// Transform data or provide browser-side JavaScript\n"`	Complete source stored in the workflow. Open Edit code for the full editor and live Problems panel.
`executionMode`	string	`"source"`	Return the source unchanged, or execute supported script languages and wait for their result. Values: `source`, `run`.
`itemMode`	string	`"all_items"`	Configuration value for Item Mode.
`runtimeVersion`	string	`">=20"`	Configuration value for Runtime Version.
`helperLanguageVersion`	number	`1`	Configuration value for Helper Language Version.
`dependencies`	array	`[]`	Configuration value for Dependencies.
`timeoutMs`	number	`30000`	Maximum time for this operation in milliseconds.

Edit code opens a dedicated editor for Python, HTML, JavaScript, and CSS with syntax highlighting, live syntax and basic type diagnostics, line and column locations, and AI-assisted code writing.

Source mode returns the complete file through code without executing it. HTML and CSS always use source mode.

Run mode is available for Python and JavaScript, requires command-execution approval, invokes the installed python or node executable, and waits for completion. Mapped input is available as JSON in SNDBOX_INPUT.

Source is limited to 2 MB, timeout is clamped to 100–120000 milliseconds, and captured standard output and error are each limited to 64 KiB.

Workflow JSON

The editor stores this node with the following implemented default configuration:

Default node configuration

{
  "type": "code",
  "version": 1,
  "configuration": {
    "language": "javascript",
    "sourceCode": "// Transform data or provide browser-side JavaScript\n",
    "executionMode": "source",
    "itemMode": "all_items",
    "runtimeVersion": ">=20",
    "helperLanguageVersion": 1,
    "dependencies": [],
    "timeoutMs": 30000
  }
}

Values may be entered literally or mapped from an earlier compatible output when the inspector exposes a mapping control. See Variables and data mapping.

Inputs

Port	Type	Required	Description
`input`	`any`	No	Input

Outputs

Port	Type	Required	Description
`code`	`string`	No	Source code
`result`	`any`	No	Result

Execution behavior

Source mode returns the file without executing it; HTML and CSS always use source mode.
Run mode invokes the installed node or python executable and requires command-execution approval.
The editor catalogue declares code (string), result (any) for mapping. The execution inspector can contain additional evidence fields; inspect a real result before selecting nested paths from object or any outputs.

Common issues

SNDBOX_INPUT is a JSON string, so parse it before treating it as an object.
Keep secrets out of source and stdout because both can appear in workflow or execution records.

Where it can run

Desktop local runner
Paired self-hosted runner
Hosted runner

Test and inspect

Use Test node in the editor to preview this step with the current configuration. A full run records resolved inputs, outputs, logs, duration, and any artifacts in the execution inspector. Side-effecting or destructive nodes can require an additional confirmation or approved workflow permission.

Node reference

Triggers

Logic

Data

Network

Browser

Communication

System

Code / Source (legacy)

When to use this node

Example: Transform mapped JSON with JavaScript

Configuration

Workflow JSON

Inputs

Outputs

Execution behavior

Common issues

Where it can run

Test and inspect

​When to use this node

​Example: Transform mapped JSON with JavaScript

​Configuration

​Workflow JSON

​Inputs

​Outputs

​Execution behavior

​Common issues

​Where it can run

​Test and inspect

​Related guides

When to use this node

Example: Transform mapped JSON with JavaScript

Configuration

Workflow JSON

Inputs

Outputs

Execution behavior

Common issues

Where it can run

Test and inspect

Related guides