সরাসরি পর্বে যান
পর্ব ৩৬ · ৮২-এর মধ্যে · মডিউল ৬

Playwright-এর মূল — locator, auto-wait আর assertion

Playwright Basics — Locators, Auto-waiting and Web-first Assertions

Taught in Bangla, this lesson sets up pytest-playwright with the Edge channel and explains browser, context and page. It writes locators with get_by_role, get_by_label and get_by_test_id under strict mode, and shows auto-waiting: in a real run a second click on a busy button waits about 830 ms. Web-first assertions poll for up to five seconds where an immediate inner_text() read fails. A full checkout test on the Bazarghar demo shop catches a seeded coupon bug, and codegen and headed debugging are covered.

এই পর্বে যা শিখবেন

  • Playwright-এর গঠন: Python test, driver process, browser, context আর page কে কার সাথে কথা বলে
  • pytest-playwright-এর fixture (page, browser_context_args, base_url), Edge channel আর headless বনাম headed
  • Role, label, text আর test id দিয়ে locator লেখা, আর strict mode কেন বন্ধু
  • Auto-waiting আর actionability check, web-first assertion-এর polling, আর sleep কেন ভুল
  • Navigation, screenshot, codegen, আর বাজারঘরের checkout-এর পুরো একটি test যা একটি বসানো bug ধরে

১ · Playwright কী — browser, context আর page

বাজারঘরের একজন নতুন tester-এর প্রতিদিনের কাজ ভাবুন। সকালে নতুন build এলো। তিনি ব্রাউজার খোলেন, লগইন করেন, “তেল” খোঁজেন, সয়াবিন তেল cart-এ দেন, checkout-এ গিয়ে মোট টাকা মেলান। কাজটি দশ মিনিটের। কিন্তু দিনে তিনবার build এলে, আর প্রতিবার ২০টি এমন যাত্রা থাকলে, পুরো দিন এতেই যায়। আর ক্লান্ত চোখ পঞ্চাশতম বারে ১০৬০ আর ৯৬০-এর পার্থক্য চোখ এড়িয়ে যেতে পারে।

UI automation এই একঘেয়ে অংশটি program-কে দেয়। Playwright হলো এমন একটি browser automation টুল: আপনার code একটি আসল browser চালায়, পাতা খোলে, লেখে, click করে, আর পাতায় যা দেখা যাচ্ছে তা যাচাই করে। একে বলে end-to-end test, কারণ request ব্রাউজার থেকে server হয়ে ডাটাবেস পর্যন্ত যায় আর ফিরে আসে, ঠিক যেমন ব্যবহারকারীর ক্ষেত্রে হয়। পর্ব ০৫-এ দেখেছেন, এই ধরনের test পিরামিডের চূড়ায়: দামী, ধীর, কিন্তু একমাত্র এরাই প্রমাণ করে যে পুরো দোকানটি সত্যিই চলে।

Playwright-এর পরিচয় আগে দুটি কোর্সে এসেছে: JavaScript প্রোগ্রামিং কোর্সের পর্ব ৪৮-এ প্রথম স্বাদ, আর Full-Stack কোর্সের পর্ব ৭৬-এ TypeScript-এ একটি developer-এর দৃষ্টিতে। এই পর্বে আমরা tester-এর দৃষ্টিতে Python-এ যাব, আর ভেতরের কলকবজা আরও গভীরে দেখব: কখন কী অপেক্ষা করে, কতবার দেখে, আর ব্যর্থ হলে বার্তা কেমন দেখায়। Locator-এর পেছনের DOM আর CSS selector-এর বিস্তারিত পর্ব ৩৫ (Automation-এর জন্য web — DOM, CSS selector, XPath আর ভালো locator)-এর বিষয়।

তিনটি স্তর

একটি শপিং মলের কথা ভাবুন। Browser হলো পুরো মল ভবন: চালু করতে সময় লাগে, একবার খুললে সারাদিন খোলা। Browser context হলো মলের ভেতরে একটি আলাদা দোকান, যার নিজের তালা, নিজের খাতা: এক দোকানের হিসাব আরেক দোকান দেখে না। Page হলো সেই দোকানের একটি কাউন্টার। মিতুর cart এক দোকানে, রাফির cart আরেক দোকানে, একই ভবনে, কিন্তু কেউ কারও cookie দেখে না।

Browser context হলো নতুন একটি incognito জানালার মতো: নিজের cookie, localStorage আর cache. নতুন context বানাতে কয়েক মিলিসেকেন্ড লাগে, নতুন browser খুলতে লাগে অনেক বেশি। তাই pytest-playwright পুরো test session-এ একটি browser রাখে, কিন্তু প্রতিটি test-কে দেয় নতুন context আর নতুন page. ফলে আগের test-এর login বা cart পরের test-এ চুইয়ে আসে না: এটিই test isolation, যা পর্ব ২৩-এ fixture-এর আলোচনায় এসেছিল।

একটি Playwright test কীভাবে browser চালায়

Python test → Playwright driver → Edge → context → page → বাজারঘর app

pytest → Playwright driver → Edge → context → page → বাজারঘর app pytest · test_*.py Python-এর playwright library page.get_by_role(…).click() Playwright driver আলাদা Node.js process, pipe-এ কথা pipe CDP Edge (browser) · headless context ১ মিতুর cookie context ২ খালি, নতুন page /products/3 page /checkout বাজারঘর app FastAPI · 127.0.0.1:8792 HTML পাতা + JSON API + SQLite
ছবি ৩৬.১ — Python test নিজে browser ছোঁয় না; একটি driver process-কে নির্দেশ পাঠায়। Driver Edge-কে চালায়, আর প্রতিটি test পায় নিজের context ও page.

ছবির মাঝের স্তরটি অনেকে জানেন না। আপনি pip install playwright করলে সাথে একটি Node.js-ভিত্তিক driver আসে। Python code প্রতিটি নির্দেশ (যেমন “এই locator-এ click”) একটি pipe দিয়ে driver-কে পাঠায়; driver সেটি browser-এর নিজের ভাষায় অনুবাদ করে। Chromium-ভিত্তিক browser (Chrome, Edge)-এর ক্ষেত্রে সেই ভাষা Chrome DevTools Protocol (CDP). এজন্যই Python, Java, .NET আর TypeScript-এর Playwright একই আচরণ করে: অপেক্ষা আর যাচাইয়ের আসল যুক্তি থাকে driver-এ, একবারই লেখা। Selenium অন্য পথে হাঁটে, W3C WebDriver নামের মানদণ্ড ধরে; সেই তুলনা পর্ব ৩৮ (Selenium WebDriver)-এ।

Microsoft ২০২০ সালে Playwright প্রকাশ করে; দলের কয়েকজন আগে Google-এ Puppeteer (২০১৭, Chrome চালানোর Node library) বানানোর কাজে ছিলেন বলে বহুল প্রচলিত তথ্য। Puppeteer শুধু Chromium চালাত; Playwright শুরু থেকেই Chromium, Firefox আর WebKit তিনটির জন্য একই API দিতে চেয়েছে। তার আগের দুই দশক UI automation মানেই ছিল Selenium, যার শুরু ২০০৪ সালে ThoughtWorks-এ Jason Huggins-এর একটি ভেতরের টুল হিসেবে। Python-এর package পরে এসেছে, একই driver-এর ওপর।

২ · প্রথম প্রকল্প — pytest-playwright, Edge আর fixture

নিচের সব কিছু এই কোর্স লেখার সময় একটি সাধারণ Windows ডেস্কটপে সত্যিকারভাবে চালানো হয়েছে। App হলো কোর্সের বাজারঘর (শুধু 127.0.0.1-এ চলে, বাইরে কোনো network call করে না)। Test প্রকল্পে library দুটি: playwright 1.65.2 (Apache-2.0; ভেতরের driver 1.65.1) আর pytest-playwright 0.10.0 (Apache-2.0), সাথে pytest 9.2.0 (MIT). Browser হলো কম্পিউটারে আগে থেকে থাকা Microsoft Edge 157, headless. তাই Playwright-এর নিজের browser download করতে হয়নি। সতর্কতা হিসেবে run-এর আগে DO_NOT_TRACK=1 রাখা হয়েছিল। Path নিরপেক্ষ করা।

# টার্মিনাল ১: app, test mode-এ, নতুন seed
cd bazarghar
BAZARGHAR_TEST_MODE=1 uv run bazarghar --port 8792 --test-mode --reset

# টার্মিনাল ২: UI test প্রকল্প
mkdir bazarghar-ui-tests && cd bazarghar-ui-tests
uv init --vcs none --author-from none
uv add pytest-playwright
uv run pytest -v

Edge না থাকলে uv run playwright install chromium দিয়ে Playwright-এর নিজের Chromium নামানো যায়। কোন browser চলবে, তা বলা থাকে pyproject.toml-এ, যাতে প্রতিবার command-এ লিখতে না হয়:

[tool.pytest.ini_options]
testpaths = ["tests"]
addopts = "--browser-channel=msedge --base-url=http://127.0.0.1:8792"

--browser-channel=msedge মানে “Chromium engine, কিন্তু installed Edge ব্যবহার করুন”; একে বলে browser channel. --base-url থাকায় test-এ শুধু page.goto("/products/1") লিখলেই চলে, আর staging-এ চালাতে শুধু এই একটি মান বদলায়। এবার conftest.py:

import urllib.request

import pytest
from playwright.sync_api import Page, expect


@pytest.fixture(autouse=True)
def fresh_data(base_url):
    req = urllib.request.Request(base_url + "/api/test/reset", method="POST")
    with urllib.request.urlopen(req, timeout=5) as r:      # seed data back
        assert r.status == 200
    yield


@pytest.fixture(scope="session")
def browser_context_args(browser_context_args):
    return {**browser_context_args, "locale": "bn-BD",
            "viewport": {"width": 1280, "height": 800}}


@pytest.fixture
def login(page: Page):
    def _login(user: str):
        page.goto("/login")
        page.get_by_label("ইমেইল").fill(f"{user}@bazarghar.test")
        page.get_by_label("পাসওয়ার্ড").fill(f"{user}1234")
        page.get_by_role("button", name="লগইন করুন").click()
        expect(page.get_by_test_id("flash")).to_have_text(
            "স্বাগতম! আপনি লগইন করেছেন।")
    return _login

Plugin যা দেয়: pytest-playwright নিজে কয়েকটি fixture দেয়: browser (session scope, একবার খোলে), context আর page (প্রতিটি test-এ নতুন), আর base_url. Test-এর parameter-এ page লিখলেই একটি খোলা, খালি tab পাওয়া যায়; test শেষে context বন্ধ হয়।

browser_context_args: প্রতিটি নতুন context কী নিয়ম নিয়ে খুলবে, তা এখানে বদলানো যায়। আমরা plugin-এর নিজের মান (**browser_context_args) রেখে তার ওপর ভাষা bn-BD আর একটি নির্দিষ্ট পর্দার মাপ বসিয়েছি। নির্দিষ্ট মাপ থাকলে screenshot আর layout প্রতিবার একই হয়।

