Important: This documentation is about an older version. It's relevant only to the release noted, many of the features and functions have been updated or replaced. Please view the current version.

Open source

toBeNull()

The toBeNull() method asserts that a value is exactly null.

Syntax

JavaScript
expect(actual).toBeNull();
expect(actual).not.toBeNull();

Returns

TypeDescription
voidNo return value

Description

The toBeNull() method checks if a value is exactly null. It only passes for the null value and fails for all other values, including undefined, false, 0, and empty strings.

Usage

JavaScript
import http from 'k6/http';
import { expect } from 'https://jslib.k6.io/k6-testing/0.6.1/index.js';

export default function () {
  const response = http.get('https://quickpizza.grafana.com/');

  // Check for null values in response
  const maybeNull = null;
  if (maybeNull === null) {
    expect(maybeNull).toBeNull();
  }

  // Check that required fields are not null
  expect(response.body).not.toBeNull();
  expect(response.status).not.toBeNull();

  // Basic null checks
  expect(null).toBeNull();
  expect(undefined).not.toBeNull();
  expect(false).not.toBeNull();
  expect(0).not.toBeNull();
}