Cookies

Read, set, delete, and clear browser cookies.

getCookies

Get all cookies for a URL.

Value: string (URL)

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

Returns:

{ "success": true, "data": [{ "name": "session", "value": "abc123", "domain": "example.com", ... }] }

Get all cookies in the browser:

[
	{ "getCookies": null }
]

Filter by cookie name:

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

Options

Option	Type	Default	Description
name	string	—	Return only cookies with this name
domain	string	—	Return only cookies for this domain

---

setCookies

Set one or more cookies.

Value: array of cookie objects

[
	{
		"setCookies": [
			{
				"url": "https://example.com",
				"name": "session",
				"value": "abc123"
			}
		]
	}
]

Cookie properties

Property	Type	Required	Description
url	string	yes	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
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 site, or all cookies in the browser.

Value: string (URL) | true

Clear cookies for a specific site:

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

Clear all cookies in the browser:

[
	{ "clearCookies": true }
]

Returns:

{ "success": true, "data": { "cleared": 3 } }

---

Example: Login with Pre-set Cookies

Inject an auth cookie before opening the page to skip the login form.

[
	{
		"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 Cookies After Login

Log in normally and then read back the cookies (e.g. to reuse in a later task).

[
	{ "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" }
]