fresh_data আর login: প্রথমটি পর্ব ৩১-এর মতো প্রতিটি test-এর আগে seed ফিরিয়ে আনে, তাই নতুন অর্ডার সবসময় id 8 পায়। দ্বিতীয়টি একটি factory fixture, যা UI দিয়ে login করে আর স্বাগত বার্তা দেখা পর্যন্ত অপেক্ষা করে। প্রতিটি test-এ UI দিয়ে login ধীর; একবার login করে state আবার ব্যবহারের কৌশল পর্ব ৩৭ (Playwright গভীরে)-এর বিষয়।

Headless আর headed

Headless মানে পর্দায় কোনো জানালা না খুলে browser চালানো: CI server-এ পর্দাই নেই, আর আপনার কাজের সময় হঠাৎ জানালা লাফিয়ে উঠুক তা কেউ চান না। pytest-playwright-এর default headless. Test লেখার সময় চোখে দেখতে চাইলে --headed, আর ধীরে দেখতে --slowmo=500 (প্রতিটি কাজের মাঝে ৫০০ ms বিরতি)। এই পর্বের সব run headless; ভাবনার প্রশ্ন ৩-এ দেখবেন headless আর headed-এর পার্থক্য কতটা বাস্তব।

প্রথম দুটি test

import re

from playwright.sync_api import Page, expect


def test_search_finds_two_oils(page: Page):
    page.goto("/")
    page.get_by_role("searchbox", name="পণ্য খুঁজুন").fill("তেল")
    page.get_by_role("button", name="খুঁজুন").click()
    expect(page).to_have_url(re.compile(r"/\?q="))
    expect(page.get_by_test_id("result-count")).to_have_text(
        "2টি পণ্য পাওয়া গেছে")
    expect(page.get_by_test_id("product-card")).to_have_count(2)


def test_rice_average_is_rounded_half_up(page: Page):
    page.goto("/products/1")
    expect(page.get_by_role("heading", level=1)).to_have_text(
        "মিনিকেট চাল ৫ কেজি")
    expect(page.get_by_test_id("rating-average")).to_have_text("4.3")
    expect(page.get_by_test_id("rating-count")).to_have_text("4")
    page.screenshot(path="screenshots/rice.png")

দ্বিতীয় test-টি পর্ব ১৫-এর AC5 যাচাই করে: চালের চারটি রিভিউ ৪, ৪, ৫, ৪, গড় ৪.২৫, আর নিয়মে half up, তাই পাতায় “4.3” দেখানোর কথা, banker's rounding-এর “4.2” নয়। API-তে এই হিসাব পর্ব ৩১-এ যাচাই হয়েছে; UI test যাচাই করে যে template-ও সঠিক field দেখায়। একই নিয়ম দুই স্তরে, দুই কারণে।

৩ · Locator — ব্যবহারকারী যেভাবে খোঁজেন

বাজারে দোকানিকে আপনি বলেন না “তৃতীয় তাকের বাঁ দিক থেকে সপ্তম বস্তা”। বলেন “মিনিকেট চালের ৫ কেজির বস্তাটা”। তাক বদলালেও কথাটি সত্য থাকে। Locator-ও তেমন হওয়া উচিত: পাতার গঠনের ওপর নয়, পাতার অর্থের ওপর দাঁড়ানো।

Playwright-এর locator একটি বর্ণনা, খুঁজে পাওয়া element নয়। page.get_by_role("button", name="খুঁজুন") লিখলে তখনই কিছু খোঁজা হয় না; যতবার এর ওপর কাজ বা assertion হয়, ততবার নতুন করে পাতায় খোঁজে। তাই পাতা নতুন করে আঁকা হলেও পুরোনো locator কাজ করে, পুরোনো element-এর “stale” সমস্যা হয় না।

Locatorবাজারঘরে উদাহরণকখন
get_by_role("button", name="অর্ডার করুন")প্রথম পছন্দ: বোতাম, link, heading, checkbox
get_by_label("মোবাইল নম্বর")form-এর ঘর, যার label আছে
get_by_text("স্টক নেই")লেখা যা ব্যবহারকারী পড়েন, বোতাম নয়
get_by_placeholder("চাল, ডাল, তেল…")label নেই এমন ঘর (দুর্বল বিকল্প)
get_by_test_id("cart-count")অর্থবোধক role বা লেখা নেই, যেমন একটি সংখ্যা
locator("css=…")("ul.grid > li:nth-child(3)")শেষ উপায়; গঠন বদলালেই ভাঙে

get_by_role খোঁজে ARIA role আর accessible name দিয়ে: screen reader যে নামে একটি বোতাম পড়ে শোনায়, সেই নাম। এর একটি বড় পার্শ্বলাভ আছে। বাজারঘরে a11y_missing_label নামের একটি বসানো ভুল আছে: header-এর খোঁজার ঘর থেকে <label> হারিয়ে যায়। দেখতে পাতা একই, কিন্তু screen reader ব্যবহারকারী আর জানেন না ঘরটি কীসের। সেই build-এ আমাদের search test চালানো হলো, সত্যিকারের আউটপুট (path ছাঁটা):

$ uv run pytest -q --tb=line tests/test_browse.py     # app: --bugs a11y_missing_label
F.                                                                       [100%]
E   playwright._impl._errors.TimeoutError: Locator.fill: Timeout 30000ms exceeded.
    Call log:
      - waiting for get_by_role("searchbox", name="পণ্য খুঁজুন")
FAILED tests/test_browse.py::test_search_finds_two_oils[chromium] - playwrigh...
1 failed, 1 passed in 31.31s

Test কোনো accessibility যাচাই লেখেনি, তবু accessibility-র regression ধরল, কারণ locator-টি ব্যবহারকারীর মতো নাম দিয়ে খুঁজেছিল। get_by_test_id("search-input") দিলে এই test পাস করত, আর ভুলটি থেকে যেত। এখানে আরও দুটি জিনিস দেখুন। প্রথমত, ব্যর্থ হতে ৩০ সেকেন্ড লেগেছে: fill-এর মতো action-এর default সময়সীমা ৩০ সেকেন্ড, যেখানে expect-এর ৫ সেকেন্ড। দ্বিতীয়ত, [chromium] লেখা থাকলেও চলেছে Edge: test id-তে browser-এর engine-এর নাম বসে, channel-এর নয়। বিস্তারিত accessibility testing পর্ব ৫৪ (Accessibility testing — WCAG 2.2, axe আর keyboard)-এ।

Strict mode: এক locator, এক element

বাজারঘরের হোম পাতায় প্রতিটি পণ্যের কার্ডে একটি “কার্টে যোগ করুন” বোতাম। নিচের test হোম পাতায় সেটিতে click করতে চায়, সত্যিকারের আউটপুট (মাঝের সারি ছাঁটা):

E  playwright._impl._errors.Error: Locator.click: Error: strict mode violation:
     get_by_role("button", name="কার্টে যোগ করুন") resolved to 11 elements:
     1) <button type="submit" data-testid="add-to-cart">…</button>
        aka get_by_role("button", name="কার্টে যোগ করুন : মিনিকেট চাল ৫ কেজি")
     2) <button type="submit" data-testid="add-to-cart">…</button>
        aka get_by_role("button", name="কার্টে যোগ করুন : মসুর ডাল ১ কেজি")
     …
1 failed in 1.05s

১২টি পণ্যের মধ্যে চা পাতার stock শূন্য, তাই বোতাম ১১টি। Playwright অন্ধভাবে প্রথমটিতে click করেনি, সাথে সাথে থেমেছে; একে বলে strict mode. প্রথমটিতে click হলে test চালে click করত, অথচ লেখক হয়তো তেল চেয়েছিলেন, আর test ভুল কারণে পাস করত। বার্তাটি নিজেই সমাধানও দেখাচ্ছে: হোম পাতার বোতামের accessible name-এ চোখে-না-দেখা অংশে পণ্যের নামও আছে (screen reader-এর জন্য)। তাই get_by_role("button", name="কার্টে যোগ করুন : সয়াবিন তেল ৫ লিটার") একটিই পায়। আরেক পথ: আগে কার্ডটি খুঁজে তার ভেতরে খোঁজা:

card = page.get_by_test_id("product-card").filter(has_text="সয়াবিন তেল")
card.get_by_role("button", name="কার্টে যোগ করুন").click()

Default-এ নাম আংশিক মেলে। name="কার্টে যোগ করুন" লেখা ১১টি বোতামের নামেরই অংশ, তাই সবাই মিলেছে। হুবহু মেলাতে exact=True. Bangla লেখায় আরেকটি ফাঁদ: একই দেখতে অক্ষর Unicode-এ দুই রকমভাবে লেখা যায় (যেমন “য়” একটি code point, অথবা “য” + নুক্তা)। Template আর test দুই রকম হলে চোখে এক, locator-এ অমিল। এর বিস্তারিত পর্ব ৩৫ আর localization-এর পর্ব ৫৬-এ।

৪ · Auto-waiting আর actionability — click-এর আগের প্রশ্নগুলো

বাসের টিকিট কাউন্টারে আপনি টাকা বাড়িয়ে দেন, কিন্তু কাউন্টারম্যান তখন আরেকজনের হিসাব মেলাচ্ছেন। অভিজ্ঞ যাত্রী টাকা টেবিলে ফেলে চলে যান না; জানালা খালি হওয়া পর্যন্ত অপেক্ষা করেন। Playwright-ও প্রতিটি action-এর আগে এভাবে দেখে নেয় element কাজের জন্য তৈরি কি না। একে বলে auto-waiting, আর যে শর্তগুলো দেখা হয়, সেগুলো actionability check:

শর্তমানেবাজারঘরে কখন ব্যর্থ
এক elementlocator ঠিক একটি element পায়হোম পাতায় ১১টি “কার্টে যোগ করুন”
Visibleআকার শূন্য নয়, লুকানো নয়পাতা লোড হওয়ার আগে
Stableদুটি animation frame-এ একই জায়গায়নড়তে থাকা toast বা slider
Enableddisabled নয়fetch চলার সময় add বোতাম
Receives eventsমাঝখানে click করলে এটিই পায়, অন্য কিছু ঢেকে নেইcookie banner বা modal ঢেকে রাখলে
Editable(fill-এর জন্য) readonly নয়শুধু-পড়ার ঘর

সব action সব শর্ত দেখে না: click দেখে visible, stable, enabled আর receives events; fill দেখে visible, enabled আর editable; inner_text() শুধু element-টির অস্তিত্ব দেখে। এই শেষেরটি পরের অংশের গল্প। আগে বাজারঘরের add বোতামটি দেখুন। Click করলে app-এর JavaScript বোতামটি disabled করে, fetch পাঠায়, তারপর ৪০০ ms দেরি করে badge বদলায় আর বোতাম আবার চালু করে। দ্বিতীয় click-কে তাই অপেক্ষা করতে হবে। নিচের test সেটিই মাপে:

