Join Text List
Uncontrolled node
Overview
The Join Text List node combines all elements of a text array into a single string, inserting a specified separator between each element. This is useful for concatenating lists of words, sentences, or data rows into a single text output.
For example, joining the list ["Hello", "world"] with a space separator produces "Hello world".
Inputs
| Input | Type | Description | Default |
|---|---|---|---|
| List | Array | The list of text items to join together. | - |
| Separator | Text | The string to insert between each element in the list. | Empty string ("") |
Outputs
| Output | Type | Description |
|---|---|---|
| Output | Text | The concatenated string with separators inserted between elements. |
Runtime Behavior and Defaults
This is an uncontrolled node, meaning it executes automatically whenever its inputs change without requiring an event trigger.
- Empty List Handling: If the input list is empty or not a valid array, the node returns an empty string.
- Separator Handling: If the separator is not provided or is not a string type, it defaults to an empty string (elements are concatenated directly with no delimiter).
- Type Coercion: Non-string elements in the list are converted to strings during the join operation.
Example Usage
Scenario: Combining a list of words into a sentence.
- Create a List node containing
["The", "quick", "brown", "fox"] - Connect the List output to the Join Text List node's
listinput - Set the
separatorinput to a single space:" " - The
outputwill contain:"The quick brown fox"
Scenario: Creating a comma-separated values (CSV) line from data.
- Provide a list of values:
["apple", "banana", "cherry"] - Set the
separatorto:", " - The
outputwill contain:"apple, banana, cherry"