CookieJar on Grafana Labs

CookieJar.clear(url)

Mon, 21 Sep 2026 15:16:28 +0000

CookieJar.clear(url)

Parameter	Type	Description
url	string	The URL to delete all cookies for.

Example

import http from 'k6/http';

export default function () {
  http.post('https://quickpizza.grafana.com/api/cookies?one=1&two=2');

  // We'll use QuickPizza's cookie reflection to see what cookies we
  // are actually sending to the server after every change
  let qpResp;
  qpResp = http.get('https://quickpizza.grafana.com/api/cookies');
  console.log(JSON.stringify(qpResp.json().cookies));
  // Will print '{"one":"1","two":"2"}'

  const jar = http.cookieJar(); // get the VU specific jar
  jar.set('https://quickpizza.grafana.com/api/cookies', 'three', '3');
  qpResp = http.get('https://quickpizza.grafana.com/api/cookies');
  console.log(JSON.stringify(qpResp.json().cookies));
  // Will print '{"one":"1","three":"3","two":"2"}'

  jar.delete('https://quickpizza.grafana.com/api/cookies', 'one');
  qpResp = http.get('https://quickpizza.grafana.com/api/cookies');
  console.log(JSON.stringify(qpResp.json().cookies));
  // Will print '{"three":"3","two":"2"}'

  jar.clear('https://quickpizza.grafana.com/api/cookies');
  qpResp = http.get('https://quickpizza.grafana.com/api/cookies');
  console.log(JSON.stringify(qpResp.json().cookies));
  // Will print '{}'
}

CookieJar.cookiesForURL(url)

Mon, 21 Sep 2026 15:16:28 +0000

CookieJar.cookiesForURL(url)

Parameter	Type	Description
url	string	The URL to get cookies for.

Returns

Type	Description
object	A JS object with all cookies for the given URL, where the key is the cookie name and the value is an array.

Example

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

export default function () {
  const res = 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(res, {
    "has cookie 'my_cookie'": (r) => cookies.my_cookie.length > 0,
    'cookie has correct value': (r) => cookies.my_cookie[0] === 'hello world',
  });
}

CookieJar.delete(url, name)

Mon, 21 Sep 2026 15:16:28 +0000

CookieJar.delete(url, name)

Parameter	Type	Description
url	string	The URL to delete cookies for.
name	string	The name of the cookie you want to delete.

Example

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

export default function () {
  const jar = http.cookieJar();
  jar.set('https://quickpizza.grafana.com/api/cookies', 'my_cookie_1', 'hello world_1');
  jar.set('https://quickpizza.grafana.com/api/cookies', 'my_cookie_2', 'hello world_2');

  const res1 = http.get('https://quickpizza.grafana.com/api/cookies');
  check(res1, {
    'res1 has status 200': (r) => r.status === 200,
    "res1 has cookie 'my_cookie_1'": (r) => r.json().cookies.my_cookie_1 !== null,
    'res1 cookie has correct value_1': (r) => r.json().cookies.my_cookie_1 == 'hello world_1',
    "res1 has cookie 'my_cookie_2'": (r) => r.json().cookies.my_cookie_2 !== null,
    'res1 cookie has correct value_2': (r) => r.json().cookies.my_cookie_2 == 'hello world_2',
  });

  jar.delete('https://quickpizza.grafana.com/api/cookies', 'my_cookie_1');

  const res2 = http.get('https://quickpizza.grafana.com/api/cookies');
  check(res2, {
    'res2 has status 200': (r) => r.status === 200,
    "res2 doesn't have cookie 'my_cookie_1'": (r) => r.json().cookies.my_cookie_1 == null,
    "res2 has cookie 'my_cookie_2'": (r) => r.json().cookies.my_cookie_2 !== null,
    'res2 cookie has correct value_2': (r) => r.json().cookies.my_cookie_2 == 'hello world_2',
  });
}

CookieJar.set(url, name, value, [options])

Mon, 21 Sep 2026 15:16:28 +0000

CookieJar.set(url, name, value, [options])

Set a cookie in the jar by specifying url, name, value and some other optional settings like domain, path, etc.

Parameter	Type	Description
url	string	Cookie URL
name	string	Cookie name
value	string	Cookie value
options (optional)	object	Specific cookie settings: `domain`, `path`, `expires`, `max_age`, `secure` and `http_only`.

Example

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

export default function () {
  const jar = http.cookieJar();
  jar.set('http://quickpizza.grafana.com', 'my_cookie', 'hello world', {
    domain: 'quickpizza.grafana.com',
    path: '/api/cookies',
    secure: true,
    max_age: 600,
  });
  const res = http.get('https://quickpizza.grafana.com/api/cookies');
  console.log(res.body);
  check(res, {
    'has status 200': (r) => r.status === 200,
    "has cookie 'my_cookie'": (r) => r.json().cookies.my_cookie !== null,
    'cookie has correct value': (r) => r.json().cookies.my_cookie == 'hello world',
  });
}