def test_second_click_waits_until_enabled(page: Page, login):
    login("mitu")
    page.goto("/products/3")
    button = page.get_by_role("button", name="কার্টে যোগ করুন")
    button.click()
    expect(button).to_be_disabled()
    t0 = time.perf_counter()
    button.click()                 # auto-wait: enabled again
    print(f"second click waited {(time.perf_counter() - t0) * 1000:.0f} ms")
    expect(page.get_by_test_id("cart-count")).to_have_text("2")

তিনটি আলাদা run-এ দ্বিতীয় click অপেক্ষা করেছে ৮৪০, ৮২৫ আর ৮৩৩ ms, আর badge “2” হয়েছে। কোনো sleep লেখা হয়নি। অপেক্ষাটি চোখে দেখতে একই click-কে ইচ্ছা করে ১৫০ ms সময়সীমা দেওয়া হলো (button.click(timeout=150)), সত্যিকারের আউটপুটের call log:

E  playwright._impl._errors.TimeoutError: Locator.click: Timeout 150ms exceeded.
E  Call log:
E    - waiting for get_by_role("button", name="কার্টে যোগ করুন")
E      - locator resolved to <button disabled type="submit" aria-busy="true" data-testid="add-to-cart">কার্টে যোগ করুন</button>
E    - attempting click action
E      2 × waiting for element to be visible, enabled and stable
E        - element is not enabled
E      - retrying click action
E      - waiting 20ms
E      - waiting for element to be visible, enabled and stable
E      - element is not enabled
E    - retrying click action
E      - waiting 100ms

Call log হলো Playwright-এর ডায়েরি: কী খুঁজল, কী পেল, কোন শর্তে আটকাল, কতক্ষণ বিরতি দিল। এখানে লেখা আছে বোতামটি disabled আর aria-busy="true", আর কারণ “element is not enabled”. বিরতিগুলো খেয়াল করুন: ২০ ms, তারপর ১০০ ms. Playwright 1.65-এর driver-এর source code-এ action-এর বিরতির তালিকা [0, 20, 100, 100, 500] ms, তারপর প্রতিবার ৫০০. ব্যর্থ test-এর call log পড়তে পারা একজন automation tester-এর সবচেয়ে কাজের দক্ষতাগুলোর একটি।

  1. Resolve১টি elementstrict
  2. Visible, stable✔দেখা যায়, নড়ে না
  3. Enabled?disabledঅপেক্ষা
  4. Hit targetঢাকা নেইclick
দ্বিতীয় click (প্রথম click-এর পরপর)
বোতাম
শর্ত
বিরতি
ফল
  1. Locator resolve. পণ্যের পাতায় “কার্টে যোগ করুন” নামের বোতাম একটিই, তাই strict mode খুশি। হোম পাতায় হলে এখানেই থামত, ১১টি element.
  2. Visible আর stable. বোতামটি পর্দায় আছে, আকার শূন্য নয়, আর দুটি animation frame-এ একই জায়গায়। দুটি শর্ত পূরণ।
  3. Enabled? না। প্রথম click-এর পরে app বোতামে disabled আর aria-busy="true" বসিয়েছে। Playwright click করে না, শর্তটি আবার দেখার জন্য পিছিয়ে যায়। এখানে click করলে browser নিজেই disabled বোতামের click বাদ দিত, আর test ভাবত কাজ হয়েছে।
  4. বারবার দেখা। বিরতি বাড়তে থাকে: ২০, ১০০, ১০০, তারপর ৫০০ ms. ১৫০ ms সময়সীমার run-এর call log ঠিক এই সারিগুলো দেখিয়েছে, “element is not enabled”. সময়সীমা default ৩০ সেকেন্ড, তাই সাধারণ run-এ এটি অপেক্ষা করেই যায়।
  5. Enabled হলো। প্রায় ৪০০ ms-এর দেরির পরে app বোতাম আবার চালু করে। পরের বার দেখার সময় শর্ত পূরণ। Playwright এবার বোতামটি পর্দায় এনে (scroll) মাঝের বিন্দুটি হিসাব করে।
  6. Hit target, তারপর click. মাঝের বিন্দুতে অন্য কোনো element (toast, modal) ঢেকে নেই, তাই click হলো। সত্যিকারের run-এ দ্বিতীয় click-এর মোট অপেক্ষা ৮২৫ থেকে ৮৪০ ms, আর badge হলো “2”. বিরতির ধাপের কারণে বোতাম চালু হওয়ার পরেও কিছুটা সময় যায়, যা পরের অংশে মাপা হবে।

এবার actionability-র একটি ছোট নকল নিজে চালিয়ে দেখুন। নিচে পাঁচটি বোতাম: একটি স্বাভাবিক, একটি disabled, একটি লুকানো, একটি স্বচ্ছ পর্দায় ঢাকা, আর একটি নড়তে থাকা। Code প্রতিটির জন্য পাঁচটি শর্ত পরীক্ষা করে। এটি Playwright-এর আসল code নয়, একই ধারণার ব্রাউজারে-চলা সরল রূপ:

// Playwright-এর actionability check-এর সরল নকল (আসল code নয়)
const wait = (ms) => new Promise((r) => setTimeout(r, ms));

async function checks(el) {
  const r1 = el.getBoundingClientRect();
  const visible = r1.width > 0 && r1.height > 0 &&
    getComputedStyle(el).visibility !== "hidden";
  await wait(50);                          // দুবার মেপে দেখা: নড়ছে কি?
  const r2 = el.getBoundingClientRect();
  const stable = r1.x === r2.x && r1.y === r2.y;
  const x = r2.x + r2.width / 2, y = r2.y + r2.height / 2;
  const top = visible ? document.elementFromPoint(x, y) : null;
  return {
    attached: el.isConnected,
    visible,
    stable,
    enabled: !el.disabled,
    receivesEvents: !!top && (top === el || el.contains(top)),
  };
}

(async () => {
  await wait(150);                         // পাতার layout স্থির হওয়া পর্যন্ত
  for (const id of ["a", "b", "c", "d", "e"]) {
    const res = await checks(document.getElementById(id));
    const bad = Object.keys(res).filter((k) => !res[k]);
    console.log(id, bad.length ? "wait: " + bad.join(", ") : "click OK");
  }
})();

আসল আউটপুট (ব্রাউজারের JavaScript):

a click OK
b wait: enabled
c wait: visible, receivesEvents
d wait: receivesEvents
e wait: stable

b শুধু disabled, বাজারঘরের ব্যস্ত বোতামের মতো। c-র display:none, তাই আকার শূন্য; লুকানো জিনিস কোনো click পায় না, তাই দুটি শর্তই ব্যর্থ। d দেখা যায়, কিন্তু ওপরে একটি স্বচ্ছ div: elementFromPoint মাঝের বিন্দুতে সেই পর্দাটি পায়, বোতাম নয়। মানুষ এমন বোতামে click করলে কিছুই হয় না, অথচ JavaScript-এর el.click() দিব্যি কাজ করত; এজন্যই Playwright আসল mouse-এর মতো click করে আর hit target মেলায়। e ৫০ ms-এর ব্যবধানে দুবার মাপায় দুই জায়গায় পাওয়া গেছে, তাই unstable. Playwright এখানে ৫০ ms নয়, পরপর দুটি animation frame তুলনা করে; ধারণা একই।

৫ · Web-first assertion — দেখুন, আবার দেখুন

Actionability শুধু action-কে রক্ষা করে। কিন্তু test-এর আসল কাজ যাচাই, আর সেখানে অপেক্ষার ভুলটি সবচেয়ে বেশি হয়। নিচের দুটি test একই কাজ করে, পার্থক্য শুধু badge পড়ার ধরনে:

def test_badge_read_at_once_is_wrong(page: Page, login):
    login("mitu")
    page.goto("/products/3")
    page.get_by_role("button", name="কার্টে যোগ করুন").click()
    badge = page.get_by_test_id("cart-count").inner_text()  # read now
    assert badge == "1"


def test_badge_with_web_first_assertion(page: Page, login):
    login("mitu")
    page.goto("/products/3")
    t0 = time.perf_counter()
    page.get_by_role("button", name="কার্টে যোগ করুন").click()
    expect(page.get_by_test_id("cart-count")).to_have_text("1")
    print(f"badge changed after {(time.perf_counter() - t0) * 1000:.0f} ms")
    expect(page.get_by_test_id("toast")).to_have_text("কার্টে যোগ হয়েছে")

পুরো suite (ছয়টি test) পরিষ্কার app-এ, সত্যিকারের আউটপুট (-v -s; path নিরপেক্ষ, আর plugin-এর একটি deprecation warning ছাঁটা):

$ uv run pytest -v -s
platform win32 -- Python 3.12.13, pytest-9.2.0, pluggy-1.7.0
rootdir: ~/bazarghar-ui-tests
configfile: pyproject.toml
testpaths: tests
plugins: playwright-0.10.0
collecting ... collected 6 items

tests/test_browse.py::test_search_finds_two_oils[chromium] PASSED
tests/test_browse.py::test_rice_average_is_rounded_half_up[chromium] PASSED
tests/test_cart.py::test_badge_read_at_once_is_wrong[chromium] FAILED
tests/test_cart.py::test_badge_with_web_first_assertion[chromium] badge changed after 873 ms
PASSED
tests/test_cart.py::test_second_click_waits_until_enabled[chromium] second click waited 840 ms
PASSED
tests/test_checkout.py::test_checkout_1000_has_no_coupon[chromium] PASSED

================================== FAILURES ===================================
_________________ test_badge_read_at_once_is_wrong[chromium] __________________
    def test_badge_read_at_once_is_wrong(page: Page, login):
        login("mitu")
        page.goto("/products/3")
        page.get_by_role("button", name="কার্টে যোগ করুন").click()
        badge = page.get_by_test_id("cart-count").inner_text()  # read now
>       assert badge == "1"
E       AssertionError: assert '0' == '1'
E         - 1
E         + 0

tests\test_cart.py:11: AssertionError
=================== 1 failed, 5 passed, 1 warning in 8.34s ====================

Click শেষ হওয়া মানে browser click-টি পেয়েছে; app-এর কাজ শেষ হওয়া নয়। inner_text() সেই মুহূর্তের ছবি তোলে, তখন badge “0”. এ ধরনের test কখনো পাস, কখনো fail করে, কম্পিউটার কত ব্যস্ত তার ওপর নির্ভর করে: এটিই flaky test-এর সবচেয়ে সাধারণ উৎস (পর্ব ৪০-এ বিস্তারিত)। expect(...).to_have_text("1") হলো web-first assertion: শর্ত মেলা পর্যন্ত বারবার দেখে, default-এ ৫ সেকেন্ড পর্যন্ত।

কিন্তু badge-এর দেরি তো ৪০০ ms, assertion পাস করতে ৮৭৩ ms লাগল কেন? এটি বুঝতে একটি আলাদা script দিয়ে পাতার ভেতরে ঘড়ি বসিয়ে তিনবার মাপা হলো, সত্যিকারের আউটপুট:

