---
title: "CookieJar | Grafana k6 documentation"
description: "Used for storing cookies, set by the server and/or added by the client."
---

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

# CookieJar

*CookieJar* is an object for storing cookies that are set by the server, added by the client, or both. As described in the how-to guide on using [Cookies](/docs/k6/latest/using-k6/cookies/), k6 handles cookies automatically by default. If you need more control over cookies you can however create your own cookie jar and select it as the active jar (instead of the default one created by k6) for one or more requests.

Expand table

| Method                                                                                                | Description                                                                                               |
|-------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------|
| [cookiesForURL(url)](/docs/k6/latest/javascript-api/k6-http/cookiejar/cookiejar-cookiesforurl/)       | Get Object of cookies where the key is the cookie name and the value is an array.                         |
| [set(url, name, value, \[options\])](/docs/k6/latest/javascript-api/k6-http/cookiejar/cookiejar-set/) | Set a cookie in the jar by specifying name, value and some other optional settings like domain, path etc. |
| [clear(url)](/docs/k6/latest/javascript-api/k6-http/cookiejar/cookiejar-clear/)                       | Delete all cookies for the given URL.                                                                     |
| [delete(url, name)](/docs/k6/latest/javascript-api/k6-http/cookiejar/cookiejar-delete/)               | Deletes the `name` cookie for the given URL.                                                              |

### Example

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

```javascript
import http from 'k6/http';
import { check } from 'k6';

export default function () {
  const res1 = http.post('https://quickpizza.grafana.com/api/cookies?my_cookie=hello%20world', {
    redirects: 0,
  });
  const jar = http.cookieJar();
  const cookies = jar.cookiesForURL('https://quickpizza.grafana.com/api/cookies');
  check(res1, {
    "has cookie 'my_cookie'": (r) => cookies.my_cookie.length > 0,
    'cookie has correct value': (r) => cookies.my_cookie[0] === 'hello world',
  });

  jar.clear('https://quickpizza.grafana.com/api/cookies');

  const res2 = http.get('https://quickpizza.grafana.com/api/cookies');
  check(res2, {
    'has status 200': (r) => r.status === 200,
    "hasn't cookie 'my_cookie'": (r) => r.json().cookies.my_cookie == null,
  });
}
```