Cookie Actions

Manage browser cookies — get, set, delete, and clear.

getCookies

Get cookies, optionally filtered by URL, name, or domain.

Value: string (URL) or undefined

{ "getCookies": "https://example.com" }

Options

Option	Type	Description
name	string	Filter by cookie name
domain	string	Filter by domain

{
  "getCookies": "https://example.com",
  "options": { "name": "session_id" }
}

Returns: Array of cookie objects.

setCookies

Set one or more cookies.

Value: Array of cookie objects

{
  "setCookies": [
    {
      "url": "https://example.com",
      "name": "session",
      "value": "abc123",
      "path": "/",
      "secure": true,
      "httpOnly": false
    }
  ]
}

Cookie Properties

Property	Type	Required	Description
url	string	Yes	The URL to associate the cookie with
name	string	Yes	Cookie name
value	string	Yes	Cookie value
domain	string	No	Cookie domain
path	string	No	Cookie path (default: "/")
secure	boolean	No	HTTPS only
httpOnly	boolean	No	Not accessible via JavaScript
expirationDate	number	No	Unix timestamp for expiration
sameSite	string	No	"lax", "strict", or "no_restriction"

deleteCookie

Delete a specific cookie by URL and name.

Value: { url, name }

{
  "deleteCookie": {
    "url": "https://example.com",
    "name": "session"
  }
}

clearCookies

Clear all cookies for a URL, or clear all cookies entirely.

Value: string (URL) or true (all cookies)

{ "clearCookies": "https://example.com" }

{ "clearCookies": true }

Example: Login with Pre-set Cookies

{
  "actions": [
    {
      "setCookies": [
        {
          "url": "https://example.com",
          "name": "auth_token",
          "value": "eyJhbGciOiJIUzI1NiIs...",
          "path": "/",
          "secure": true
        }
      ]
    },
    { "openNewTab": "https://example.com/dashboard" },
    { "waitForElement": ".user-name" },
    { "screenshot": "viewport" }
  ]
}

Example: Read and Save Cookies

{
  "actions": [
    { "openNewTab": "https://example.com/login" },
    { "fill": ["input[name=email]", "user@example.com"] },
    { "fill": ["input[name=password]", "password123"] },
    { "click": "button[type=submit]" },
    { "waitForElement": ".dashboard" },
    { "getCookies": "https://example.com" }
  ]
}