---
title: "randomString(length, [charset]) | Grafana k6 documentation"
description: "Random string"
---

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

# randomString(length, \[charset])

Function returns a random string of a given length, optionally selected from a custom character set.

Expand table

| Parameter          | Type   | Description                     |
|--------------------|--------|---------------------------------|
| length             | int    | Length of the random string     |
| charset (optional) | string | A customized list of characters |

### Returns

Expand table

| Type | Description                                 |
|------|---------------------------------------------|
| any  | Random item(s) from the array of characters |

### Example

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

```javascript
import { randomString } from 'https://jslib.k6.io/k6-utils/1.2.0/index.js';

export default function () {
  const randomFirstName = randomString(8);
  console.log(`Hello, my first name is ${randomFirstName}`);

  const randomLastName = randomString(10, `aeioubcdfghijpqrstuv`);
  console.log(`Hello, my last name is ${randomLastName}`);

  const randomCharacterWeighted = randomString(1, `AAAABBBCCD`);
  console.log(`Chose a random character ${randomCharacterWeighted}`);
}
```