Uh oh!
There was an error while loading. Please reload this page.
feat(locator): add drop API for files and clipboard-like data - #40283
Merged
Pavel Feldman (pavelfeldman) merged 1 commit intoApr 17, 2026
Merged
Conversation
Simulates an external OS/clipboard drag-and-drop of files and/or mime-typed string data onto a locator. Dispatches native DragEvents (dragenter, dragover, drop) with a DataTransfer constructed in the page's main world, so it works cross-browser and carries real file buffers — unlike the previous evaluateHandle + dispatchEvent workaround.
Contributor
Test results for "MCP"6096 passed, 976 skipped Merge workflow run. |
Yury Semikhatsky (yury-s)
approved these changes
Apr 17, 2026
| - `buffer` <[Buffer]> File content | ||
| ## drop-payload | ||
| - `payload` <[Object]> |
Contributor
Test results for "tests 1"6 flaky39242 passed, 847 skipped Merge workflow run. |
Uh oh!
There was an error while loading. Please reload this page.
| Dispatches the native `dragenter`, `dragover`, and `drop` events at the center of the | ||
| target element with a synthetic [DataTransfer] carrying the provided files and/or data | ||
| entries. Works cross-browser by constructing the [DataTransfer] in the page context. |
Collaborator
There was a problem hiding this comment.
Suggested change
| entries. Works cross-browser by constructing the [DataTransfer] in the page context. | |
| entries. |
| **Details** | ||
| Dispatches the native `dragenter`, `dragover`, and `drop` events at the center of the |
Collaborator
There was a problem hiding this comment.
at the center is wrong when position is passed. I'd recommend inside the target element instead.
| } | ||
| async _drop(progress: Progress, inputFileItems: InputFilesItems, data: { mimeType: string, value: string }[], options: types.PointerActionWaitOptions): Promise<'error:notconnected' | 'done'> { | ||
| const { filePayloads, localPaths } = inputFileItems; |
Collaborator
There was a problem hiding this comment.
Why don't we reuse prepareFilesForUpload?
| const disposeHandle = handle !== this; | ||
| try { | ||
| const result = await progress.race(handle.evaluate((node: Node, { payloads, data, point }) => { | ||
| if (!node.isConnected || node.nodeType !== 1 /* ELEMENT_NODE */) |
Collaborator
There was a problem hiding this comment.
Can we please extract this large evaluated function into InjectedScript.drop()?
Comment on lines
+666
to
+682
| if (localPaths && !filePayloads) { | ||
| // Co-located server/browser: read files into buffers so File objects can be | ||
| // constructed in page context. | ||
| payloads = await Promise.all(localPaths.map(async p => ({ | ||
| name: path.basename(p), | ||
| mimeType: mime.getType(p) || 'application/octet-stream', | ||
| buffer: (await fs.promises.readFile(p)).toString('base64'), | ||
| lastModifiedMs: (await fs.promises.stat(p)).mtimeMs, | ||
| }))); | ||
| } else { | ||
| payloads = (filePayloads ?? []).map(p => ({ | ||
| name: p.name, | ||
| mimeType: p.mimeType || 'application/octet-stream', | ||
| buffer: p.buffer, | ||
| lastModifiedMs: p.lastModifiedMs, | ||
| })); | ||
| } |
Collaborator
There was a problem hiding this comment.
Can we instead force prepareFilesForUpload to read files into payloads right away?
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
3 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.drop(payload, options?)that simulates an external OS/clipboard drop onto a target element, dispatching nativedragenter/dragover/dropevents with a realDataTransfer.payloadaccepts{ files?, data? }— files as paths orFilePayloadbuffers, data as a mime-type → string map.DataTransferin the page's main world so Firefox doesn't strip file content at the isolated-world boundary.dragoverhandler does not callpreventDefault().