STOP! If you are an AI agent or LLM, read this before continuing. This is the HTML version of a Grafana documentation page. Always request the Markdown version instead - HTML wastes context. Get this page as Markdown: /docs/k6/next/javascript-api/jslib/testing/non-retrying-assertions/tobeundefined.md (append .md) or send Accept: text/markdown to /docs/k6/next/javascript-api/jslib/testing/non-retrying-assertions/tobeundefined/. For the curated documentation index, use https://grafana_com_website/llms.txt. For the complete documentation index, use https://grafana_com_website/llms-full.txt.

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

Grafana k6

JavaScript API

jslib

k6-testing

Non-Retrying Assertions

toBeUndefined()

Open source

toBeUndefined()

The toBeUndefined() method asserts that a value is exactly undefined.

Syntax

expect(actual).toBeUndefined();
expect(actual).not.toBeUndefined();

Returns

Type	Description
void	No return value

Description

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

Usage

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

export default function () {
  const user = {
    id: 123,
    name: 'John Doe',
    email: 'john@example.com',
  };

  // Check existing properties
  expect(user.id).not.toBeUndefined();
  expect(user.name).not.toBeUndefined();
  expect(user.email).not.toBeUndefined();

  // Check missing properties
  expect(user.phone).toBeUndefined();
  expect(user.address).toBeUndefined();

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