click() returned 38 ms; expect passed 850 ms; submit->fetch done 13 ms; submit->badge 428 ms
click() returned 39 ms; expect passed 862 ms; submit->fetch done 16 ms; submit->badge 427 ms
click() returned 41 ms; expect passed 859 ms; submit->fetch done 13 ms; submit->badge 424 ms

Server উত্তর দিয়েছে ১৫ ms-এর মধ্যে, badge বদলেছে প্রায় ৪২৫ ms-এ, কিন্তু assertion পাস হয়েছে প্রায় ৮৫০ ms-এ। মাঝের ৪০০ ms কোথায় গেল? উত্তর লুকিয়ে আছে polling-এর সময়সূচিতে। Playwright 1.65-এর driver-এর source-এ (retryWithProgressAndBackoff) assertion প্রথমে একবার সাথে সাথে দেখে, তারপর বিরতি দেয় ০, ২০, ৫০, ১০০, ১০০, তারপর প্রতিবার ৫০০ ms. তাই badge যখন বদলায়, পরের দেখা ঘটে প্রায় ৭৭০ ms-এ (click-এর সময় যোগ করলে ৮৫০-এর কাছে)। নিচের stepper-এ সময়রেখাটি দেখুন:

expect(badge).to_have_text("1") · সময় expect শুরু থেকে (মডেল)
সময়
badge
দেখা
ফল
  1. প্রথম দেখা, সাথে সাথে। Click ফিরেছে প্রায় ৪০ ms-এ; assertion শুরু হয়েই একবার badge পড়ে: “0”. এখানে মিলে গেলে কোনো অপেক্ষাই হতো না, তাই দ্রুত পাতায় web-first assertion কোনো সময় নষ্ট করে না।
  2. দ্বিতীয় দেখা, ০ ms বিরতিতে। Retry-এর প্রথম বিরতি শূন্য, তাই আবার সাথে সাথে দেখা: এখনো “0”.
  3. ২০ আর ৭০ ms-এ। বিরতি ২০, তারপর ৫০ ms. এখনো “0”: app তখন fetch-এর উত্তর পেয়ে ৪০০ ms-এর দেরিতে বসে আছে।
  4. ১৭০ আর ২৭০ ms-এ। বিরতি ১০০, ১০০. এখনো “0”. এর পরের বিরতি ৫০০ ms, অর্থাৎ পরের দেখা ৭৭০ ms-এ।
  5. প্রায় ৪৩০ ms-এ badge বদলায়। পাতার ঘড়িতে মাপা: submit থেকে ৪২৪–৪২৮ ms. Playwright এই মুহূর্তে দেখছে না, সে ৫০০ ms-এর বিরতিতে। Polling-এর এটাই দাম: পরিবর্তন আর তা ধরা পড়ার মাঝে কিছু সময় যায়।
  6. ৭৭০ ms-এ সপ্তম দেখা, পাস। Badge “1”, assertion পাস। মডেলের ৭৭০ ms-এর সাথে click-এর ~৪০ ms আর প্রতিটি দেখার নিজের খরচ যোগ হয়ে আসল run-এ ৮৫০–৮৭৩ ms. তবুও time.sleep(1)-এর চেয়ে দ্রুত, আর পরিবর্তন ৩ সেকেন্ড দেরিতে এলেও পাস করত; sleep তখন fail করত।

এবার একই ধারণা নিজে চালান। নিচের JavaScript একটি ছোট expectToHaveText বানায়, যা Playwright-এর সময়সূচি নকল করে, আর একটি badge যা click-এর ৪৩০ ms পরে বদলায়। প্রতিটি দেখার সময় আর মান ছাপা হয়; শেষে ৩০০ ms সময়সীমার একটি ইচ্ছাকৃত ব্যর্থতা:

const badge = document.getElementById("badge");
document.getElementById("add").onclick = () =>
  setTimeout(() => { badge.textContent = "1"; }, 430);   // app-এর দেরি
const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
const t0 = performance.now();
const at = () => Math.round((performance.now() - t0) / 10) * 10;

async function expectToHaveText(el, want, timeout = 5000) {
  const waits = [0, 20, 50, 100, 100, 500];   // Playwright 1.65-এর মতো
  const start = performance.now();
  for (let i = 0; ; i++) {
    const got = el.textContent;
    console.log(`  check ${i + 1} at ~${at()} ms: "${got}"`);
    if (got === want) return;
    const w = waits[Math.min(i, waits.length - 1)];
    if (performance.now() - start + w > timeout)
      throw new Error(`expected "${want}", got "${got}" after ${timeout} ms`);
    await sleep(w);
  }
}

(async () => {
  document.getElementById("add").click();
  console.log(`naive read right after click: "${badge.textContent}"`);
  await expectToHaveText(badge, "1");
  console.log(`passed at ~${at()} ms (text changed at ~430 ms)`);
  try { await expectToHaveText(badge, "2", 300); }
  catch (e) { console.log("FAIL:", e.message); }
})();

আসল আউটপুট (ব্রাউজারের JavaScript; সময় ১০ ms-এ গোল করা, আপনার ব্রাউজারে কয়েক ms এদিক-ওদিক হতে পারে):

naive read right after click: "0"
  check 1 at ~0 ms: "0"
  check 2 at ~10 ms: "0"
  check 3 at ~30 ms: "0"
  check 4 at ~80 ms: "0"
  check 5 at ~190 ms: "0"
  check 6 at ~300 ms: "0"
  check 7 at ~800 ms: "1"
passed at ~800 ms (text changed at ~430 ms)
  check 1 at ~800 ms: "1"
  check 2 at ~810 ms: "1"
  check 3 at ~830 ms: "1"
  check 4 at ~890 ms: "1"
  check 5 at ~1000 ms: "1"
  check 6 at ~1110 ms: "1"
FAIL: expected "2", got "1" after 300 ms

প্রথম লাইনটিই আগের সত্যিকারের ব্যর্থ test: click-এর পরপর পড়লে “0”. তারপর সাতটি দেখা, stepper-এর মডেলের কাছাকাছি সময়ে, আর সপ্তমটিতে “1”. মডেলের ৭৭০ ms-এর বদলে প্রায় ৮০০ ms, কারণ প্রতিটি timer আর প্রতিটি দেখার নিজেরও কয়েক ms লাগে; Playwright-এর আসল run-এ একই কারণে ৮৫০ ms এসেছিল। শেষের ব্যর্থতায় খেয়াল করুন: ৩০০ ms সময়সীমায় পরের ৫০০ ms বিরতি আঁটে না, তাই ছয়টি দেখার পরে থেমে বার্তা দিয়েছে, যেখানে প্রত্যাশা আর শেষ দেখা মান দুটোই আছে। Playwright-এর আসল বার্তাও এই কাঠামোর, পরের অংশে দেখবেন। (আসল Playwright সময়সীমা ছোট হলে বড় বিরতিগুলো তালিকা থেকে বাদও দেয়; এই নকলে সেটি নেই।)

বিরতির তালিকা থেকে একটি সাধারণ হিসাব করা যায়: পরিবর্তন t ms-এ এলে assertion কখন পাস করবে, আর ৫ সেকেন্ডে মোট কতবার দেখা হয়। নিচের Python (ব্রাউজারেই চলে, Pyodide) সেই মডেল; প্রতিটি দেখার নিজের খরচ এতে ধরা হয়নি:

# Playwright 1.65 web-first assertion: one check, then waits (ms) between retries
WAITS = [0, 20, 50, 100, 100, 500]


def check_times(timeout=5000):
    t, times, i = 0, [0], 0
    while True:
        t += WAITS[min(i, len(WAITS) - 1)]
        i += 1
        if t > timeout:
            return times
        times.append(t)


def first_pass(change_at, timeout=5000):
    for t in check_times(timeout):
        if t >= change_at:
            return t
    return None


ts = check_times()
print("checks (ms):", ts[:8], "...")
print(len(ts), "checks fit in a 5000 ms timeout")
for change in [0, 50, 300, 430, 800, 2600, 6000]:
    p = first_pass(change)
    if p is None:
        print(f"text changes at {change:>4} ms -> TimeoutError at 5000 ms")
    else:
        print(f"text changes at {change:>4} ms -> pass at {p:>4} ms"
              f" (+{p - change} ms)")

আসল আউটপুট (Pyodide):

checks (ms): [0, 0, 20, 70, 170, 270, 770, 1270] ...
15 checks fit in a 5000 ms timeout
text changes at    0 ms -> pass at    0 ms (+0 ms)
text changes at   50 ms -> pass at   70 ms (+20 ms)
text changes at  300 ms -> pass at  770 ms (+470 ms)
text changes at  430 ms -> pass at  770 ms (+340 ms)
text changes at  800 ms -> pass at 1270 ms (+470 ms)
text changes at 2600 ms -> pass at 2770 ms (+170 ms)
text changes at 6000 ms -> TimeoutError at 5000 ms

তিনটি শিক্ষা। প্রথমত, শুরুতে দেখা ঘন ঘন (০ থেকে ২৭০ ms-এ ছয়বার), কারণ বেশিরভাগ পরিবর্তন দ্রুত আসে; পরে প্রতি ৫০০ ms-এ একবার, যাতে browser-এর ওপর চাপ না পড়ে। দ্বিতীয়ত, ধরা পড়ার বাড়তি দেরি সর্বোচ্চ প্রায় ৫০০ ms; ৩০০ বা ৮০০ ms-এর পরিবর্তনে ৪৭০ ms বাড়তি। তৃতীয়ত, ৫ সেকেন্ডে মডেলে ১৫টি দেখা; পরের অংশের সত্যিকারের ব্যর্থ run-এ Playwright জানিয়েছে ১৪ বার, কারণ আসল প্রতিটি দেখার নিজেরও কয়েক মিলিসেকেন্ড লাগে। মডেল আর বাস্তব কাছাকাছি, হুবহু নয়: যেকোনো মডেলের কাছে এটুকুই আশা করা উচিত।

কাজের web-first assertion-গুলো

Assertionযাচাইবাজারঘরে
to_have_textপুরো লেখা (বা regex) মেলেbadge “1”, গড় “4.3”
to_contain_textলেখার অংশ মেলেtoast-এ “যোগ হয়েছে”
to_be_visible / to_be_hiddenদেখা যায় কি না“স্টক নেই” লেখা
to_have_countকয়টি element“তেল” খুঁজলে ২টি কার্ড
to_be_disabled / to_be_enabledবোতামের অবস্থাব্যস্ত add বোতাম
to_have_url (page-এ)ঠিকানাঅর্ডারের পরে /orders/8
not_to_…উল্টো শর্ত, একই অপেক্ষাসহnot_to_be_visible

সময়সীমা বদলাতে একটি assertion-এ to_have_text("1", timeout=10_000), বা সব জায়গায় expect.set_options(timeout=10_000). কিন্তু সময়সীমা বাড়ানো সাধারণত সমাধান নয়, ধীর app-এর সমস্যা ঢেকে দেওয়া। আর assert locator.is_visible() লিখবেন না: is_visible() অপেক্ষা করে না, সেই মুহূর্তের উত্তর দেয়, ঠিক inner_text()-এর মতো। নিয়মটি মনে রাখুন: পাতা থেকে মান পড়ে Python-এর assert-এ দিলে অপেক্ষা হারায়; expect-এর ভেতরে locator দিলে অপেক্ষা থাকে।

