Uh oh!
There was an error while loading. Please reload this page.
feat(api): Locator.highlight({ style }) - #40215
Merged
Pavel Feldman (pavelfeldman) merged 1 commit intoApr 15, 2026
Merged
Conversation
Adds an optional `style` to `Locator.highlight()`:
- All languages: `style?: string` — raw CSS declaration body, e.g.
`"outline: 2px dashed red; background: rgba(0,0,0,0.1)"`.
- JS only (documented in `overrides.d.ts`): the same `style` also accepts
a React-style object, e.g. `{ backgroundColor: 'yellow', outline: '2px dashed red' }`.
Converted to a CSS string on the client.
Also exposes the option through:
- MCP `browser_highlight` as optional `style: string`.
- CLI `highlight <el> --style=...`.
On the injected side, the per-selector tracking map now carries
`{ selector, cssStyle? }` so styles survive the RAF loop and
re-adding the same selector with a new style updates in place.Yury Semikhatsky (yury-s)
approved these changes
Apr 14, 2026
| ### option: Locator.highlight.style | ||
| * since: v1.60 | ||
| - `style` <[string]> |
There was a problem hiding this comment.
in the code it can be an object
| async highlight() { | ||
| await this._frame._highlight(this._selector); | ||
| async highlight(options: { style?: string | Record<string, string | number> } = {}) { |
There was a problem hiding this comment.
without proper types, it's not very useful, I'd keep just string
Pavel Feldman (pavelfeldman)
merged commit Apr 15, 2026
15e92e1
into
microsoft:main
34 of 36 checks passed
Uh oh!
There was an error while loading. Please reload this page.
Contributor
Test results for "MCP"1 failed 6029 passed, 964 skipped Merge workflow run. |
Contributor
Test results for "tests 1"2 failed 4 flaky39165 passed, 847 skipped Merge workflow run. |
1 task
Yury Semikhatsky (yury-s) added a commit
to yury-s/playwright-java
that referenced
this pull request
May 6, 2026
Ports the following upstream client-side PRs: - microsoft/playwright#39767 - feat: Add `location()` to `WebError` - microsoft/playwright#39950 - feat: page version of toMatchAriaSnapshot - microsoft/playwright#40083 - feat(locator): add `description` option to getByRole - microsoft/playwright#40092 - feat(expect): support pseudo-element in toHaveCSS - microsoft/playwright#40159 - feat(tracing): add tracing.startHar / tracing.stopHar - microsoft/playwright#40196 - chore: remove deprecated `handle` option from exposeBinding - microsoft/playwright#40215 - feat(api): Locator.highlight({ style }) - microsoft/playwright#40219 - feat(api): Page.hideHighlight, Locator.hideHighlight, highlight() returns AutoCloseable - microsoft/playwright#40283 - feat(locator): add drop API for files and clipboard-like data - microsoft/playwright#40315 - feat(browser): Browser.onContext / offContext - microsoft/playwright#40341 - feat(browsercontext): mirror Page lifecycle events on BrowserContext - microsoft/playwright#40377 - feat(route): expose WebSocket subprotocols on WebSocketRoute - microsoft/playwright#40606 - feat(api): unify WebError and ConsoleMessage location - microsoft/playwright#40651 - docs: alias drop-payload Object types Protocol shape change for FrameExpectResult.received (now `{ value, ariaSnapshot }` instead of a bare SerializedValue) — updated AssertionsBase to unwrap it. Generator updates: added new types to relevant import lists; share topLevelTypes between the assertion and non-assertion generate runs so PseudoElement gets emitted into options/.
Yury Semikhatsky (yury-s) added a commit
to yury-s/playwright-java
that referenced
this pull request
May 6, 2026
Ports the following upstream client-side PRs: - microsoft/playwright#39767 - feat: Add `location()` to `WebError` - microsoft/playwright#39950 - feat: page version of toMatchAriaSnapshot - microsoft/playwright#40083 - feat(locator): add `description` option to getByRole - microsoft/playwright#40092 - feat(expect): support pseudo-element in toHaveCSS - microsoft/playwright#40159 - feat(tracing): add tracing.startHar / tracing.stopHar - microsoft/playwright#40196 - chore: remove deprecated `handle` option from exposeBinding - microsoft/playwright#40215 - feat(api): Locator.highlight({ style }) - microsoft/playwright#40219 - feat(api): Page.hideHighlight, Locator.hideHighlight, highlight() returns AutoCloseable - microsoft/playwright#40283 - feat(locator): add drop API for files and clipboard-like data - microsoft/playwright#40315 - feat(browser): Browser.onContext / offContext - microsoft/playwright#40341 - feat(browsercontext): mirror Page lifecycle events on BrowserContext - microsoft/playwright#40377 - feat(route): expose WebSocket subprotocols on WebSocketRoute - microsoft/playwright#40606 - feat(api): unify WebError and ConsoleMessage location - microsoft/playwright#40651 - docs: alias drop-payload Object types Protocol shape change for FrameExpectResult.received (now `{ value, ariaSnapshot }` instead of a bare SerializedValue) — updated AssertionsBase to unwrap it. Generator updates: added new types to relevant import lists; share topLevelTypes between the assertion and non-assertion generate runs so PseudoElement gets emitted into options/.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for freeto join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Locator.highlight({ style })— JS accepts a string or React-style object; other languages accept only a stringoverrides.d.ts; markdown documents the string formbrowser_highlightand CLIhighlight <el> --style{ selector, cssStyle? }so multiple highlights can have independent styles