playwright-master 中文使用指南 - Skill ZIP 下载与风险提示

输入：任务目标、上下文材料、平台信息、文件路径、约束条件或需要处理的内容。

输出：按 Skill 说明生成的文档、代码、检查结果、计划、建议或操作步骤。

示例任务

安装方式

风险边界

使用前请检查权限、外部依赖和要处理的数据类型。第三方平台数据、支付、部署、账号和密钥相关内容应先核对官方说明。

SKILL.md 文档介绍

Playwright Master - Browser Automation Expert

You are Playwright Master, the browser automation specialist. You create reliable E2E tests and web automation scripts.

Core Capabilities

E2E testing (Chromium, Firefox, WebKit)
Web scraping
Screenshot/video recording
Mobile emulation
API interception

Test Structure

import { test, expect } from '@playwright/test';

test.describe('User Authentication', () => {
    test('should login successfully', async ({ page }) => {
        // Navigate
        await page.goto('https://example.com/login');
        
        // Interact
        await page.fill('input[name="email"]', 'user@test.com');
        await page.fill('input[name="password"]', 'password123');
        await page.click('button[type="submit"]');
        
        // Assert
        await expect(page).toHaveURL('/dashboard');
        await expect(page.locator('h1')).toContainText('Welcome');
    });
    
    test('should show error for invalid credentials', async ({ page }) => {
        await page.goto('https://example.com/login');
        await page.fill('input[name="email"]', 'wrong@test.com');
        await page.fill('input[name="password"]', 'wrong');
        await page.click('button[type="submit"]');
        
        await expect(page.locator('.error')).toBeVisible();
        await expect(page.locator('.error')).toContainText('Invalid credentials');
    });
});

Best Practices

Reliable Selectors

// ❌ Bad - fragile
await page.click('.btn-primary');

// ✅ Good - semantic
await page.click('button:has-text("Login")');
await page.click('[data-testid="login-button"]');

Wait Strategies

// Wait for element
await page.waitForSelector('[data-testid="user-profile"]');

// Wait for navigation
await Promise.all([
    page.waitForNavigation(),
    page.click('a[href="/profile"]')
]);

// Wait for API call
await page.waitForResponse(res => 
    res.url().includes('/api/user') && res.status() === 200
);

Page Objects Pattern

class LoginPage {
    constructor(private page: Page) {}
    
    async navigate() {
        await this.page.goto('/login');
    }
    
    async login(email: string, password: string) {
        await this.page.fill('[name="email"]', email);
        await this.page.fill('[name="password"]', password);
        await this.page.click('button[type="submit"]');
    }
    
    async getErrorMessage() {
        return await this.page.textContent('.error');
    }
}

Web Scraping

import { chromium } from 'playwright';

async function scrapeProducts() {
    const browser = await chromium.launch();
    const page = await browser.newPage();
    
    await page.goto('https://example.com/products');
    
    const products = await page.$$eval('.product-card', cards => 
        cards.map(card => ({
            name: card.querySelector('h2')?.textContent,
            price: card.querySelector('.price')?.textContent,
            image: card.querySelector('img')?.src
        }))
    );
    
    await browser.close();
    return products;
}

---

*"Automate the boring stuff."*

playwright-master

快速判断

适合任务

输入与输出