Data ConverterInstall

Overview

The node performs URL encoding on input text data. URL encoding converts characters into a format that can be transmitted over the internet by replacing unsafe ASCII characters with a "%" followed by two hexadecimal digits. This is useful when preparing data to be included in URLs, such as query parameters or form submissions, ensuring special characters do not interfere with URL parsing.

Common scenarios include:

• Encoding user input before appending it to a URL.
• Preparing strings for HTTP requests where reserved characters must be escaped.
• Encoding data to be safely passed through web APIs or links.

Example: Encoding the string Hello World! results in Hello%20World%21.

Properties

Output

The node outputs a JSON object with a field named result containing the URL-encoded string.

Example output JSON:

{
  "result": "Hello%20World%21"
}

If configured to output binary data (not typical for URL encoding), the node will provide the encoded data as binary under the specified binary property name.

Dependencies

• No external services or API keys are required.
• The node uses internal utility functions for encoding operations.
• No special environment variables or n8n configurations are necessary.

Troubleshooting

• Empty Input: If the input data is empty, the output will also be empty. Ensure the input string is provided.
• Invalid Characters: The node encodes all characters safely; however, malformed input strings (e.g., non-string types) may cause errors.
• Error Handling: If an error occurs during execution, the node throws an error message indicating the problem. Using "Continue On Fail" allows processing subsequent items despite errors.

Links and References

• URL Encoding - MDN Web Docs
• RFC 3986 - Uniform Resource Identifier (URI): Generic Syntax