৬ · Navigation, অপেক্ষা আর screenshot

page.goto(url) নিজেও অপেক্ষা করে: default-এ পাতার load ঘটনা পর্যন্ত, অর্থাৎ HTML, CSS, ছবি আর script নামানো শেষ হওয়া পর্যন্ত। দরকার হলে wait_until="domcontentloaded" (শুধু HTML পড়া শেষ) দিয়ে আগে ছাড়া যায়। Form জমা দিলে বা link-এ click করলে নতুন পাতা আসে; তখন আলাদা করে অপেক্ষা না লিখে পরের assertion-কেই অপেক্ষা করতে দিন: expect(page).to_have_url(re.compile(r"/orders/8")). এটি নতুন ঠিকানা আসা পর্যন্ত বারবার দেখে।

উপায়কখনমন্তব্য
web-first expectপ্রায় সবসময়যা দেখার কথা, সেটিরই অপেক্ষা
page.wait_for_url(…)পরের action-এর আগে ঠিকানা নিশ্চিত করাassertion নয়, শুধু অপেক্ষা
page.expect_response(…)নির্দিষ্ট API উত্তর ধরাবিস্তারিত পর্ব ৩৭-এ
wait_for_load_state("networkidle")প্রায় কখনো নয়নিয়মিত poll করা পাতায় কখনো “idle” হয় না
page.wait_for_timeout(1000), time.sleepশুধু debug-এর সময়ধীর আর তবুও flaky

শেষ সারিটিকে পর্ব ২২-এর test smell-এর ভাষায় বলে sleepy test: এক সেকেন্ড ঘুম দ্রুত কম্পিউটারে অপচয়, ধীর CI-তে যথেষ্ট নয়। Pyodide মডেলের হিসাবও তাই বলে: sleep(1000) সবসময় ১০০০ ms খরচ করে, আর ১০০০ ms-এর পরে আসা পরিবর্তন (যেমন ২৬০০ ms) ধরতে পারে না; polling ২৭৭০ ms-এ ধরে।

Screenshot

page.screenshot(path="screenshots/rice.png") দৃশ্যমান অংশের PNG তোলে; full_page=True পুরো লম্বা পাতা; locator.screenshot() শুধু একটি element, যেমন রেটিংয়ের অংশ। সত্যিকারের run-এ চালের পাতার ছবিটি হয়েছে ১২৮০ × ৮০০ pixel (আমাদের viewport), প্রায় ৫৪ KB. ছবিতে ওপরে “বাজারঘর” header আর খোঁজার ঘর, তারপর “মিনিকেট চাল ৫ কেজি”, দাম “420 টাকা”, আর রিভিউ অংশে “গড় রেটিং: 4.3 / 5 (4টি রিভিউ)”। প্রতিটি test-এ নিজে না তুলে plugin-কেও বলা যায়: --screenshot=only-on-failure দিলে শুধু ব্যর্থ test-এর শেষ অবস্থার ছবি test-results/-এ জমা হয়, bug report-এর প্রমাণ হিসেবে কাজে লাগে (পর্ব ১৮)। খেয়াল রাখবেন, pytest-playwright প্রতিটি run-এর শুরুতে test-results/ মুছে ফেলে; তাই নিজের ছবি অন্য ফোল্ডারে রাখুন, আমরা যেমন screenshots/-এ রেখেছি। দুটি ছবি pixel ধরে তুলনা করা, অর্থাৎ visual regression, পর্ব ৪১-এর বিষয়।

৭ · পুরো checkout — goto থেকে assertion, আর একটি বসানো bug

এবার সব অংশ একসাথে। পর্ব ০৮-এর coupon-এর সীমা মনে করুন: পণ্যের দাম ১০০০ টাকার বেশি হলে ছাড়, ঠিক ১০০০-এ নয়। সয়াবিন তেল (৮৮০) আর আটা (১২০) মিলে ঠিক ১০০০, সীমার মান। মিতু ঢাকার, কিন্তু অর্ডারটি রাজশাহীতে পাঠাবেন, তাই delivery ১২০:

import re

from playwright.sync_api import Page, expect


def add_to_cart(page: Page, product_id: int, expected_count: str):
    page.goto(f"/products/{product_id}")
    page.get_by_role("button", name="কার্টে যোগ করুন").click()
    expect(page.get_by_test_id("cart-count")).to_have_text(expected_count)


def test_checkout_1000_has_no_coupon(page: Page, login):
    login("mitu")
    add_to_cart(page, 3, "1")          # soybean oil 880
    add_to_cart(page, 7, "2")          # atta 120 -> subtotal 1000
    page.goto("/checkout")
    expect(page.get_by_test_id("quote-subtotal")).to_have_text("1000")
    expect(page.get_by_test_id("quote-discount")).to_have_text("0")

    page.get_by_label("জেলা").select_option("Rajshahi")
    expect(page.get_by_test_id("quote-delivery")).to_have_text("120")
    expect(page.get_by_test_id("quote-total")).to_have_text("1120")

    page.get_by_label("ঠিকানা").fill("বাড়ি ৭, সাহেব বাজার")
    page.get_by_label("মোবাইল নম্বর").fill("01712345678")
    page.get_by_label("ক্যাশ").check()
    page.get_by_role("button", name="অর্ডার করুন").click()

    expect(page).to_have_url(re.compile(r"/orders/8"))
    expect(page.get_by_test_id("order-status")).to_have_text("অর্ডার হয়েছে")
    expect(page.get_by_test_id("order-total")).to_have_text("1120")
test_checkout_1000_has_no_coupon · পরিষ্কার app
পাতা
কাজ
অপেক্ষা করে যা
মান
  1. Login. fresh_data আগেই seed ফিরিয়েছে। login("mitu") label দিয়ে ইমেইল ও পাসওয়ার্ড লেখে, role দিয়ে বোতাম চাপে, আর স্বাগত বার্তার অপেক্ষা করে। এই অপেক্ষা না থাকলে পরের goto login শেষ হওয়ার আগেই চলে যেতে পারত।
  2. তেল যোগ। পণ্যের পাতায় একটিই add বোতাম। Click-এর পরে helper badge “1” হওয়ার অপেক্ষা করে। এই অপেক্ষা জরুরি: না থাকলে পরের goto চলমান fetch-কে মাঝপথে থামাতে পারত, আর cart-এ তেল থাকত না।
  3. আটা যোগ। একই helper, এবার badge “2”. পণ্যের দাম এখন ৮৮০ + ১২০ = ১০০০, coupon-এর সীমার মান।
  4. Checkout-এর হিসাব। মিতুর জেলা ঢাকা, তাই পাতা খোলে ঢাকার হিসাবে: দাম ১০০০, ছাড় ০ (১০০০ “বেশি” নয়), delivery ৬০, মোট ১০৬০. Test এখানে দাম আর ছাড় যাচাই করে।
  5. জেলা বদল। select_option("Rajshahi")-এর পরে app fetch দিয়ে নতুন হিসাব আনে আর ৪০০ ms পরে দেখায়। Web-first assertion সেই দেরি সামলায়: delivery ১২০ (ঢাকার বাইরে, Plus নয়), মোট ১০০০ − ০ + ১২০ = ১১২০.
  6. অর্ডার। ঠিকানা আর ফোন label দিয়ে, পেমেন্ট “ক্যাশ” radio-র label দিয়ে, তারপর “অর্ডার করুন”. Server নতুন পাতায় পাঠায়; to_have_url সেই পাতা আসা পর্যন্ত অপেক্ষা করে। Reset-এর কারণে id নিশ্চিতভাবে 8.
  7. শেষ assertion. অবস্থা “অর্ডার হয়েছে”, মোট ১১২০. পুরো test সত্যিকারের run-এ পাস। কোথাও কোনো sleep নেই, কোথাও CSS শিকল নেই; প্রতিটি অপেক্ষা একটি দৃশ্যমান পরিবর্তনের সাথে বাঁধা।

এবার app-কে --bugs coupon_ge দিয়ে চালানো হলো: এই build-এ coupon-এর শর্ত > 1000-এর বদলে >= 1000, অর্থাৎ পর্ব ০৮-এর off-by-one. সত্যিকারের আউটপুট (--tb=short; আগের অংশের ইচ্ছাকৃত ব্যর্থ test বাদ দিয়ে):

$ uv run pytest --tb=short -k "not read_at_once"      # app: --bugs coupon_ge
collected 6 items / 1 deselected / 5 selected

tests\test_browse.py ..                                                  [ 40%]
tests\test_cart.py ..                                                    [ 80%]
tests\test_checkout.py F                                                 [100%]

================================== FAILURES ===================================
_________________ test_checkout_1000_has_no_coupon[chromium] __________________
tests\test_checkout.py:18: in test_checkout_1000_has_no_coupon
    expect(page.get_by_test_id("quote-discount")).to_have_text("0")
E   AssertionError: Locator expected to have text '0'
E   Actual value: 100
E   Call log:
E     - Expect "to_have_text" get_by_test_id("quote-discount") with timeout 5000ms
E     - waiting for get_by_test_id("quote-discount")
E       14 × locator resolved to <dd data-testid="quote-discount">100</dd>
E          - unexpected value "100"
E
E   Aria snapshot:
E   - definition: "100"
================= 1 failed, 4 passed, 1 deselected in 11.89s ==================

বার্তাটি একটি ভালো bug report-এর কাঁচামাল: কোন লাইন, কোন element, প্রত্যাশা “0”, আসল “100”, আর ৫ সেকেন্ডে ১৪ বার দেখেও একই মান। শেষের Aria snapshot দেখায় screen reader element-টিকে কীভাবে দেখে (একটি <dd>, অর্থাৎ definition). আরও দুটি জিনিস দেখার মতো। প্রথমত, বাকি চারটি UI test পাস করেছে, কারণ তারা coupon-এর সীমা ছোঁয় না: bug ধরা পড়ে শুধু সীমার মানের data দিলে। দ্বিতীয়ত, ব্যর্থ assertion পুরো ৫ সেকেন্ড অপেক্ষা করে তারপর ব্যর্থ হয়; পাস করা test দ্রুত, ব্যর্থ test ধীর। Suite-এ অনেক test একসাথে ভাঙলে এই সময় যোগ হয়।

একই bug, কোন স্তরে ধরা উচিত? এই off-by-one পর্ব ২১-এর unit test মিলিসেকেন্ডে ধরে, পর্ব ৩১-এর API test এক সেকেন্ডের কম সময়ে। UI test-এ লেগেছে প্রায় ১২ সেকেন্ড আর একটি পুরো browser. UI test-এর কাজ নিয়মের প্রতিটি সীমা যাচাই নয়; তার কাজ দেখা যে পাতা সঠিক মান দেখায়, জেলা বদলালে হিসাব বদলায়, আর অর্ডারের যাত্রা শেষ হয়। নিয়মের বাকি সীমাগুলো নিচের স্তরে রাখুন। এখানে সীমার মান বেছে নেওয়া একটি সচেতন সিদ্ধান্ত: যে একটি checkout যাত্রা UI-তে চালাতেই হবে, তার data এমন হোক যাতে সবচেয়ে ঝুঁকির নিয়মটিও ছুঁয়ে যায়।

