Files
n8n-mcp/tests/unit/services/node-sanitizer.test.ts
Romuald Członkowski 6be9ffa53e fix: correct operator names, connection types, and implement __patch_find_replace (#665, #659, #642) (#672)
Three critical fixes in n8n_update_partial_workflow:

- **#665**: Replace incorrect `isNotEmpty`/`isEmpty` operator names with `notEmpty`/`empty`
  across validators, sanitizer, docs, and error messages. Add auto-correction in sanitizer.
  Unknown operators silently returned false in n8n's execution engine.

- **#659**: Remap numeric `targetInput` values (e.g., "0") to "main" in addConnection.
  Relax sourceOutput remapping guard for redundant sourceOutput+sourceIndex combinations.
  Also resolves #653 (dangling connections caused by malformed type:"0" connections).

- **#642**: Implement __patch_find_replace for surgical string edits in updateNode.
  Previously stored patch objects literally as jsCode, producing [object Object].
  Now reads current value, applies find/replace sequentially, writes back the string.

Conceived by Romuald Członkowski - https://www.aiadvisors.pl/en

Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-27 16:26:21 +01:00

495 lines
14 KiB
TypeScript

/**
* Node Sanitizer Tests
* Tests for auto-adding required metadata to filter-based nodes
*/
import { describe, it, expect } from 'vitest';
import { sanitizeNode, validateNodeMetadata } from '../../../src/services/node-sanitizer';
import { WorkflowNode } from '../../../src/types/n8n-api';
describe('Node Sanitizer', () => {
describe('sanitizeNode', () => {
it('should add complete filter options to IF v2.2 node', () => {
const node: WorkflowNode = {
id: 'test-if',
name: 'IF Node',
type: 'n8n-nodes-base.if',
typeVersion: 2.2,
position: [0, 0],
parameters: {
conditions: {
conditions: [
{
id: 'condition1',
leftValue: '={{ $json.value }}',
rightValue: '',
operator: {
type: 'string',
operation: 'isNotEmpty'
}
}
]
}
}
};
const sanitized = sanitizeNode(node);
// Check that options were added
expect(sanitized.parameters.conditions).toHaveProperty('options');
const options = (sanitized.parameters.conditions as any).options;
expect(options).toEqual({
version: 2,
leftValue: '',
caseSensitive: true,
typeValidation: 'strict'
});
});
it('should preserve existing options while adding missing fields', () => {
const node: WorkflowNode = {
id: 'test-if-partial',
name: 'IF Node Partial',
type: 'n8n-nodes-base.if',
typeVersion: 2.2,
position: [0, 0],
parameters: {
conditions: {
options: {
caseSensitive: false // User-provided value
},
conditions: []
}
}
};
const sanitized = sanitizeNode(node);
const options = (sanitized.parameters.conditions as any).options;
// Should preserve user value
expect(options.caseSensitive).toBe(false);
// Should add missing fields
expect(options.version).toBe(2);
expect(options.leftValue).toBe('');
expect(options.typeValidation).toBe('strict');
});
it('should fix invalid operator structure (type field misuse)', () => {
const node: WorkflowNode = {
id: 'test-if-bad-operator',
name: 'IF Bad Operator',
type: 'n8n-nodes-base.if',
typeVersion: 2.2,
position: [0, 0],
parameters: {
conditions: {
conditions: [
{
id: 'condition1',
leftValue: '={{ $json.value }}',
rightValue: '',
operator: {
type: 'isNotEmpty' // WRONG: type should be data type, not operation
}
}
]
}
}
};
const sanitized = sanitizeNode(node);
const condition = (sanitized.parameters.conditions as any).conditions[0];
// Should fix operator structure and auto-correct isNotEmpty to notEmpty
expect(condition.operator.type).toBe('string'); // Inferred data type (default)
expect(condition.operator.operation).toBe('notEmpty'); // Moved to operation field and auto-corrected
});
it('should add singleValue for unary operators', () => {
const node: WorkflowNode = {
id: 'test-if-unary',
name: 'IF Unary',
type: 'n8n-nodes-base.if',
typeVersion: 2.2,
position: [0, 0],
parameters: {
conditions: {
conditions: [
{
id: 'condition1',
leftValue: '={{ $json.value }}',
rightValue: '',
operator: {
type: 'string',
operation: 'isNotEmpty'
// Missing singleValue
}
}
]
}
}
};
const sanitized = sanitizeNode(node);
const condition = (sanitized.parameters.conditions as any).conditions[0];
expect(condition.operator.singleValue).toBe(true);
});
it('should sanitize Switch v3.2 node rules', () => {
const node: WorkflowNode = {
id: 'test-switch',
name: 'Switch Node',
type: 'n8n-nodes-base.switch',
typeVersion: 3.2,
position: [0, 0],
parameters: {
mode: 'rules',
rules: {
rules: [
{
outputKey: 'audio',
conditions: {
conditions: [
{
id: 'cond1',
leftValue: '={{ $json.fileType }}',
rightValue: 'audio',
operator: {
type: 'string',
operation: 'equals'
}
}
]
}
}
]
}
}
};
const sanitized = sanitizeNode(node);
const rule = (sanitized.parameters.rules as any).rules[0];
// Check that options were added to rule conditions
expect(rule.conditions).toHaveProperty('options');
expect(rule.conditions.options).toEqual({
version: 2,
leftValue: '',
caseSensitive: true,
typeValidation: 'strict'
});
});
it('should not modify non-filter nodes', () => {
const node: WorkflowNode = {
id: 'test-http',
name: 'HTTP Request',
type: 'n8n-nodes-base.httpRequest',
typeVersion: 4.2,
position: [0, 0],
parameters: {
method: 'GET',
url: 'https://example.com'
}
};
const sanitized = sanitizeNode(node);
// Should return unchanged
expect(sanitized).toEqual(node);
});
it('should not modify old IF versions', () => {
const node: WorkflowNode = {
id: 'test-if-old',
name: 'Old IF',
type: 'n8n-nodes-base.if',
typeVersion: 2.0, // Pre-filter version
position: [0, 0],
parameters: {
conditions: []
}
};
const sanitized = sanitizeNode(node);
// Should return unchanged
expect(sanitized).toEqual(node);
});
it('should remove singleValue from binary operators like "equals"', () => {
const node: WorkflowNode = {
id: 'test-if-binary',
name: 'IF Binary Operator',
type: 'n8n-nodes-base.if',
typeVersion: 2.2,
position: [0, 0],
parameters: {
conditions: {
conditions: [
{
id: 'condition1',
leftValue: '={{ $json.value }}',
rightValue: 'test',
operator: {
type: 'string',
operation: 'equals',
singleValue: true // WRONG: equals is binary, not unary
}
}
]
}
}
};
const sanitized = sanitizeNode(node);
const condition = (sanitized.parameters.conditions as any).conditions[0];
// Should remove singleValue from binary operator
expect(condition.operator.singleValue).toBeUndefined();
expect(condition.operator.type).toBe('string');
expect(condition.operator.operation).toBe('equals');
});
it('should auto-correct isNotEmpty to notEmpty', () => {
const node: WorkflowNode = {
id: 'test-if-autocorrect',
name: 'IF AutoCorrect',
type: 'n8n-nodes-base.if',
typeVersion: 2.2,
position: [0, 0],
parameters: {
conditions: {
conditions: [
{
id: 'condition1',
leftValue: '={{ $json.value }}',
rightValue: '',
operator: {
type: 'string',
operation: 'isNotEmpty' // Legacy operator name
}
}
]
}
}
};
const sanitized = sanitizeNode(node);
const condition = (sanitized.parameters.conditions as any).conditions[0];
// Should auto-correct isNotEmpty to notEmpty
expect(condition.operator.operation).toBe('notEmpty');
expect(condition.operator.type).toBe('string');
expect(condition.operator.singleValue).toBe(true); // notEmpty is unary
});
});
describe('validateNodeMetadata', () => {
it('should detect missing conditions.options', () => {
const node: WorkflowNode = {
id: 'test',
name: 'IF Missing Options',
type: 'n8n-nodes-base.if',
typeVersion: 2.2,
position: [0, 0],
parameters: {
conditions: {
conditions: []
// Missing options
}
}
};
const issues = validateNodeMetadata(node);
expect(issues.length).toBeGreaterThan(0);
expect(issues[0]).toBe('Missing conditions.options');
});
it('should detect missing operator.type', () => {
const node: WorkflowNode = {
id: 'test',
name: 'IF Bad Operator',
type: 'n8n-nodes-base.if',
typeVersion: 2.2,
position: [0, 0],
parameters: {
conditions: {
options: {
version: 2,
leftValue: '',
caseSensitive: true,
typeValidation: 'strict'
},
conditions: [
{
id: 'cond1',
leftValue: '={{ $json.value }}',
rightValue: '',
operator: {
operation: 'equals'
// Missing type
}
}
]
}
}
};
const issues = validateNodeMetadata(node);
expect(issues.length).toBeGreaterThan(0);
expect(issues.some(issue => issue.includes("missing required field 'type'"))).toBe(true);
});
it('should detect invalid operator.type value', () => {
const node: WorkflowNode = {
id: 'test',
name: 'IF Invalid Type',
type: 'n8n-nodes-base.if',
typeVersion: 2.2,
position: [0, 0],
parameters: {
conditions: {
options: {
version: 2,
leftValue: '',
caseSensitive: true,
typeValidation: 'strict'
},
conditions: [
{
id: 'cond1',
leftValue: '={{ $json.value }}',
rightValue: '',
operator: {
type: 'isNotEmpty', // WRONG: operation name, not data type
operation: 'isNotEmpty'
}
}
]
}
}
};
const issues = validateNodeMetadata(node);
expect(issues.some(issue => issue.includes('invalid type "isNotEmpty"'))).toBe(true);
});
it('should detect missing singleValue for unary operators', () => {
const node: WorkflowNode = {
id: 'test',
name: 'IF Missing SingleValue',
type: 'n8n-nodes-base.if',
typeVersion: 2.2,
position: [0, 0],
parameters: {
conditions: {
options: {
version: 2,
leftValue: '',
caseSensitive: true,
typeValidation: 'strict'
},
conditions: [
{
id: 'cond1',
leftValue: '={{ $json.value }}',
rightValue: '',
operator: {
type: 'string',
operation: 'notEmpty'
// Missing singleValue: true
}
}
]
}
}
};
const issues = validateNodeMetadata(node);
expect(issues.length).toBeGreaterThan(0);
expect(issues.some(issue => issue.includes('requires singleValue: true'))).toBe(true);
});
it('should detect singleValue on binary operators', () => {
const node: WorkflowNode = {
id: 'test',
name: 'IF Binary with SingleValue',
type: 'n8n-nodes-base.if',
typeVersion: 2.2,
position: [0, 0],
parameters: {
conditions: {
options: {
version: 2,
leftValue: '',
caseSensitive: true,
typeValidation: 'strict'
},
conditions: [
{
id: 'cond1',
leftValue: '={{ $json.value }}',
rightValue: 'test',
operator: {
type: 'string',
operation: 'equals',
singleValue: true // WRONG: equals is binary
}
}
]
}
}
};
const issues = validateNodeMetadata(node);
expect(issues.length).toBeGreaterThan(0);
expect(issues.some(issue => issue.includes('should not have singleValue: true'))).toBe(true);
});
it('should return empty array for valid node', () => {
const node: WorkflowNode = {
id: 'test',
name: 'Valid IF',
type: 'n8n-nodes-base.if',
typeVersion: 2.2,
position: [0, 0],
parameters: {
conditions: {
options: {
version: 2,
leftValue: '',
caseSensitive: true,
typeValidation: 'strict'
},
conditions: [
{
id: 'cond1',
leftValue: '={{ $json.value }}',
rightValue: '',
operator: {
type: 'string',
operation: 'notEmpty',
singleValue: true
}
}
]
}
}
};
const issues = validateNodeMetadata(node);
expect(issues).toEqual([]);
});
});
});