---
title: "toHaveLength() | Grafana k6 documentation"
description: "Asserts that an object has a specific length property"
---

> For a curated documentation index, see [llms.txt](/llms.txt). For the complete documentation index, see [llms-full.txt](/llms-full.txt).

# 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

JavaScript ![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy

```javascript
expect(actual).toHaveLength(expected);
expect(actual).not.toHaveLength(expected);
```

## Parameters

Expand table

| Parameter | Type   | Description               |
|-----------|--------|---------------------------|
| expected  | number | The expected length value |

## Returns

Expand table

| 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

JavaScript ![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy

```javascript
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);
}
```