৮ · Codegen, headed debug আর কতটুকু UI test

Codegen হলো Playwright-এর recorder: uv run playwright codegen --channel msedge http://127.0.0.1:8792 চালালে একটি browser আর পাশে একটি code-এর জানালা খোলে; আপনি যা click করেন আর লেখেন, তা Python code হয়ে জমা হয়। এই পর্বের জন্য codegen চালানো হয়নি, কারণ এটি পর্দায় জানালা খোলে; নিজের কম্পিউটারে চেষ্টা করে দেখুন। Codegen locator বাছতে ভালো (সাধারণত role আর label পছন্দ করে), শুরু করতে দ্রুত। কিন্তু এর লেখা script একটি খসড়া: এতে assertion প্রায় থাকে না, data hard-code করা, আর প্রতিটি click আলাদা লাইন। যে অংশ আপনাকে নিজে যোগ করতে হবে, তা-ই test-এর আসল মূল্য: কী যাচাই হবে, আর কেন।

ব্যর্থ test বুঝতে কয়েকটি উপায়:

  • --headed --slowmo=500: চোখের সামনে ধীরে চলে।
  • PWDEBUG=1 বা test-এর ভেতরে page.pause(): Playwright Inspector খোলে, ধাপে ধাপে চালানো আর locator পরীক্ষা করা যায়।
  • --screenshot=only-on-failure, --video=retain-on-failure: ব্যর্থতার প্রমাণ।
  • --tracing=retain-on-failure: প্রতিটি action-এর আগে-পরের DOM, network আর console একটি zip-এ; Trace Viewer-এ দেখার পদ্ধতি পর্ব ৩৭-এ।

আর কতগুলো UI test? বাজারঘরের নিজের suite-এ ১৫০টি unit আর API test, আমাদের এই পর্বে ছয়টি UI test. অনুপাতটি কাকতালীয় নয়। UI test বেছে নিন ব্যবহারকারীর গুরুত্বপূর্ণ যাত্রা ধরে: খোঁজা, cart, checkout, payment, review. প্রতিটির জন্য একটি বা দুটি সুখের পথ (happy path), আর যেখানে UI-র নিজের আচরণ আছে (বোতাম disabled, হিসাব নতুন করে আসা), সেখানে একটি করে। বাকি সব নিচের স্তরে। Test data-ও যতটা সম্ভব API দিয়ে বানান, UI দিয়ে নয়; এই কৌশল পর্ব ৩৭-এ, আর page object দিয়ে suite সাজানো পর্ব ৩৯-এ।

৯ · AI-এর যুগে — AI-এর লেখা UI test যাচাই

AI সহকারী Playwright test খুব দ্রুত লেখে, আর প্রথম দেখায় সেগুলো ঠিকঠাক লাগে। কিন্তু UI test-এ AI-এর কয়েকটি ভুল বারবার দেখা যায়:

AI-এর ভুলকেমন দেখায়কীভাবে ধরবেন
ঘুম দিয়ে অপেক্ষাpage.wait_for_timeout(2000), time.sleepgrep দিয়ে খুঁজুন; web-first expect বসান
অপেক্ষাহীন assertionassert page.locator(…).inner_text() == …এই পর্বের badge test-এর মতো দেরি বাড়িয়ে চালান
ভঙ্গুর selectordiv:nth-child(3) > buttonrole, label বা test id-তে বদলান
বানানো APIpage.get_by_role("button", text=…)Playwright-এর অফিসিয়াল docs-এ মেলান; চালিয়ে দেখুন
বর্তমান আচরণকেই সত্য ধরাপাতায় যা দেখা গেছে তা-ই expected (ছাড় “100”)প্রতিটি expected মান requirement থেকে হিসাব করুন
শুধু সুখের পথসীমার মান, ব্যস্ত বোতাম, ভুল ফোন নেইপর্ব ০৭–০৮-এর partition আর সীমা মিলিয়ে দেখুন
“সব test পাস” দাবিচালানো ছাড়াইনিজে চালান, একটি bug switch চালু করে আবার চালান

AI-কে UI test লিখতে দিলে প্রসঙ্গ আর নিষেধ দুটোই বলে দিন, আর expected মান নিজের হাতে রাখুন:

তুমি একজন অভিজ্ঞ automation tester. Python-এ pytest-playwright (sync API) দিয়ে একটি test লেখো। App: http://127.0.0.1:8792, পাতা /products/10 (চা পাতা, stock 0). Requirement: stock 0 হলে পাতায় "স্টক নেই" লেখা দেখা যাবে, আর "কার্টে যোগ করুন" বোতাম থাকবে না। নিয়ম: ১. শুধু get_by_role, get_by_label, get_by_text বা get_by_test_id; কোনো CSS শিকল বা nth-child নয়। ২. সব যাচাই web-first expect দিয়ে; sleep, wait_for_timeout বা inner_text দিয়ে assert নয়। ৩. Expected মান শুধু উপরের requirement থেকে; পাতা দেখে অনুমান করবে না। ৪. যে Playwright method ব্যবহার করবে, তার নাম আলাদা তালিকায় দাও, যাতে আমি docs-এ মিলিয়ে নিতে পারি। ৫. Test চালানোর ফল দাবি করবে না; আমি নিজে চালাব।

AI-এর লেখা UI test হাতে পেলে — যাচাইয়ের চেকলিস্ট

ভাবনার প্রশ্ন

প্রতিটি প্রশ্ন নিয়ে নিজে কিছুক্ষণ ভাবুন — তারপর “→ উত্তর” চাপুন।

প্র ০১UI automation-এ “অপেক্ষা” সমস্যাটি কীভাবে বিবর্তিত হয়েছে, আর auto-waiting কি flaky test পুরোপুরি দূর করে?

প্রথম যুগের browser automation-এ test লেখকের হাতে অপেক্ষার উপায় ছিল প্রায় একটিই: নির্দিষ্ট সময় ঘুম। Ajax-নির্ভর পাতা (২০০৫-এর পরে ব্যাপক) আসার পর সমস্যা তীব্র হলো, কারণ পাতা লোড হওয়ার পরেও তার অংশ বদলাতে থাকে। Selenium WebDriver দুটি উপায় দিল: implicit wait, যেখানে element খোঁজার সময় driver নির্দিষ্ট সময় পর্যন্ত চেষ্টা করে, আর explicit wait, যেখানে লেখক নিজে শর্ত বলে দেন (যেমন element clickable হওয়া)। দুটিই কাজ করে, কিন্তু দায়িত্ব লেখকের: কোথায় কোন শর্তে অপেক্ষা, তা প্রতিটি জায়গায় মনে রাখতে হয়। এক জায়গায় ভুলে গেলেই flaky test, আর দুটি মেশালে অপ্রত্যাশিত দীর্ঘ অপেক্ষা (পর্ব ৩৮-এ বিস্তারিত)।

Cypress আর পরে Playwright অপেক্ষাকে default বানাল: প্রতিটি action নিজে actionability দেখে, প্রতিটি assertion নিজে retry করে। এতে সবচেয়ে সাধারণ ভুলটি, “এখনো আসেনি এমন জিনিস পড়া”, অনেকটা কমে। কিন্তু এই পর্বের badge test দেখিয়েছে, ফাঁক থেকেই যায়: inner_text() বা is_visible()-এর মতো মুহূর্তের প্রশ্ন অপেক্ষা করে না, আর লেখক সেই মান Python-এর assert-এ দিলে auto-waiting কোনো কাজে আসে না।

আরও কিছু flaky কারণ অপেক্ষার সাথে সম্পর্কহীন: এক test-এর data আরেক test-এ চুইয়ে যাওয়া, সময় অঞ্চল আর তারিখ, এলোমেলো data, সমান্তরাল run-এ একই ব্যবহারকারী, বাইরের service-এর ধীরতা। Auto-waiting এগুলো ছোঁয় না; isolation, নির্ধারিত data আর নিয়ন্ত্রিত পরিবেশ লাগে। তাছাড়া web-first assertion ভুল শর্তেও অপেক্ষা করতে পারে: to_contain_text("1") লিখলে “10” বা “21”-এও পাস। পর্ব ৪০-এ flaky test-এর পুরো ছবি আর পরিসংখ্যান আসবে।

মূল উপলব্ধি: Auto-waiting অপেক্ষার যন্ত্র দেয়, কী-এর অপেক্ষা করতে হবে সেই সিদ্ধান্ত দেয় না। ভালো test এমন একটি দৃশ্যমান পরিবর্তনের অপেক্ষা করে, যা প্রমাণ করে কাজটি শেষ হয়েছে।

প্র ০২Role দিয়ে locator নাকি data-testid — কোনটি বেশি ভালো, আর এই বিতর্কে accessibility কোথায় আসে?

দুই পক্ষেরই শক্ত যুক্তি আছে। Role আর accessible name-এর পক্ষে: test ব্যবহারকারীর মতো খোঁজে, তাই যা ব্যবহারকারীর কাছে ভাঙা, তা test-এর কাছেও ভাঙা। Testing Library-র নির্মাতা Kent C. Dodds-এর বহুল উদ্ধৃত নীতি মোটামুটি এমন: test যত বেশি software-এর আসল ব্যবহারের মতো, তত বেশি আস্থা দেয়। এই পর্বে তার একটি সত্যিকারের প্রমাণ দেখেছেন: a11y_missing_label build-এ get_by_role("searchbox", name="পণ্য খুঁজুন") ব্যর্থ হয়েছে, অথচ কেউ accessibility test লেখেনি। একটি UI suite এভাবে বিনা খরচে accessibility-র ন্যূনতম পাহারাদার হয়ে যায়।

data-testid-এর পক্ষে: লেখা বদলালে test ভাঙে না। Marketing দল “কার্টে যোগ করুন” বদলে “ব্যাগে রাখুন” করলে role-ভিত্তিক সব locator বদলাতে হয়; test id ঠিক থাকে। বহুভাষী app-এ (বাংলা আর ইংরেজি দুই সংস্করণ) একই test দুই ভাষায় চালাতেও test id সুবিধাজনক। আর কিছু element-এর অর্থবোধক role বা নামই নেই, যেমন বাজারঘরের cart-এর সংখ্যার badge.

বিপক্ষের যুক্তিও আছে। Test id production HTML-এ বাড়তি attribute রাখে (অনেকে build-এর সময় মুছে ফেলেন), আর developer আর tester-এর মধ্যে একটি চুক্তি তৈরি করে যা রক্ষণাবেক্ষণ করতে হয়। Role-ভিত্তিক locator ধীর হতে পারে, কারণ accessibility tree হিসাব করতে হয়, যদিও সাধারণ পাতায় পার্থক্য চোখে পড়ার মতো নয়।

