Skip to content

Playwright is a framework for Web Testing and Automation. It allows testing Chromium, Firefox and WebKit with a single API.

feat(mcp): delete cookies by domain and path (#43319)

Pavel Feldman2ba2ff761d97
diff --git a/packages/playwright-core/src/tools/backend/cookies.ts b/packages/playwright-core/src/tools/backend/cookies.ts
index fb9fd95f82..f569e6a90e 100644
--- a/packages/playwright-core/src/tools/backend/cookies.ts
+++ b/packages/playwright-core/src/tools/backend/cookies.ts
@@ -128,17 +128,21 @@ const cookieDelete = defineTool({
schema: {
name: 'browser_cookie_delete',
title: 'Delete cookie',
- description: 'Delete a specific cookie',
+ description: 'Delete a specific cookie (optionally only on a given domain/path)',
inputSchema: z.object({
name: z.string().describe('Cookie name to delete'),
+ domain: z.string().optional().describe('Only delete the cookie on this domain'),
+ path: z.string().optional().describe('Only delete the cookie on this path'),
}),
type: 'action',
},
handle: async (context, params, response) => {
const browserContext = await context.currentBrowserContext();
- await browserContext.clearCookies({ name: params.name });
- response.addCode(`await page.context().clearCookies({ name: ${escapeWithQuotes(params.name)} });`);
+ const filter = { name: params.name, domain: params.domain, path: params.path };
+ await browserContext.clearCookies(filter);
+ const options = Object.entries(filter).filter(([, value]) => value !== undefined).map(([key, value]) => `${key}: ${escapeWithQuotes(value!)}`);
+ response.addCode(`await page.context().clearCookies({ ${options.join(', ')} });`);
},
});
diff --git a/packages/playwright-core/src/tools/cli-daemon/commands.ts b/packages/playwright-core/src/tools/cli-daemon/commands.ts
index 4c42b81696..b0dfb347e2 100644
--- a/packages/playwright-core/src/tools/cli-daemon/commands.ts
+++ b/packages/playwright-core/src/tools/cli-daemon/commands.ts
@@ -713,13 +713,17 @@ const cookieSet = declareCommand({
const cookieDelete = declareCommand({
name: 'cookie-delete',
- description: 'Delete a specific cookie',
+ description: 'Delete a specific cookie (optionally only on a given domain/path)',
category: 'storage',
args: z.object({
name: z.string().describe('Cookie name'),
}),
+ options: z.object({
+ domain: z.string().optional().describe('Only delete the cookie on this domain'),
+ path: z.string().optional().describe('Only delete the cookie on this path'),
+ }),
toolName: 'browser_cookie_delete',
- toolParams: ({ name }) => ({ name }),
+ toolParams: ({ name, domain, path }) => ({ name, domain, path }),
});
const cookieClear = declareCommand({
diff --git a/packages/playwright-core/src/tools/skills/playwright-cli/references/storage-state.md b/packages/playwright-core/src/tools/skills/playwright-cli/references/storage-state.md
index bb5021a090..e2390da8da 100644
--- a/packages/playwright-core/src/tools/skills/playwright-cli/references/storage-state.md
+++ b/packages/playwright-core/src/tools/skills/playwright-cli/references/storage-state.md
@@ -99,6 +99,9 @@ playwright-cli cookie-set remember_me token123 --expires=1893456000
```bash
playwright-cli cookie-delete session_id
+
+# Only on one domain, other domains keep their session_id
+playwright-cli cookie-delete session_id --domain=example.com
```
### Clear All Cookies
diff --git a/tests/mcp/cookies.spec.ts b/tests/mcp/cookies.spec.ts
index 26bb7ef04c..0bb1dbabf0 100644
--- a/tests/mcp/cookies.spec.ts
+++ b/tests/mcp/cookies.spec.ts
@@ -252,6 +252,26 @@ test('browser_cookie_delete removes cookie', async ({ startClient, server }) =>
expect(afterDelete).toHaveResponse({
result: expect.stringContaining('not found'),
});
+
+ // Domain and path narrow it down to one of the same-named cookies.
+ for (const domain of ['a.example', 'b.example']) {
+ await client.callTool({
+ name: 'browser_cookie_set',
+ arguments: { name: 'session', value: domain, domain },
+ });
+ }
+ expect(await client.callTool({
+ name: 'browser_cookie_delete',
+ arguments: { name: 'session', domain: 'a.example', path: '/' },
+ })).toHaveResponse({
+ code: `await page.context().clearCookies({ name: 'session', domain: 'a.example', path: '/' });`,
+ });
+ expect(await client.callTool({
+ name: 'browser_cookie_get',
+ arguments: { name: 'session' },
+ })).toHaveResponse({
+ result: expect.stringContaining('session=b.example (domain: b.example'),
+ });
});
test('browser_cookie_delete for nonexistent cookie does not error', async ({ startClient, server }) => {