Documentation for automated readers
A curated documentation index is available at: https://grafana.com/llms.txt
A complete documentation index is available at: https://grafana.com/llms-full.txt
These indexes can help with page discovery before fetching individual documents.
This page is also available in Markdown, which may be easier for automated readers and AI tools to parse than HTML. The Markdown version is available at https://grafana.com/docs/k6/next/javascript-api/jslib/testing/non-retrying-assertions/tohavelength.md, or by sending Accept: text/markdown to https://grafana.com/docs/k6/next/javascript-api/jslib/testing/non-retrying-assertions/tohavelength/. For broader documentation discovery, the curated index is available at https://grafana.com/llms.txt and the complete index is available at https://grafana.com/llms-full.txt.
This is documentation for the next version of Grafana k6 documentation. For the latest stable release, go to the latest version.
toHaveLength()
The toHaveLength() method asserts that an object has a specific length property value. This is commonly used with arrays, strings, and other objects that have a length property.
Syntax
expect(actual).toHaveLength(expected);
expect(actual).not.toHaveLength(expected);Parameters
| Parameter | Type | Description |
|---|---|---|
| expected | number | The expected length value |
Returns
| Type | Description |
|---|---|
| void | No return value |
Description
The toHaveLength() method checks if an object has a length property that equals the expected value. It works with arrays, strings, and any object that has a numeric length property.
Usage
import { expect } from 'https://jslib.k6.io/k6-testing/0.6.1/index.js';
export default function () {
const fruit = 'mango';
expect(fruit).toHaveLength(5);
expect(fruit).not.toHaveLength(2);
}Was this page helpful?
Related resources from Grafana Labs

