alirezarezvani/claude-skills / engineering-team/playwright-pro/skills/pw
pw
VerifiedUse for any Playwright or end-to-end browser testing work: writing tests, fixing flaky ones, migrating from Cypress or Selenium, CI setup, TestRail or BrowserStack. Routes to the matching /pw sub-skill and its 55 templates.
templates/forms/file-upload.md
View on GitHub# File Upload Template
Tests single file, multiple files, drag-and-drop, and upload progress.
## Prerequisites
- Authenticated session via `{{authStorageStatePath}}`
- Test files available: `{{testFilePath}}`, `{{largeFilePath}}`
- Accepted types: `{{acceptedMimeTypes}}` (e.g. image/jpeg, application/pdf)
- Max file size: `{{maxFileSizeMb}}` MB
---
## TypeScript
```typescript
import { test, expect } from '@playwright/test';
import path from 'path';
const testFile = path.resolve('{{testFilePath}}');
const largeFile = path.resolve('{{largeFilePath}}');
test.describe('File Upload', () => {
test.use({ storageState: '{{authStorageStatePath}}' });
test.beforeEach(async ({ page }) => {
await page.goto('{{baseUrl}}/{{uploadPath}}');
});
// Happy path: single file upload
test('uploads a single file successfully', async ({ page }) => {
await page.getByRole('button', { name: /choose file|browse/i }).setInputFiles(testFile);
await expect(page.getByText(/{{testFileName}}/)).toBeVisible();
await page.getByRole('button', { name: /upload/i }).click();
await expect(page.getByRole('progressbar')).toBeVisible();
await expect(page.getByRole('alert')).toContainText(/upload.*complete|uploaded successfully/i);
});
// Happy path: multiple files
test('uploads multiple files', async ({ page }) => {
const input = page.getByRole('button', { name: /choose file|browse/i });
await input.setInputFiles([testFile, testFile]);
await expect(page.getByText(/2 files?|{{testFileName}}/i)).toBeVisible();
await page.getByRole('button', { name: /upload/i }).click();
await expect(page.getByRole('alert')).toContainText(/2.*uploaded/i);
});
// Happy path: drag and drop
test('uploads file via drag and drop', async ({ page }) => {
const dropzone = page.getByRole('region', { name: /drop.*files|drag.*here/i });
await expect(dropzone).toBeVisible();
// Use DataTransfer to simulate drag-drop
const dataTransfer = await page.evaluateHandle(() => new DataTransfer());
await dropzone.dispatchEvent('drop', { dataTransfer });
// Alternatively, use setInputFiles on the hidden input if dropzone wraps one
await page.locator('input[type="file"]').setInputFiles(testFile);
await expect(page.getByText(/{{testFileName}}/)).toBeVisible();
});
// Happy path: remove file from queue before upload
test('removes file from queue', async ({ page }) => {
await page.locator('input[type="file"]').setInputFiles(testFile);
await page.getByRole('button', { name: /remove.*{{testFileName}}|×/i }).click();
await expect(page.getByText(/{{testFileName}}/)).toBeHidden();
});
// Error case: file too large
test('shows error for oversized file', async ({ page }) => {
await page.locator('input[type="file"]').setInputFiles(largeFile);
await expect(page.getByText(/too large|exceeds.*{{maxFileSizeMb}}|max.*size/i)).toBeVisible();
});
// Error case: wrong file type
test('shows error for unsupported file type', async ({ page }) => {
const wrongTypeFile = { name: 'test.exe', mimeType: 'application/octet-stream', buffer: Buffer.from('data') };
await page.locator('input[type="file"]').setInputFiles(wrongTypeFile);
await expect(page.getByText(/unsupported.*type|{{acceptedMimeTypes}}.*only/i)).toBeVisible();
});
// Edge case: upload progress shown and completed
test('shows progress bar during upload', async ({ page }) => {
await page.locator('input[type="file"]').setInputFiles(testFile);
await page.getByRole('button', { name: /upload/i }).click();
const progress = page.getByRole('progressbar');
await expect(progress).toBeVisible();
await expect(progress).toBeHidden(); // completes and hides
});
});
```
---
## JavaScript
```javascript
const { test, expect } = require('@playwright/test');
const path = require('path');
test.describe('File Upload', () => {
test.use({ storageState: '{{authStorageStatePath}}' });
test.beforeEach(async ({ page }) => {
await page.goto('{{baseUrl}}/{{uploadPath}}');
});
test('uploads single file', async ({ page }) => {
await page.locator('input[type="file"]').setInputFiles('{{testFilePath}}');
await page.getByRole('button', { name: /upload/i }).click();
await expect(page.getByRole('alert')).toContainText(/uploaded successfully/i);
});
test('shows error for oversized file', async ({ page }) => {
await page.locator('input[type="file"]').setInputFiles('{{largeFilePath}}');
await expect(page.getByText(/too large|exceeds/i)).toBeVisible();
});
test('shows error for wrong file type', async ({ page }) => {
await page.locator('input[type="file"]').setInputFiles({
name: 'bad.exe',
mimeType: 'application/octet-stream',
buffer: Buffer.from('x'),
});
await expect(page.getByText(/unsupported.*type/i)).toBeVisible();
});
});
```
## Variants
| Variant | Description |
|---------|-------------|
| Single file | File picker → upload → success |
| Multiple files | Two files queued and uploaded |
| Drag-and-drop | Drop event populates queue |
| Remove from queue | File removed before upload |
| Oversized | Error shown, upload blocked |
| Wrong type | Mime-type error shown |
| Progress bar | Progressbar visible during upload |
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the work | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixes | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation code | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |