---
title: "Client.lpop(key) | Grafana k6 documentation"
description: "Removes and returns the first element of the list stored at `key`."
---

# Client.lpop(key)

Removes and returns the first element of the list stored at `key`.

### Parameters

Expand table

| Parameter | Type   | Description                            |
|-----------|--------|----------------------------------------|
| `key`     | string | key holding the list to left pop from. |

### Returns

Expand table

| Type              | Resolves with                                                         | Rejected when                                                      |
|-------------------|-----------------------------------------------------------------------|--------------------------------------------------------------------|
| `Promise<string>` | On success, the promise resolves with the value of the first element. | If the list does not exist, the promise is rejected with an error. |

### Example

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

```javascript
import redis from 'k6/x/redis';

// Instantiate a new redis client
const redisClient = new redis.Client('redis://localhost:6379');

export default async function () {
  await redisClient.lpush('mylist', 'first');
  await redisClient.rpush('mylist', 'second');

  const item = await redisClient.lpop('mylist');
  await redisClient.rpush('mylist', item);
  await redisClient.rpop('mylist');
}
```
