اگر تا به حال برای تست یک فرم لاگین ساده مجبور شده‌اید دستی مرورگر را باز کنید، کلیک کنید، پر کنید و دوباره تکرار کنید، Playwright آمده تا این کابوس را تمام کند. این ابزار مدرن مایکروسافت به شما اجازه می‌دهد با چند خط کد در پایتون یا جاوااسکریپت، کل سناریوی کاربر را در کروم، فایرفاکس و سافاری به صورت خودکار اجرا کنید، خطاها را قبل از کاربر پیدا کنید و تست‌ها را در CI به صورت موازی اجرا کنید — بدون دردسرهای قدیمی Selenium.

Playwright چیست و چرا از Selenium سریع‌تر است؟

Playwright یک فریم‌ورک متن‌باز برای تست خودکار مرورگر و اتوماسیون وب است که توسط مایکروسافت توسعه یافته و از یک پروتکل مدرن برای کنترل مستقیم مرورگر استفاده می‌کند. به همین دلیل تا چند برابر سریع‌تر، پایدارتر و بدون نیاز به WebDriver است و به صورت پیش‌فرض از Auto-wait، چند مرورگر و چند زبان پشتیبانی می‌کند. در ادامه نصب، اولین تست و ترفندهای حرفه‌ای آن را قدم‌به‌قدم می‌بینید.

Playwright چیست و چه تفاوتی با Selenium و Cypress دارد؟

قبل از کدنویسی، باید بدانید چرا تیم‌های بزرگ مثل VS Code، Bing و Adobe از Playwright استفاده می‌کنند. برخلاف Selenium که به WebDriver وابسته است و Cypress که فقط از کروم پشتیبانی می‌کرد، Playwright از ابتدا برای دنیای مدرن وب ساخته شده است.

معماری مدرن و سرعت اجرای خارق‌العاده

Playwright مستقیماً از طریق پروتکل DevTools و پچ‌های اختصاصی با موتور مرورگر صحبت می‌کند. نتیجه؟ اجرای تست‌ها تا ۲ تا ۳ برابر سریع‌تر، بدون Flaky بودن عجیب Selenium. دیگر لازم نیست برای هر کلیک sleep بگذارید؛ Playwright خودش صبر می‌کند تا المنت قابل تعامل شود.

Auto-wait هوشمند: قبل از هر کلیک یا تایپ، بررسی می‌کند که المنت دیده شود، فعال باشد و انیمیشن تمام شده باشد.
اجرای ایزوله با Browser Context: هر تست در یک Context جداگانه مثل یک پروفایل مرورگر تمیز اجرا می‌شود؛ بدون تداخل کوکی یا Local Storage.
پشتیبانی از شبکه: می‌توانید درخواست‌ها را شنود کنید، Mock کنید یا سرعت اینترنت کند را شبیه‌سازی کنید.

پشتیبانی از چند مرورگر و چند زبان به صورت هم‌زمان

یک کد، سه مرورگر. Playwright به صورت پیش‌فرض Chromium، Firefox و WebKit (موتور سافاری) را با یک API یکسان اجرا می‌کند. همچنین با یک دستور ساده بین جاوااسکریپت/تایپ‌اسکریپت، پایتون، جاوا و دات‌نت جابه‌جا شوید.

برای فرانت‌اندکارها: جاوااسکریپت و تایپ‌اسکریپت با بهترین پشتیبانی از VS Code.
برای پایتونی‌ها: سینتکس تمیز و هماهنگ با pytest.
برای تست روی موبایل: شبیه‌سازی آیفون و پیکسل با Viewport و User-Agent واقعی.

نصب و راه‌اندازی Playwright در ۲ دقیقه

نصب Playwright از نصب Selenium ساده‌تر است چون خودش مرورگرها را برایتان دانلود می‌کند و نیازی به ChromeDriver جداگانه ندارید.

نصب در جاوااسکریپت و تایپ‌اسکریپت

