feat: add additional string expressions (#2517)

docs/4_secondary_admin_controls/expressions/functions.md

@@ -86,6 +86,26 @@ substr() extracts characters from indexStart up to but not including indexEnd.
 
 Tip: If you don't want the behaviour of negative numbers, you can use `max(0, index)` to limit the value to never be below 0.
 
+**includes(val, find)**
+
+Check if a string contains a specific value
+
+eg `includes("Companion is great!", "great")` gives `true`
+
+**toUpperCase(val)**
+
+Coverts all characters in a string to uppercase
+
+**toLowerCase(val)**
+
+Coverts all characters in a string to lowercase
+
+**replaceAll(val, find, replace)**
+
+Searches a string for a specific value, and then replaces all instances of that value with a new string
+
+eg `replaceAll("This is great!", "This", "Companion")` gives `Companion is great!`
+
 **secondsToTimestamp(seconds, format)**
 
 Convert a number of seconds into a timestamp of format 'HH:mm:ss'.

lib/Shared/Expression/ExpressionFunctions.js

@@ -38,6 +38,18 @@ export const ExpressionFunctions = {
 	substr: (str, start, end) => {
 		return (str + '').slice(start, end)
 	},
+	includes: (str, arg) => {
+		return (str + '').includes(arg)
+	},
+	toUpperCase: (str) => {
+		return (str + '').toUpperCase()
+	},
+	toLowerCase: (str) => {
+		return (str + '').toLowerCase()
+	},
+	replaceAll: (str, find, replace) => {
+		return (str + '').replaceAll(find, replace)
+	},
 	secondsToTimestamp: (v, type) => {
 		v = Math.max(0, v)