n8n Uppercase Node

A simple n8n node for converting string values to uppercase.

Features

• Convert single strings to uppercase
• Handle arrays of strings
• Skip non-string values (optional)
• Comprehensive error handling
• TypeScript support
• Full test coverage

Installation

npm install

Development

Build

# Development build (preserves console logs)
npm run build

# Production build (minified, console logs removed)
npm run build:prod

Testing

# Run tests
npm test

# Run tests in watch mode
npm run test:watch

Linting

# Check for linting errors
npm run lint

# Fix linting errors
npm run lint:fix

# Format code
npm run format

Usage

Basic Usage

1. Add the Uppercase node to your n8n workflow
2. Configure the "Field to Convert" parameter with the field path (e.g., data.text)
3. Optionally configure the options:
   • Handle Arrays: Convert each string in an array to uppercase (default: true)
   • Skip Non-Strings: Skip non-string values instead of throwing an error (default: true)

Examples

Simple String Conversion

Input: { "text": "hello world" }
Output: { "text": "HELLO WORLD" }

Array Conversion

Input: { "items": ["apple", "banana", "cherry"] }
Output: { "items": ["APPLE", "BANANA", "CHERRY"] }

Mixed Array with Skip Non-Strings

Input: { "data": ["hello", 123, "world"] }
Output: { "data": ["HELLO", 123, "WORLD"] }

Node Parameters

| Parameter | Type | Required | Description | |-----------|------|----------|-------------| | Field to Convert | string | Yes | The field path to convert to uppercase | | Handle Arrays | boolean | No | Whether to convert strings in arrays (default: true) | | Skip Non-Strings | boolean | No | Whether to skip non-string values (default: true) |

Error Handling

The node provides comprehensive error handling:

• Missing Field: Throws error if the specified field doesn't exist
• Array Handling: Can be configured to handle or reject arrays
• Type Safety: Can be configured to skip or reject non-string values
• Continue on Fail: Supports n8n's "Continue on Fail" option

Build Output

The build system creates:

• dist/index.js - TypeScript compiled output
• dist/bundle.mjs - Single-file ESM bundle for easy distribution
• Source maps and type declarations

License

MIT