اگر پروژه‌تان Node.js است، فقط دو دستور کافی است:

npm init playwright@latest
# یا برای پروژه موجود
npm i -D @playwright/test
npx playwright install

دستور اول یک پروژه نمونه با فایل playwright.config.ts، پوشه tests و اسکریپت‌های آماده می‌سازد. در فایل کانفیگ می‌توانید مرورگرها، baseURL و تایم‌اوت را تنظیم کنید.

نصب در پایتون

برای پایتون، ترکیب Playwright با pytest محبوب‌ترین انتخاب است:

pip install playwright pytest-playwright
playwright install
# برای مرورگرهای خاص
playwright install chromium firefox webkit

بعد از نصب، پلاگین pytest به صورت خودکار فیکسچر page را در اختیار شما قرار می‌دهد و می‌توانید تست‌ها را با pytest --headed به صورت بصری ببینید.

نصب مرورگرها و اجرای اولین تست نمونه

بعد از playwright install سه مرورگر حدود ۴۰۰ مگابایت دانلود می‌شوند. برای اطمینان، یک تست سلامت اجرا کنید:

npx playwright test --project=chromium
pytest --headed

اگر همه چیز سبز شد، آماده‌اید. برای ادیتور حرفه‌ای‌تر، پیشنهاد می‌کنیم نگاهی به آموزش Cursor AI از صفر تا حرفه‌ای بیندازید تا کدنویسی تست‌ها را با هوش مصنوعی سریع‌تر کنید.

اولین تست E2E؛ از اسکریپت ساده تا اجرای واقعی

بهترین راه یادگیری، نوشتن یک سناریو واقعی است: باز کردن سایت، جستجو و بررسی نتیجه.

تست عنوان و کلیک با جاوااسکریپت

در فایل tests/example.spec.ts:

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

test('جستجو در سایت', async ({ page }) => {
await page.goto('https://example.com');
await expect(page).toHaveTitle(/Example/);
await page.getByRole('link', { name: 'More information' }).click();
await expect(page.getByRole('heading')).toContainText('Example');
});

نکات کلیدی:

getByRole به جای سلکتورهای شکننده مثل .btn-primary از نقش‌های دسترس‌پذیری استفاده می‌کند و تست را در برابر تغییرات CSS مقاوم می‌کند.
expect به صورت خودکار تا چند ثانیه صبر می‌کند؛ نیازی به waitForTimeout دستی نیست.
با npx playwright test --ui می‌توانید تست را در حالت UI Mode به صورت تعاملی دیباگ کنید.

همین تست با پایتون

در فایل test_example.py:

from playwright.sync_api import expect

def test_search(page):
page.goto("https://example.com")
expect(page).to_have_title("Example Domain")
page.get_by_role("link", name="More information").click()
expect(page.get_by_role("heading")).to_contain_text("Example")

یا به صورت async برای سرعت بیشتر:

import pytest
from playwright.async_api import expect

@pytest.mark.asyncio
async def test_search_async(page):
await page.goto("https://example.com")
await expect(page).to_have_title("Example Domain")

تفاوت sync و async در Playwright پایتون فقط در await است؛ API کاملاً یکسان است. برای پروژه‌های بزرگ، نسخه async با آموزش AsyncIO در پایتون ترکیب فوق‌العاده‌ای برای اجرای هم‌زمان تست‌های API می‌شود.

قابلیت‌های کلیدی که Playwright را متمایز می‌کند

اینجا جایی است که Playwright از بقیه جدا می‌شود و دیگر به Selenium برنمی‌گردید.

Auto-wait و Locators هوشمند

به جای driver.findElement(By.css) پر از باگ، از Locators نسل جدید استفاده کنید:

getByRole، getByText، getByLabel و getByPlaceholder برای کد خواناتر.
locator.filter() و locator.first() برای فیلتر کردن لیست‌ها.
همه Locators به صورت Lazy هستند و تا لحظه اجرا المنت را جستجو نمی‌کنند.

