Testing

Tests execute the same SDK pipeline used by applications, including validation, conditions, sampling, transforms, effects, and destinations.

Every test spec must contain at least one assertion. Matrices must contain at least one key and one value for every key, so an empty definition cannot produce a false passing result.

npx eventvisor test

Use repeatable --target and --tag options, or --set, to test the corresponding datafile selection.

Matrix assertions#

Matrices create a Cartesian product. Placeholders retain their original type when the complete value is a placeholder.

event: pageView
assertions:
  - description: tracks for ${{ country }} on ${{ device }}
    matrix:
      country: [NL, DE]
      device: [mobile, desktop]
    withAttributes:
      country: ${{ country }}
    track:
      device: ${{ device }}
    expectedToBeValid: true

Actions#

Assertions can run track, setAttribute, and removeAttribute actions. Destination assertions can use assertAfter for asynchronous transports.

An event assertion requires track or at least one action. Effect and destination assertions require at least one action. Every assertion must contain an expectation, so setup only assertions cannot pass without checking behaviour.

Expectations#

Event assertions support transformed event values and routed destinations, including destination groups by tag. expectedToBeValid checks the payload against the event schema. expectedToBeTracked checks whether the complete governance pipeline accepted it. This distinction is useful when a valid payload is rejected by conditions, required attributes, or sampling.

Attribute assertions use expectedToBeValid for schema validity, then check presence and final values independently. Effect assertions cover state and handlers. Destination assertions cover transport attempts, one body, or the complete ordered body list. Use either expectedBody or expectedBodies, not both.

Key and assertion patterns must match something. A typo that selects no tests fails the command instead of producing a false passing result.

The Catalog displays authored tests and applied matrix cases with shareable assertion links.