String Replace#

The String Replace converter receives a string, replaces the text that matches searchValue with replaceValue, and returns the result. It follows the JavaScript String.prototype.replace rules:

• A searchValue written as /pattern/flags is a regular expression. Add the g flag to replace every match; without it, only the first match is replaced.
• Any other searchValue is literal text, and only its first occurrence is replaced.
• In replaceValue, $1, $2, and so on insert the text captured by the matching group of the regular expression, and $& inserts the matched text.

Settings#

Table 1: Settings

Examples#

Table 2: Examples

The last example keeps long JSON integers as text, so that they do not lose precision when the JSON is parsed.

In a Control Flow expression, the regular expression is MathJS text, so write each backslash twice, for example {{ stringReplace($onMessage.data, "/:\\s*(-?\\d{16,})/g", ': "$1"') }}. See Control Flow Expressions.

Invalid Input#

This converter fails in any of the cases below. For what happens to the rest of the chain when a converter fails (the error is logged, reported for monitoring, and the next task does not run), see Converters.

Table 3: Invalid Input