ضبط ویدیو، اسکرین‌شات و Trace Viewer

وقتی تست در CI فیل می‌شود، Trace Viewer نجات‌تان می‌دهد:

// playwright.config.ts
export default {
use: {
trace: 'on-first-retry',
video: 'retain-on-failure',
screenshot: 'only-on-failure'
}
}

با npx playwright show-trace trace.zip یک تایم‌لاین کامل می‌بینید: هر کلیک، هر درخواست شبکه، DOM قبل و بعد، و حتی کنسول لاگ. دیگر حدس نمی‌زنید چرا تست فیل شده.

تست API در کنار تست UI

نیازی به Postman جداگانه نیست. Playwright یک request داخلی دارد:

test('تست API لاگین', async ({ request }) => {
const res = await request.post('/api/login', {
data: { username: 'admin', password: '1234' }
});
expect(res.ok()).toBeTruthy();
const body = await res.json();
expect(body.token).toBeDefined();
});

می‌توانید اول با API کاربر بسازید، سپس با UI لاگین کنید و همه را در یک تست ترکیب کنید.

اجرای موازی و تست روی موبایل

به صورت پیش‌فرض Playwright تست‌ها را به صورت موازی در چند Worker اجرا می‌کند. برای موبایل کافی است در کانفیگ:

projects: [
{ name: 'Desktop Chrome', use: { ...devices['Desktop Chrome'] } },
{ name: 'iPhone 14', use: { ...devices['iPhone 14'] } },
{ name: 'Pixel 7', use: { ...devices['Pixel 7'] } }
]

یک تست، سه دستگاه، بدون کد اضافه.

جدول مقایسه Playwright با Selenium و Cypress

این جدول به شما کمک می‌کند سریع تصمیم بگیرید کدام ابزار برای پروژه‌تان مناسب‌تر است:

ویژگی	Playwright	Selenium	Cypress
سرعت اجرا	بسیار بالا، موازی پیش‌فرض	متوسط، نیاز به Selenium Grid	بالا ولی تک‌مرورگر
مرورگرها	Chromium، Firefox، WebKit	همه با WebDriver	کروم، اج، فایرفاکس محدود
زبان‌ها	JS/TS، Python، Java، C#	همه زبان‌های اصلی	فقط JS/TS
Auto-wait	دارد، هوشمند	ندارد، دستی	دارد ولی محدود
تست API	داخلی	خارجی (RestAssured)	دارد ولی جدا از UI
دیباگ	Trace Viewer، UI Mode، ویدیو	اسکرین‌شات دستی	Time Travel خوب
نصب	یک دستور، بدون درایور	نیاز به Driver جداگانه	یک دستور
مناسب برای	E2E مدرن، چندمرورگری	پروژه‌های قدیمی سازمانی	پروژه‌های فقط فرانت JS

بهترین شیوه‌ها برای تست‌های پایدار و قابل نگهداری

نوشتن تست آسان است؛ نگهداری آن سخت. این الگوها تست‌های شما را تمیز نگه می‌دارد.

استفاده از Page Object Model

لوکیترها را در کلاس جدا بگذارید:

class LoginPage {
constructor(private page) {}
username = this.page.getByLabel('نام کاربری');
password = this.page.getByLabel('رمز عبور');
submit = this.page.getByRole('button', { name: 'ورود' });
async login(user, pass) {
await this.username.fill(user);
await this.password.fill(pass);
await this.submit.click();
}
}

حالا اگر سلکتور تغییر کرد، فقط یک فایل را ویرایش می‌کنید.

تست‌های ایزوله و داده‌های مستقل

هر تست باید بتواند به تنهایی اجرا شود؛ وابستگی به ترتیب اجرا ممنوع.
برای داده از API یا فیکسچر استفاده کنید، نه از تست قبلی.
از test.beforeEach برای لاگین سریع با ذخیره storageState استفاده کنید تا هر بار لاگین UI نزنید.

