Matching Rule Definition Expressions
Test expectations (requests, responses or messages) setup via plugins use matching rule expressions to configure the rules and values required for the test. Each definition can contain a number of expressions, separated by a comma. Whitespace is ignored.
Primitive (or scalar) values can be strings (quoted with single quotes), numbers, booleans or null.
The main types of expressions are one of the following:
matching(TYPE [, CONFIG], EXAMPLE) or matching($'NAME')
Expression that defines a matching rule. Each matching rule requires the type of matching rule, and can contain an optional configuration value. The final value is the example value to use.
Supported matching rules:
|equalTo||Value must be equal to the example|
|type||Value must be the same type as the example|
|number||Value must be a numeric value|
|integer||Value must be an integer value (no decimals)|
|decimal||Value must be a decimal number (must have at least one significant figure after the decimal point)|
|datetime||Value must match a date-time format string||Format String|
|date||Value must match a date format string||Format String|
|time||Value must match a time format string||Format String|
|regex||Value must match a regular expression||Regular expression|
|include||Value must include the example value as a substring|
|boolean||Value must be a boolean|
|server||Value must match the semver specification|
|contentType||Value must be of the provided content type. This will preform a magic test on the bytes of the value.||Content type|
The final form is a reference to another key. This is used to setup type matching using an example value, and is normally used for collections. The name of the key must be a string value in single quotes.
For example, to configure a type matcher where each value in a list must match the definition of a person:
Expression that defines the value the same type as the example, must be present and not empty. This is used to defined required fields.
Configures a matching rule to be applied to each key in a map.
eachKey(matching(regex, '\$(\.\w+)+', '$.test.one'))
Configures a matching rule to be applied to each value in a map or list.
There is a grammar for the definitions in ANTLR4 format.