[Docs]: Fix parameter name for element screenshots in browser_take_screenshot MCP Tool

[eduardonsm]

Page(s)

https://playwright.dev/mcp/tools/screenshots
https://playwright.dev/mcp/tools/screenshots#element-screenshot

Description

Summary

The documentation for browser_take_screenshot incorrectly lists ref as the parameter to capture a screenshot of a specific element. However, the actual JSON schema and implementation of @playwright/mcp expect the parameter name target.

Issue

When passing { ref: "e12" } as shown in the documentation, @playwright/mcp does not recognize ref, causing it to ignore the argument and default to capturing the full viewport instead of cropping to the specified element.

Proposed Changes

1. In the browser_take_screenshot parameters table, change ref to target:

Parameter	Type	Required	Description
type	string	no	png (default), jpeg, or webp
target	string	no	Exact target element reference (ref) from page snapshot or unique element selector
fullPage	boolean	no	Capture full scrollable page

2. Update the Element screenshot example:

You: Take a screenshot of just the login form.
→ browser_take_screenshot { target: "e12" }
→ Returns: PNG image cropped to the element

[scs0209]

I'd like to work on this. Planning to open a PR on microsoft/playwright.dev to update ref → target in mcp/tools/screenshots.mdx.

[dajiaohuang]

I created PR #2130 in the playwright.dev repository which fixes this documentation issue. The fix changes ref to target in both the parameter table and the example.

[EDWARD-012]

Related broader docs mismatch filed as #42539 (click/type/fill/drag still document ref while schemas require target).

I'll open a playwright.dev PR for those pages. Your screenshots-only PRs (#2129/#2130/#2131) remain the right fix for this issue — happy to leave screenshots.mdx to whichever of those lands, or include an identical change in the broader PR if maintainers prefer one combined docs PR.

[EDWARD-012]

Broader docs PR (includes screenshots + click/type/fill/drag pages): microsoft/playwright.dev#2132 — coordinates with the screenshots-only PRs on playwright.dev.