বাস্তব পথ মিশ্র: বোতাম, link, heading আর form-এর ঘরে role ও label; সংখ্যা, তালিকার সারি আর গতিশীল অংশে test id; আর লেখা বদলের ঝুঁকি থাকলে লেখার কেন্দ্রীয় উৎস (অনুবাদের ফাইল) থেকে নাম নেওয়া। বাজারঘরের test-এ এই মিশ্রণই দেখেছেন।

মূল উপলব্ধি: Locator বাছাই শুধু স্থায়িত্বের প্রশ্ন নয়, “test কী রক্ষা করে” তারও প্রশ্ন। Role-ভিত্তিক locator ব্যবহারকারীর অভিজ্ঞতাও পাহারা দেয়; test id শুধু test-কে স্থির রাখে।

প্র ০৩Headless browser-এ পাস করা test কি headed-এ, অর্থাৎ ব্যবহারকারীর আসল browser-এ পাসের নিশ্চয়তা দেয়?

পুরোনো দিনে উত্তর ছিল স্পষ্ট “না”। এক সময় জনপ্রিয় headless browser PhantomJS ছিল একটি পুরোপুরি আলাদা browser, যার WebKit সংস্করণ আসল browser-এর চেয়ে পিছিয়ে থাকত; তাতে পাস করা পাতা Chrome-এ ভাঙতে পারত। Chrome ২০১৭ সালে নিজের headless mode আনার পরে PhantomJS-এর রক্ষণাবেক্ষণ বন্ধ হয়। কিন্তু সেই প্রথম Chrome headless-ও আলাদা একটি বাস্তবায়ন ছিল। পরে, ২০২৩ সালের দিকে, Chromium দল “নতুন headless” আনে, যা সাধারণ browser-এর একই code ব্যবহার করে, শুধু পর্দায় আঁকে না; আমাদের জানামতে পরে এটিই default হয়েছে, আর পুরোনোটি আলাদা একটি ছোট program হিসেবে রয়ে গেছে (সংস্করণের খুঁটিনাটি আমরা যাচাই করিনি)। এই পর্বের run installed Edge-এর channel দিয়ে, যা এই নতুন ধরনের headless.

তবুও কিছু পার্থক্য থাকে। Headless-এ GPU প্রায়ই থাকে না, তাই animation আর canvas-এর সময় আলাদা হতে পারে। পর্দার মাপ, font আর device pixel ratio নিজে না বললে default থাকে; বাংলা font-এর রেন্ডারিং কম্পিউটারভেদে বদলায়। কিছু site headless browser চিনে আলাদা আচরণ করে। Focus আর clipboard-এর মতো operating system-এর অংশ headless-এ সীমিত।

আর headed হলেও এটি ব্যবহারকারীর আসল পরিবেশ নয়: তাঁর ফোনে ধীর network, পুরোনো Android, ভিন্ন font, extension, বড় করা লেখা। তাই সিদ্ধান্তের কাঠামো স্তরে স্তরে: দ্রুত feedback-এর জন্য CI-তে headless; কিছু গুরুত্বপূর্ণ যাত্রা মাঝে মাঝে headed বা আসল device-এ; আর Firefox ও WebKit-এ একই smoke test (পর্ব ৪২)। Visual দিকটি screenshot তুলনায় (পর্ব ৪১)।

মূল উপলব্ধি: প্রতিটি test পরিবেশ বাস্তবের একটি মডেল। প্রশ্ন “মডেলটি নিখুঁত কি না” নয়, “কোন ঝুঁকি এই মডেলে ধরা পড়ে না, আর সেটি কোথায় ধরব”।

প্র ০৪End-to-end UI test এত শক্তিশালী হলে সব test কেন UI দিয়েই লেখা হয় না?

এই পর্বের সংখ্যাগুলোই উত্তরের শুরু। একই coupon_ge bug ধরতে UI test-এর লেগেছে প্রায় ১২ সেকেন্ড, একটি পুরো browser আর চলমান server; unit test মিলিসেকেন্ডে, কোনো server ছাড়াই। আর UI test ব্যর্থ হলে কারণ অনেক রকম হতে পারে: নিয়মের ভুল, template-এর ভুল, JavaScript-এর ভুল, ধীর network, ভুল locator. Unit test ব্যর্থ হলে কারণ প্রায় একটিই।

২০১৫ সালে Google Testing Blog-এ “Just Say No to More End-to-End Tests” নামে একটি প্রবন্ধ বেশ আলোচিত হয়েছিল। তার মূল যুক্তি (আমাদের ভাষায়): E2E test ব্যবহারকারীর কাছাকাছি, কিন্তু feedback দেরিতে আসে, ব্যর্থতার কারণ খুঁজতে সময় লাগে, আর flaky হওয়ার প্রবণতা বেশি; তাই বেশিরভাগ test ছোট আর দ্রুত স্তরে রাখা উচিত, যা test pyramid-এর ধারণা (পর্ব ০৫)। বিপরীত মতও আছে: কেউ কেউ “testing trophy”-র কথা বলেন, যেখানে integration test-এর ভাগ বড়, কারণ আধুনিক frontend-এ অনেক bug থাকে অংশগুলো জোড়ার জায়গায়।

দুই মতের মিল একটি জায়গায়: UI test সংখ্যায় কম, বাছাই করা। প্রতিটি UI test একটি প্রশ্নের উত্তর দেবে, যা নিচের স্তর দিতে পারে না: পাতা ঠিক মান দেখায় কি না, ঘটনার ক্রম (click, অপেক্ষা, নতুন হিসাব) ঠিক কি না, আর যাত্রাটি শেষ পর্যন্ত যায় কি না। বাজারঘরের নিজের ১৫০টি test-এর পাশে এই পর্বের ছয়টি UI test সেই অনুপাতের উদাহরণ। আর খরচ কমাতে UI test-এর প্রস্তুতি (ব্যবহারকারী, cart) API দিয়ে করুন, শুধু যাচাইয়ের অংশ UI দিয়ে।

মূল উপলব্ধি: Test-এর মূল্য শুধু “কী ধরে” নয়, “কত দ্রুত, কত নিশ্চিতভাবে, আর ব্যর্থ হলে কত সহজে কারণ বোঝা যায়”। UI test সবচেয়ে দামী feedback, তাই সবচেয়ে বাছাই করে ব্যবহার করুন।

প্র ০৫Playwright কেন আলাদা driver process আর CDP ব্যবহার করে, যেখানে Selenium W3C WebDriver আর Cypress browser-এর ভেতরে চলে? প্রতিটির দাম কী?

Selenium আর WebDriver: test code HTTP request পাঠায় একটি driver program-কে (যেমন msedgedriver), যে browser চালায়। ২০১৮ সালে W3C এই protocol-কে আনুষ্ঠানিক মানদণ্ড (Recommendation) করে, ফলে প্রতিটি browser নির্মাতা নিজের driver দেন। সুবিধা: মানদণ্ড, বহু ভাষা, বহু browser, Grid দিয়ে দূরের কম্পিউটারে চালানো। দাম: প্রতিটি নির্দেশ একটি আলাদা request-response, আর মূল protocol-এ browser থেকে ঘটনা (যেমন console log, network) ধাক্কা দিয়ে পাঠানোর ব্যবস্থা সীমিত।

Cypress: test code browser-এর ভেতরেই, অ্যাপের পাশে চলে। সুবিধা: DOM-এ সরাসরি প্রবেশ, চমৎকার debug অভিজ্ঞতা। দাম: browser-এর নিরাপত্তা নিয়ম মানতে হয়, তাই একাধিক tab বা অন্য domain-এ যাওয়ার মতো কাজ ঐতিহাসিকভাবে কঠিন ছিল, আর test লিখতে হয় JavaScript-এ।

Playwright: একটি দীর্ঘস্থায়ী সংযোগে (pipe বা WebSocket) browser-এর debug protocol-এ কথা বলে। Chromium-এ এটি CDP; Firefox আর WebKit-এর জন্য Playwright নিজের ছোট পরিবর্তনসহ browser build দেয়। সুবিধা: দুই দিকের বার্তা, তাই network ধরা, নতুন tab-এর ঘটনা, console সব সরাসরি; context দ্রুত বানানো; আর অপেক্ষার যুক্তি driver-এ থাকায় প্রতিটি ভাষায় একই আচরণ। দাম: Firefox আর WebKit-এর “আসল” stock browser-এর বদলে Playwright-এর নিজের build, আর মানদণ্ডের বাইরের protocol-এর ওপর নির্ভরতা।

এই ব্যবধান কমছে। W3C-তে WebDriver BiDi নামে দুই দিকের নতুন মানদণ্ড তৈরি হচ্ছে, যাতে Selenium আর অন্য টুলও ঘটনা পেতে পারে; Puppeteer-এর মতো টুল ইতিমধ্যে Firefox-এ এটি ব্যবহার করে বলে জানা যায়। পর্ব ৩৮-এ Selenium-এর পাশাপাশি একটি নিরপেক্ষ তুলনা আসবে।

মূল উপলব্ধি: টুলের গঠন তার ক্ষমতা আর সীমা দুটোই ঠিক করে দেয়। টুল বাছাইয়ের আগে জিজ্ঞেস করুন: আমার দলের ভাষা কী, কোন browser জরুরি, কতটা network নিয়ন্ত্রণ চাই, আর বিশ্বজুড়ে মানদণ্ড কতটা গুরুত্বপূর্ণ।

অনুশীলন

