This is documentation for the next version of Grafana k6 documentation. For the latest stable release, go to the latest version.

Documentationbreadcrumb arrow Grafana k6breadcrumb arrow JavaScript APIbreadcrumb arrow jslibbreadcrumb arrow k6chaijsbreadcrumb arrow config
Open source

config

Chai exposes a few options to change the library configuration.

Config optionDefaultDescription
truncateMsgThreshold300Check message length is truncated to this value.
truncateVariableThreshold100Variables interpolated into check message are truncated to this length. It prevents mistakes when the check name is very large, especially when aggregateChecks is false.
aggregateCheckstrueThe actual values are not interpolated into the check message. Disable for tests with 1 iteration.
logFailuresfalseWhen the check fails, debug messages are printed.
JavaScript
JavaScript 
import http from 'k6/http';
import chai, { describe, expect } from 'https://jslib.k6.io/k6chaijs/4.3.4.3/index.js';

// individual variables should be up to 20 chars after rendering.
chai.config.truncateVariableThreshold = 20;

// whole check() message must be below 300 chars.
chai.config.truncateMsgThreshold = 300;

// the variable values (resp.status) are inserted into the check message - useful for debugging or tests with 1 iteration
chai.config.aggregateChecks = false;

// when the check fails, WARN messages with variables are printed. Useful for debugging.
chai.config.logFailures = true;

export default function testSuite() {
  describe('Testing bad assertion.', () => {
    const response = http.get('https://quickpizza.grafana.com');

    expect(response.body).to.have.lengthOf.at.least(100);
  });
}

Resulting in:

Bash 
█ Testing bad assertion.
  ✓ expected '<!DOCTYPE html>\n<html lang="en">\n<hea...' to have property 'length'
  ✓ expected '<!DOCTYPE html>\n<html lang="en">\n<hea...' to have a length at least 100 got 2611