docs

Examples

Tutorials

k6.ioapp.k6.io

No results for “”

Powered byAlgolia
Examples
Cookies Example

Cookies Example

suggest edits

Scripting examples on how you can interact with cookies during your load test if required.

Cookies

As HTTP is a stateless protocol, cookies are used by server-side applications to persist data on client machines. This is used more or less everywhere on the web, commonly for user session tracking purposes. In k6 cookies are managed automatically by default, however, there are use cases where access to read and manipulate cookies are required.

From the response headers

access-cookie.js
1import http from 'k6/http';
2import { check, group } from 'k6';
3
4export default function () {
5  // Since this request redirects the `res.cookies` property won't contain the cookies
6  let res = http.get(
7    'http://httpbin.org/cookies/set?name1=value1&name2=value2',
8  );
9  check(res, {
10    'status is 200': (r) => r.status === 200,
11  });
12
13  // Make sure cookies have been added to VU cookie jar
14  let vuJar = http.cookieJar();
15  let cookiesForURL = vuJar.cookiesForURL(res.url);
16  check(null, {
17    "vu jar has cookie 'name1'": () => cookiesForURL.name1.length > 0,
18    "vu jar has cookie 'name2'": () => cookiesForURL.name2.length > 0,
19  });
20}

Log all the cookies in a response

⚠️ Note that this only works when using k6 locally

The console.log() family of APIs are currently only usable when running k6 locally. When running k6 tests with LoadImpact Cloud Execution the logs will be discarded.

log-all-cookies.js
1// Example showing two methods how to log all cookies (with attributes) from a HTTP response.
2
3import http from 'k6/http';
4
5function logCookie(cookie) {
6  // Here we log the name and value of the cookie along with additional attributes.
7  // For full list of attributes see: https://k6.io/docs/using-k6/cookies#properties-of-a-response-cookie-object
8  console.log(
9    `${cookie.name}: ${cookie.value}\n\tdomain: ${cookie.domain}\n\tpath: ${cookie.path}\n\texpires: ${cookie.expires}\n\thttpOnly: ${cookie.http_only}`,
10  );
11}
12
13export default function () {
14  let res = http.get('https://www.google.com/');
15
16  // Method 1: Use for-loop and check for non-inherited properties
17  for (var name in res.cookies) {
18    if (res.cookies.hasOwnProperty(name) !== undefined) {
19      logCookie(res.cookies[name][0]);
20    }
21  }
22
23  // Method 2: Use ES6 Map to loop over Object entries
24  new Map(Object.entries(res.cookies)).forEach((v, k) => logCookie(v[0]));
25}

Setting a cookie in the VU cookie jar

To set a cookie that should be sent with every request matching a particular domain, path, etc. you'd do something like this:

set-cookie-in-jar.js
1import http from 'k6/http';
2import { check } from 'k6';
3
4export default function () {
5  // Get VU cookie jar and add a cookie to it providing the parameters
6  // that a request must match (domain, path, HTTPS or not etc.)
7  // to have the cookie attached to it when sent to the server.
8  let jar = http.cookieJar();
9  jar.set('https://httpbin.org/cookies', 'my_cookie', 'hello world', {
10    domain: 'httpbin.org',
11    path: '/cookies',
12    secure: true,
13    max_age: 600,
14  });
15
16  // As the following request is matching the above cookie in terms of domain,
17  // path, HTTPS (secure) and will happen within the specified "age" limit, the
18  // cookie will be attached to this request.
19  let res = http.get('https://httpbin.org/cookies');
20  check(res, {
21    'has status 200': (r) => r.status === 200,
22    "has cookie 'my_cookie'": (r) => r.json().cookies.my_cookie !== null,
23    'cookie has correct value': (r) =>
24      r.json().cookies.my_cookie == 'hello world',
25  });
26}

Relevant k6 APIs: