CodeExecute NodeTypeCode: code-execute

When to Use

• Complex business logic that can't be expressed in UI nodes: A customer tier calculation depends on spend, recency, and product category in a multi-step if/else tree. DataMapping and CollectionOperation can't express this — CodeExecute can.
• String manipulation and parsing: Extract an order number from a free-text email subject using a regular expression. Parse a custom pipe-delimited data format. Build a formatted reference string combining multiple fields with business-specific padding rules.
• Date arithmetic: Calculate the number of business days between two dates. Determine whether a given date falls in Q1 or Q2. Add 30 calendar days to a start date and return the result as ISO format.
• Custom validation algorithm: Validate a complex password policy, an ISBN-13 checksum, or a LUHN credit card number — all require programmatic logic that is impossible to express declaratively in UI nodes.
• Data transformation combining multiple fields: Construct a composite index key by hashing multiple fields. Build a slug from a product title. Normalize an irregular address format by combining and reformatting multiple address fields into a single canonical string.

Configuration

JavaScript Runtime

Output Ports

Output Fields

Sample Script — Order Filtering and ID Extraction

// Workflow variable 'orders' is an array of order objects
// Select orders over $100 and return their IDs
var allOrders = orders;  // injected from VariableAssignment
result = allOrders
  .filter(function(o) { return o.total > 100; })
  .map(function(o) { return o.id; });

Sample Script — Business Day Calculation

// Calculate business days between startDate and endDate
// Both injected as ISO date strings from workflow variables
function isWeekend(d) {
  var day = d.getDay();
  return day === 0 || day === 6;
}
var start = new Date(startDate);
var end   = new Date(endDate);
var count = 0;
var current = new Date(start);
while (current <= end) {
  if (!isWeekend(current)) { count++; }
  current.setDate(current.getDate() + 1);
}
result = { businessDays: count, startDate: startDate, endDate: endDate };

Sample Script — Custom Tier Calculation

// customerAnnualSpend and customerRecencyDays injected from workflow variables
var spend = customerAnnualSpend;
var recency = customerRecencyDays;
var tier = "bronze";
if (spend > 50000 && recency < 30) {
  tier = "platinum";
} else if (spend > 20000 && recency < 60) {
  tier = "gold";
} else if (spend > 5000 && recency < 90) {
  tier = "silver";
}
result = { tier: tier, annualSpend: spend, recencyDays: recency };

Sample Configuration

{
  "language": "javascript",
  "code": "const items = $input.all();\nconst total = items.reduce((sum, item) => sum + item.json.amount, 0);\nreturn [{ json: { total, count: items.length, average: total / items.length } }];",
  "timeout": 30000
}

Sample Output

Success Port

{
  "total": 15750.00,
  "count": 12,
  "average": 1312.50,
  "_executionTime": 42,
  "_language": "javascript"
}

Expression Reference

Node Policies & GuardRails

Pattern Examples

Pattern 1 — Regex Extraction from Free-Text

Extract an order number from an email subject line using a regular expression.

// emailSubject injected from workflow variable
var subject = emailSubject;
var match = subject.match(/ORD-\d{4,10}/);
if (match) {
  result = { found: true, orderId: match[0] };
} else {
  result = { found: false, orderId: null };
}

Pattern 2 — LUHN Checksum Validation

// cardNumber injected from workflow variable (string of digits)
var digits = cardNumber.replace(/\D/g, "").split("").map(Number);
var sum = 0;
var isOdd = true;
for (var i = digits.length - 1; i >= 0; i--) {
  var d = digits[i];
  if (!isOdd) {
    d *= 2;
    if (d > 9) d -= 9;
  }
  sum += d;
  isOdd = !isOdd;
}
result = { valid: sum % 10 === 0, cardNumber: cardNumber };

Pattern 3 — Construct Composite Index Key

// tenantId, entityType, entityId injected from workflow variables
var key = [tenantId, entityType, entityId]
  .map(function(s) { return String(s).toLowerCase().replace(/[^a-z0-9]/g, "_"); })
  .join(":");
result = { indexKey: key };