دیباگ حرفه‌ای؛ وقتی تست‌ها Fail می‌شوند چه کنیم؟

سه ابزار طلایی Playwright برای دیباگ:

UI Mode: با npx playwright test --ui تست را قدم‌به‌قدم ببینید، Locators را تست کنید و تایم‌لاین را مشاهده کنید.
Playwright Inspector: با PWDEBUG=1 اجرا کنید تا قبل از هر خط متوقف شود و المنت را هایلایت ببینید.
Codegen: با npx playwright codegen https://example.com کارهای دستی شما در مرورگر به کد تبدیل می‌شود؛ عالی برای شروع سریع.

فراموش نکنید تست‌های ناپایدار را با expect.poll یا toPass برای شرایط ناپایدار پوشش دهید، نه با sleep کور.

اتصال به CI/CD؛ اجرای خودکار در گیت‌هاب

Playwright با GitHub Actions به خوبی هماهنگ است. کافی است در فایل .github/workflows/playwright.yml از اکشن رسمی استفاده کنید. نتیجه هر Push به صورت خودکار تست می‌شود و ویدیو و Trace در صورت خطا آرشیو می‌شود. اگر هنوز با پایپ‌لاین آشنا نیستید، آموزش GitHub Actions از صفر را بخوانید تا پایپ‌لاین CI/CD خود را برای پایتون و جاوااسکریپت بسازید و Playwright را در آن جا بدهید.

نتیجه‌گیری؛ آیا Playwright انتخاب نهایی شماست؟

اگر پروژه‌تان مدرن است، چند مرورگر را باید پوشش دهید، به تست API در کنار UI نیاز دارید و می‌خواهید تست‌ها سریع و پایدار باشند، Playwright بهترین انتخاب امروز است. برای پایتون‌کارها سینتکس تمیز و هماهنگ با pytest دارد و برای جاوااسکریپتی‌ها تجربه‌ای بی‌نقص با تایپ‌اسکریپت و UI Mode. نصب آن یک دقیقه‌ای است، Codegen شروع را آسان می‌کند و Trace Viewer دیباگ را لذت‌بخش. از امروز یک سناریو واقعی — حتی همین لاگین ساده — را با Playwright بنویسید و تفاوت سرعت و پایداری را خودتان مقایسه کنید.

سوالات متداول

آیا Playwright جایگزین کامل Selenium است؟

برای پروژه‌های جدید بله؛ Playwright سریع‌تر، پایدارتر و بدون نیاز به WebDriver است. اما اگر سازمان شما سال‌ها تست Selenium دارد و نیاز به پشتیبانی از مرورگرهای بسیار قدیمی دارید، مهاجرت تدریجی منطقی‌تر است و می‌توانید هر دو را مدتی کنار هم اجرا کنید.

برای شروع، جاوااسکریپت بهتر است یا پایتون؟

هر دو API کاملاً مشابهی دارند. اگر پروژه اصلی‌تان فرانت‌اند جاوااسکریپت است، نسخه JS/TS را انتخاب کنید تا با همان اکوسیستم بمانید. اگر بک‌اند یا دیتا با پایتون کار می‌کنید، نسخه پایتون با pytest ساده‌تر و هماهنگ‌تر با ابزارهای فعلی‌تان خواهد بود.

چطور تست‌های Playwright را سریع‌تر کنم؟

سه کار انجام دهید: ۱) Workerها را زیاد کنید (workers: 4 در کانفیگ)، ۲) لاگین را با storageState کش کنید تا هر تست دوباره لاگین نکند، ۳) درخواست‌های شبکه غیرضروری را با route مسدود کنید مثل فونت‌ها یا آنالیتیکس تا لود سریع‌تر شود.

آموزش Playwright از صفر تا حرفه‌ای؛ تست خودکار مرورگر با پایتون و جاوااسکریپت