প্রথম তিনটি কাগজ-কলমে, চতুর্থটি চাইলে বাজারঘরে চালিয়ে দেখুন।

  1. Spec থেকে UI test case: বাজারঘরের পণ্যের পাতার নিয়ম: (ক) stock ১ বা বেশি হলে লেখা “স্টকে আছে: Nটি”, পরিমাণের তালিকা ১–১০, আর “কার্টে যোগ করুন” বোতাম; (খ) stock ০ হলে লেখা “স্টক নেই”, বোতাম ও পরিমাণের তালিকা থাকবে না। Seed-এ চা পাতা (id 10) stock 0, গুঁড়া দুধ (id 11) stock 3, ডাল (id 2) stock 80. তিনটি UI test case লিখুন: কোন পাতা, কোন locator, কোন web-first assertion.

    TC1, stock নেই: goto("/products/10"); expect(get_by_test_id("product-stock")).to_have_text("স্টক নেই"); expect(get_by_role("button", name="কার্টে যোগ করুন")).to_have_count(0); expect(get_by_label("পরিমাণ")).to_have_count(0). এখানে not_to_be_visible-এর চেয়ে to_have_count(0) বেশি কড়া: বোতাম লুকানো নয়, একেবারে নেই।

    TC2, সীমার কাছে stock (৩): goto("/products/11"); লেখা “স্টকে আছে: 3টি”; বোতাম দৃশ্যমান। এটি সীমার কাছের partition (১ বা বেশি), পর্ব ০৭–০৮-এর ভাষায়।

    TC3, সাধারণ stock: goto("/products/2"); লেখা “স্টকে আছে: 80টি”; expect(get_by_label("পরিমাণ").locator("option")).to_have_count(10). পরিমাণের সীমা (১–১০) UI-তে একবার দেখা যথেষ্ট; ১১ পাঠালে কী হয়, তা API test-এর কাজ।

    খেয়াল করুন, stock ঠিক ০ আর ১-এর সীমাটি seed-এ নেই (১-এর পণ্য নেই)। চাইলে admin API দিয়ে test-এর আগে একটি পণ্যের stock 1 করে নিতে পারেন; প্রস্তুতি API-তে, যাচাই UI-তে।

  2. ব্যর্থতা পড়ুন: একটি test-এর বার্তা: AssertionError: Locator expected to have text '1120', Actual value: 1060, call log-এ 14 × locator resolved to <dd data-testid="quote-total">1060</dd>. Test-এ জেলা বদলের লাইনটি ছিল page.get_by_label("জেলা").select_option("Rajshahi"). সম্ভাব্য দুটি কারণ বলুন, আর প্রতিটি কীভাবে আলাদা করবেন।

    ১০৬০ হলো ঢাকার হিসাব (১০০০ + ৬০)। অর্থাৎ পাঁচ সেকেন্ডে ১৪ বার দেখেও হিসাব নতুন জেলায় বদলায়নি। কারণ ১, app-এর bug: জেলা বদলের ঘটনায় fetch হয়নি, ভুল জেলা পাঠানো হয়েছে, বা server ভুল হিসাব দিয়েছে। আলাদা করতে /api/cart/quote?district=Rajshahi সরাসরি দেখুন: API ১১২০ দিলে সমস্যা পাতার JavaScript-এ। কারণ ২, test-এর ভুল: select-এর ঘটনা ঘটেনি বা ভুল option বাছা হয়েছে; যেমন option-এর value “Rajshahi” না হয়ে অন্য কিছু হলে select_option নিজেই error দিত, তাই সেটি কম সম্ভব। --headed --slowmo বা trace দিয়ে দেখুন জেলার ঘরে আসলে কী বাছা হয়েছে, আর network-এ quote-এর request গেছে কি না। দেরির কারণে নয়: দেরি হলে ৫ সেকেন্ডের মধ্যে ১৪ বারের কোনো একবারে ১১২০ আসত।

  3. এই test-এর ভুল খুঁজুন:
    def test_add_rice(page):
        page.goto("http://127.0.0.1:8792/")
        page.locator("ul.grid > li:nth-child(1) form button").click()
        time.sleep(0.3)
        assert page.locator("[data-testid=cart-count]").inner_text() != "0"

    অন্তত পাঁচটি সমস্যা। (১) Login নেই: বাজারঘরে লগইন ছাড়া add করলে app /login-এ পাঠায়; test আসলে cart-এ কিছুই যোগ করে না। (২) ভঙ্গুর locator: “প্রথম কার্ড” মানে আজ চাল, কাল সাজানোর ক্রম বদলালে অন্য পণ্য; নাম দিয়ে খুঁজুন, যেমন get_by_role("button", name="কার্টে যোগ করুন : মিনিকেট চাল ৫ কেজি"). (৩) Sleep: ৩০০ ms, অথচ badge-এর দেরি ৪০০ ms-এর বেশি; প্রায় সবসময় ব্যর্থ, আর দেরি কম হলে কখনো কখনো পাস: flaky. (৪) অপেক্ষাহীন assertion: inner_text()-এর ফল assert-এ; expect(get_by_test_id("cart-count")).to_have_text("1") লিখুন। (৫) দুর্বল শর্ত: “0 নয়” মানে 5 বা 99-ও পাস; প্রত্যাশিত মান “1” হুবহু লিখুন। ছোট বিষয়: পুরো URL hard-code না করে base_url দিয়ে goto("/").

  4. Polling-এর হিসাব: Playwright 1.65-এর assertion প্রথমে একবার দেখে, তারপর বিরতি ০, ২০, ৫০, ১০০, ১০০, তারপর প্রতিবার ৫০০ ms. একটি লেখা assertion শুরুর ১২০০ ms পরে বদলালে মডেল অনুযায়ী assertion কখন পাস করবে? Timeout ১০০০ ms হলে কী হবে? (প্রতিটি দেখার নিজের খরচ বাদ।)

    দেখার সময়গুলো: ০, ০, ২০, ৭০, ১৭০, ২৭০, ৭৭০, ১২৭০, ১৭৭০ ms … ১২০০ ms-এর পরে প্রথম দেখা ১২৭০ ms-এ, তাই পাস প্রায় ১২৭০ ms-এ (৭০ ms বাড়তি)। Timeout ১০০০ ms হলে শেষ দেখা ৭৭০ ms-এ (তখনো পুরোনো লেখা), আর ১২৭০ সময়সীমার বাইরে, তাই TimeoutError. বাস্তবে আরও একটি সূক্ষ্মতা: ছোট timeout-এ Playwright বড় বিরতি তালিকা থেকে বাদ দেয় (timeout-এর এক-পঞ্চমাংশের বড় বিরতি), ফলে ১০০০ ms-এ ৫০০-র বদলে ছোট বিরতিতে দেখে; তবু লেখা ১২০০ ms-এ বদলালে ১০০০ ms-এর মধ্যে ধরা অসম্ভব। উপরের Pyodide block-এ first_pass(1200) আর first_pass(1200, timeout=1000) চালিয়ে নিজের হিসাব মিলিয়ে নিন।

নিজেকে যাচাই করুন

ভুল হলে কারণসহ ব্যাখ্যা পাবেন, আবার চেষ্টাও করতে পারবেন।

ক্রমPlaywright-এ locator.click() ডাকার পর ঘটনাগুলো সঠিক ক্রমে সাজান (▲▼ চেপে সরান)

  1. Locator পাতায় খুঁজে ঠিক একটি element পায় (strict mode)
  2. Element visible, stable আর enabled কি না দেখে; না হলে বিরতি দিয়ে আবার দেখে
  3. দরকার হলে element-টি scroll করে পর্দায় আনে
  4. মাঝের বিন্দুতে অন্য কিছু ঢেকে আছে কি না দেখে (hit target)
  5. সেই বিন্দুতে mouse দিয়ে click পাঠায়

একটি বোতামে click-এর পরে cart-এর badge প্রায় ৪০০ ms দেরিতে “1” হয়। Playwright (Python)-এ কোন যাচাই নির্ভরযোগ্য?

  • assert page.get_by_test_id("cart-count").inner_text() == "1"
  • expect(page.get_by_test_id("cart-count")).to_have_text("1")
  • time.sleep(0.5), তারপর inner_text() দিয়ে assert
  • assert page.get_by_test_id("cart-count").is_visible()

একটি পাতায় ১১টি পণ্যের কার্ড, প্রতিটিতে “কার্টে যোগ করুন” বোতাম। page.get_by_role("button", name="কার্টে যোগ করুন").click() চালালে Playwright কী করে?

  • প্রথম বোতামে click করে
  • ১১টি বোতামেই একে একে click করে
  • Strict mode violation error দিয়ে থামে
  • একটি element-এর অপেক্ষায় timeout পর্যন্ত বসে থাকে

Playwright-এ click-এর আগে actionability check-এর অংশ নয় কোনটি?

  • Element দৃশ্যমান (visible) কি না
  • Element enabled কি না
  • অন্য কোনো element ঢেকে রেখেছে কি না
  • Click-এর পরে server সফল উত্তর দেবে কি না

pytest-playwright-এ পরপর দুটি test চলে। প্রথম test মিতু হিসেবে login করে। দ্বিতীয় test-এর page fixture কী অবস্থায় শুরু হয়?

  • নতুন browser context-এ, কোনো login ছাড়াই
  • মিতু হিসেবে logged in, কারণ browser একই
  • একদম নতুন browser process-এ, নতুন install-সহ
  • আগের test-এর শেষ পাতাটি খোলা অবস্থায়

বাজারঘরের একটি build-এ খোঁজার ঘরের label হারিয়ে গেছে, পাতা দেখতে একই। কোন locator-ভিত্তিক test এই পরিবর্তনে ব্যর্থ হবে?

  • get_by_test_id("search-input")
  • get_by_role("searchbox", name="পণ্য খুঁজুন")
  • locator("#search-input")
  • locator("input[type=search]")

একটি web-first assertion-এর সময়সীমা ৫০০০ ms. শর্তটি কখনো পূরণ হয় না। সাধারণভাবে কী ঘটে?

  • প্রথমবার অমিল পেয়েই সাথে সাথে ব্যর্থ হয়
  • শর্ত পূরণ না হওয়া পর্যন্ত অনন্তকাল অপেক্ষা করে
  • বারবার দেখে, ৫ সেকেন্ড পরে প্রত্যাশা আর আসল মানসহ ব্যর্থ হয়
  • Test-টি নিজে থেকে skip হয়ে যায়

Coupon-এর নিয়ম: দাম ১০০০ টাকার বেশি হলে ছাড়। একটি দল checkout-এর একটিমাত্র UI test রাখতে চায়। Cart-এর data হিসেবে কোনটি সবচেয়ে কাজের?

  • ঠিক ১০০০ টাকার cart, যেখানে ছাড় ০ হওয়ার কথা
  • ৫০০ টাকার cart
  • ৫০০০ টাকার cart
  • প্রতিবার এলোমেলো টাকার cart

শব্দকোষ

লেখার মধ্যে ডটেড দাগ দেওয়া শব্দে মাউস রাখুন বা চাপুন — অর্থ দেখাবে। এই পর্বের সব নতুন শব্দ এখানে একসাথে:

মনে রাখুন

  1. Browser → context → page: একটি browser, প্রতিটি test-এ নতুন context আর page; তাই test-গুলো একে অপরের cookie দেখে না।
  2. Locator: আগে role আর label, তারপর test id; locator প্রতিবার নতুন করে খোঁজে, আর একাধিক element পেলে strict mode থামায়।
  3. Actionability: click-এর আগে visible, stable, enabled আর hit target; call log বলে কোন শর্তে আটকেছে।
  4. Web-first assertion: expect(locator) বারবার দেখে; inner_text() বা is_visible()-এর মান assert-এ দিলে অপেক্ষা হারায়। কোনো sleep নয়।
  5. বাছাই করা UI test: গুরুত্বপূর্ণ যাত্রা, সীমার মানের data, প্রস্তুতি সম্ভব হলে API দিয়ে; নিয়মের প্রতিটি সীমা নিচের স্তরে।

পরের পর্বে: প্রতিটি test-এ UI দিয়ে login ধীর। পরের পর্বে login একবার করে storage state আবার ব্যবহার, network intercept দিয়ে wallet gateway-এর timeout বানানো, API দিয়ে test data, আর ব্যর্থ test-এর trace খুলে ধাপে ধাপে পড়া।

আরও পড়ুন · ABCL TECH-এ আপনার পরবর্তী পদক্ষেপ

এই পর্বটি শেয়ার করুন:
এই পর্বে ভুল পেয়েছেন? জানান