Update addCookies

Author: inancgumus

src/data/markdown/docs/02 javascript api/07 k6-experimental/01 browser/02 BrowserContext/addCookies.md

@@ -3,7 +3,14 @@ title: 'addCookies()'
 excerpt: 'Clears context cookies.'
 ---
 
-Adds cookies into the `BrowserContext`. All pages within this context will have these cookies installed.
+Adds a list of [cookies](/javascript-api/k6-experimental/browser/browsercontext/cookie) into the [BrowserContext](/javascript-api/k6-experimental/browser/browsercontext/cookie). All pages within this [BrowserContext](/javascript-api/k6-experimental/browser/browsercontext/cookie) will have these [cookies](/javascript-api/k6-experimental/browser/browsercontext/cookie) installed.
+
+<Blockquote mod="info">
+
+If a [cookie](/javascript-api/k6-experimental/browser/browsercontext/cookie)'s `url` property is not provided, both `domain` and `path` properties must be specified.
+
+</Blockquote>
+
 
 ### Example
 
@@ -27,18 +34,47 @@ export const options = {
 
 export default async function () {
   const context = browser.newContext();
+  const page = context.newPage();
 
-  context.addCookies([
-    {
-      name: 'myCookie',
-      value: 'hello world',
-      url: 'https://test.k6.io/',
-    },
-  ]);
+  try {
+    const unixTimeSinceEpoch = Math.round(new Date() / 1000);
+    const day = 60*60*24;
+    const dayAfter = unixTimeSinceEpoch+day;
+    const dayBefore = unixTimeSinceEpoch-day;
 
-  const page = context.newPage();
-  await page.goto('https://test.k6.io/');
-  page.close();
+    context.addCookies([
+      // this cookie expires at the end of the session
+      {
+        name: 'testcookie',
+        value: '1',
+        sameSite: 'Strict',
+        domain: '127.0.0.1',
+        path: '/',
+        httpOnly: true,
+        secure: true,
+      },
+      // this cookie expires in a day
+      {
+        name: 'testcookie2',
+        value: '2',
+        sameSite: 'Lax',
+        domain: '127.0.0.1',
+        path: '/',
+        expires: dayAfter,
+      },
+      // this cookie expires in the past, so it will be removed.
+      {
+        name: 'testcookie3',
+        value: '3',
+        sameSite: 'Lax',
+        domain: '127.0.0.1',
+        path: '/',
+        expires: dayBefore
+      }
+    ]);
+  } finally {
+    page.close();
+  }
 }
 ```