Docs »

Bots »

Scripting »

Reference: Tests

A test is an expression that returns a boolean value (true or false).

Tests are performed using the is and is not operators.

When used as output, a test returns 1 for true, and nothing for false.

These tests are available in bot scripts and snippets:

empty

The empty test checks if a variable is an empty string, empty array, empty object, false, or null.



"": {{"" is empty}}
[]: {{[] is empty}}
{}: {{{ } is empty}}
false: {{false is empty}}
not something: {{"something" is not empty}}


"": 1
[]: 1
{}: 1
false: 1
not something: 1 

even

The even test checks if a numeric variable is even.



1: {{1 is even ? 'even' : 'odd'}}
2: {{2 is even ? 'even' : 'odd'}}


1: odd
2: even

iterable

The iterable test checks if a variable is an array or iterable object.



123: {{123 is iterable ? 'iterable' : 'not iterable'}}
[1,2,3]: {{[1,2,3] is iterable ? 'iterable' : 'not iterable'}}


123: not iterable
[1,2,3]: iterable

null

The null test checks if a variable is null.



undefined: {{unknownVariable is null ? 'null' : 'defined'}}
123: {{123 is null ? 'null' : 'constant'}}
{% set name = 'Kina Halpue' %}
name: {{name is null ? 'null' : 'defined'}}


undefined: null
123: constant
name: defined

numeric

The numeric test checks if a variable is numeric.



123: {{123 is numeric ? 'numeric' : 'not numeric'}}
abc: {{"abc" is numeric ? 'numeric' : 'not numeric'}}
[1,2,3]: {{[1,2,3] is numeric ? 'numeric' : 'not numeric'}}


123: numeric
abc: not numeric
[1,2,3]: not numeric

odd

The odd test checks if a numeric variable is odd.



1: {{1 is even ? 'even' : 'odd'}}
2: {{2 is even ? 'even' : 'odd'}}


1: odd
2: even

pattern

The pattern test checks if a variable matches any pattern in a set.

The variable can be a string or an array. The test accepts one or more patterns where asterisks (*) denote wildcards.



{% set recipient = "support@cerb.example" %}
{{recipient is pattern ("support@*", "*@example.com")}}


1

prefixed

The prefixed test checks if a string variable starts with any pattern in a set.

The test accepts one or more patterns.



{% set subject = "[Bugs] New issue reported" %}
{{subject is prefixed ("[Bugs]")}}


1

record type

The record type test checks if an expression matches any of a list of record types. Record types can be specified as extension IDs (e.g. cerberusweb.contexts.ticket) or URIs (e.g. ticket).



{% set record__context = 'cerberusweb.contexts.task' %}
{{record__context is record type ('task','ticket')}}


1

same as

The same as test checks if two variables are of the same exact type and value. This avoids type coercion (e.g. converting strings to numbers).



{% set number = 1 %}
{% set string = "1" %}
{{number is same as string ? 'same' : 'not same'}}


not same

suffixed

The suffixed test checks if a string variable ends with any pattern in a set.

The test accepts one or more patterns.



{% set domain = "cerb.ai" %}
{{domain is suffixed (".ai", ".com")}}


1