Playwright File Upload and File Download in Java – Complete Guide with Practical Examples (2026)

Learning Path: RookieNerd Academy → Playwright with Java

Module: 10 – File Upload and File Download

Difficulty: Beginner to Intermediate

Estimated Reading Time: 25 Minutes

SEO Information

SEO Title

Playwright File Upload and File Download in Java – Complete Guide (2026)

Meta Description

Learn how to upload and download files in Playwright Java with practical examples. Master single file upload, multiple file uploads, download handling, verification, and best practices.

URL Slug

/academy/playwright/playwright-file-upload-download-java

Primary Keyword

Playwright File Upload Java

Secondary Keywords

• Playwright File Download Java

• Playwright Upload File

• Playwright Download File

• Playwright Java Tutorial

• Playwright Automation Examples

Learning Objectives

By the end of this tutorial, you will be able to:

• Upload a single file using Playwright.

• Upload multiple files.

• Handle file downloads.

• Save downloaded files to a custom location.

• Verify downloaded file names.

• Apply enterprise best practices for file operations.

Introduction

Uploading and downloading files are common user actions in web applications.

Examples include:

• Uploading a profile picture.

• Importing employee records from Excel.

• Uploading invoices in PDF format.

• Downloading reports.

• Exporting customer data to CSV.

• Downloading payment receipts.

A reliable automation framework should validate these workflows because they are often critical business functions.

Playwright provides built-in APIs for handling uploads and downloads without relying on operating system dialogs, making the automation simpler and more reliable.

How File Upload Works

Most websites use an HTML input element similar to:

<input type="file" id="resume">

Instead of opening the operating system's file chooser, Playwright directly assigns the file to the input element.

Uploading a Single File

page.locator("#resume")
    .setInputFiles(Paths.get("C:/TestData/resume.pdf"));

Playwright automatically uploads the specified file.

Uploading Multiple Files

Some applications allow multiple attachments.

Example:

page.locator("#documents")
    .setInputFiles(
        Paths.get("C:/TestData/id.pdf"),
        Paths.get("C:/TestData/address.pdf")
    );

This uploads both files in a single operation.

Clearing Uploaded Files

To remove previously selected files:

page.locator("#documents")
    .setInputFiles(new Path[0]);

This clears the file input.

Handling File Downloads

Suppose the application provides an Export Report button.

Playwright can wait for the download event.

Download download = page.waitForDownload(() -> {
    page.getByRole(
        AriaRole.BUTTON,
        new Page.GetByRoleOptions().setName("Export")
    ).click();
});

Once the download starts, Playwright returns a Download object.

Saving the Downloaded File

Example:

Path target = Paths.get("C:/Downloads/report.xlsx");

download.saveAs(target);

This stores the downloaded file in the desired folder.

Getting the Downloaded File Name

Sometimes the application generates dynamic file names.

Retrieve the suggested name:

System.out.println(download.suggestedFilename());

Example output:

EmployeeReport_July2026.xlsx

Verifying the Download

Example:

assert download.suggestedFilename().endsWith(".xlsx");

You can also verify:

• File extension

• File existence

• File size

• File contents (if required)

Real-World Example – Resume Upload

Imagine an online job portal.

Workflow:

1. Open the registration page.

2. Select Upload Resume.

3. Upload resume.pdf.

4. Submit the application.

5. Verify that a success message appears.

Example:

page.locator("#resume")
    .setInputFiles(Paths.get("C:/TestData/resume.pdf"));

page.getByRole(
    AriaRole.BUTTON,
    new Page.GetByRoleOptions().setName("Submit")
).click();

assertThat(page.locator(".success-message"))
    .hasText("Application submitted successfully");

Real-World Example – Report Download

Workflow:

1. Login.

2. Navigate to Reports.

3. Click Download Excel.

4. Save the file.

5. Verify the filename.

Download download = page.waitForDownload(() -> {
    page.locator("#downloadExcel").click();
});

download.saveAs(Paths.get("C:/Reports/Employee.xlsx"));

Common File Upload Scenarios

Enterprise applications often require uploading:

• Profile images

• Excel spreadsheets

• CSV files

• PDF documents

• ZIP archives

• XML files

Using setInputFiles() keeps these scenarios straightforward.

Best Practices

• Keep test files in a dedicated TestData folder.

• Use descriptive file names.

• Verify upload success with assertions.

• Save downloads to a temporary folder during test execution.

• Clean up downloaded files after the test if appropriate.

Common Mistakes

Using Operating System Automation

Avoid automating native file chooser dialogs with external tools when Playwright's APIs are sufficient.

Hard-Coding File Paths

Instead of embedding absolute paths, consider using project-relative paths to make tests portable across environments.

Skipping Verification

Uploading a file is only part of the test. Always verify the expected outcome, such as a confirmation message or successful download.

Practice Exercise

Create a Playwright script that:

1. Opens a sample upload page.

2. Uploads an image.

3. Verifies the success message.

4. Downloads a sample report.

5. Saves it to a local folder.

6. Prints the downloaded file name.

Interview Questions

1. How do you upload a file in Playwright Java?

2. What is the purpose of setInputFiles()?

3. How do you upload multiple files?

4. How do you handle file downloads?

5. What does waitForDownload() do?

6. How do you save a downloaded file to a custom location?

7. How would you verify a successful file download?

FAQs

Does Playwright support native file upload dialogs?

Playwright typically bypasses the dialog by interacting directly with the file input element using setInputFiles().

Can I upload multiple files?

Yes. Pass multiple file paths to setInputFiles().

Can Playwright rename downloaded files?

Playwright doesn't rename the server-generated file automatically, but you can save it with a different name using saveAs().

How can I verify that a download completed?

Use waitForDownload(), save the file, and then verify its presence or filename.

Summary

In this lesson, you learned:

• How to upload files.

• How to upload multiple files.

• How to clear uploaded files.

• How to handle downloads.

• How to save downloaded files.

• Best practices for testing upload and download functionality.

File operations are common in enterprise systems such as HR portals, banking applications, insurance platforms, and e-commerce systems. Mastering these techniques will help you automate many real-world workflows with confidence.

Related Tutorials

• Playwright Browser Context in Java

• Playwright Multiple Tabs and Windows

• Playwright Frames and iFrames

• Playwright Auto Waiting

Next Lesson

➡ Playwright Screenshots in Java – Capture Full Page, Element, and Failure Screenshots

Suggested Screenshots

1. File upload form before selecting a file.

2. Successful file upload confirmation.

3. Browser download prompt (or application download action).

4. Downloaded file in the destination folder.

5. Project structure showing the TestData directory.

6. Flow diagram: Upload → Verify → Download → Validate.