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

Automation-এর জন্য web — DOM, CSS selector, XPath আর ভালো locator

The Web for Automation: DOM, CSS Selectors, XPath and Good Locators

Taught in Bangla, this lesson reads a page as a DOM tree and an accessibility tree, writes CSS selectors and XPath and counts their matches, and ranks locators from test ids and role plus accessible name down to long CSS chains. A real Playwright 1.65.2 run in headless Edge counts 11 add-to-cart matches on the Bazarghar home page; after a template change a CSS chain drops to zero and nth-child silently picks another product. Strict mode, Shadow DOM, iframes and Bangla NFC traps are covered.

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

  • DOM গাছ, element, attribute আর accessibility tree একজন tester-এর চোখে পড়া, আর role ও accessible name কোথা থেকে আসে বোঝা
  • CSS selector (id, class, attribute, descendant, child, nth-child, :has) আর XPath (axis, text(), contains()) লিখে match গোনা
  • একটি element-এর জন্য কয়েকটি locator তুলনা করে সবচেয়ে মজবুতটি বাছাই করা, আর strict mode-এর বার্তা পড়া
  • DOM বদলালে কোন locator জোরে ভাঙে, কোনটি নীরবে ভুল element ধরে, তা সত্যিকারের run-এ দেখা
  • Shadow DOM, iframe আর বাংলা লেখার Unicode-ফাঁদ চিনে নিরাপদ locator লেখা

১ · Tester-এর চোখে web পাতা — DOM গাছ

কারওয়ান বাজারে কাউকে একটি দোকান খুঁজে দিতে বললে দুইভাবে ঠিকানা দেওয়া যায়। একটি হলো “ঢোকার পরে বাঁয়ে তৃতীয় সারির দ্বিতীয় দোকান”। অন্যটি “রহিম স্টোর, দোকান নম্বর ১২”। প্রথম ঠিকানা ততক্ষণই কাজ করে, যতক্ষণ কেউ নতুন দোকান না বসায় বা সারি না বদলায়। দ্বিতীয়টি দোকানের নিজের পরিচয়ের ওপর দাঁড়িয়ে, তাই আশপাশ বদলালেও টিকে থাকে। UI automation-এর প্রায় পুরো দক্ষতা এই পার্থক্যে: পাতার একটি বোতাম বা ঘরকে কীভাবে “ঠিকানা” দেবেন।

মডিউল ৫-এ test পাঠিয়েছে সরাসরি HTTP request; এবার test চলবে আসল browser-এ, ব্যবহারকারীর মতো ক্লিক আর টাইপ করে। এমন test-কে বলে end-to-end test, আর UI test-এর automation-এ প্রতিটি কাজের প্রথম ধাপ একটিই: পাতায় ঠিক element-টি খুঁজে পাওয়া। এই মডিউলের পরের পর্বগুলোতে Playwright (পর্ব ৩৬–৩৭), Selenium (পর্ব ৩৮) আর page object (পর্ব ৩৯) আসবে; সবখানে ভিত্তি এই পর্বের locator.

HTML থেকে গাছ

Browser HTML পড়ে মেমরিতে একটি গাছ বানায়, যার নাম DOM (Document Object Model). প্রতিটি ট্যাগ একটি element, তার ভেতরের ট্যাগ তার সন্তান, পাশাপাশি ট্যাগ ভাই-বোন (sibling). Element-এর গায়ে থাকে attribute: id, class, href, data-testid ইত্যাদি। Developer-দের দৃষ্টিতে DOM কীভাবে JavaScript দিয়ে পড়া ও বদলানো হয়, তা জাভাস্ক্রিপ্ট কোর্সের পর্ব ৩৭-এ আছে; এখানে আমরা tester-এর তিনটি প্রশ্নে থাকব: কোন element, কীভাবে চিনব, আর চেনার উপায়টি কতদিন টিকবে।

বাজারঘরের প্রথম পাতায় প্রতিটি পণ্য একটি card. Template থেকে চালের card-এর HTML (একটু ছোট করে):

<li class="card" data-testid="product-card" data-product-id="1">
  <h2 class="card-title"><a href="/products/1"
      data-testid="product-link">মিনিকেট চাল ৫ কেজি</a></h2>
  <p class="price" data-testid="product-price">420 টাকা</p>
  <form method="post" action="/cart/add" data-add-to-cart>
    <input type="hidden" name="product_id" value="1">
    <input type="hidden" name="qty" value="1">
    <button type="submit" data-testid="add-to-cart">কার্টে যোগ করুন
      <span class="visually-hidden">: মিনিকেট চাল ৫ কেজি</span></button>
  </form>
</li>

বোতামের ভেতরে একটি লুকানো span আছে: চোখে দেখা যায় না, কিন্তু screen reader পড়ে। প্রথম পাতায় এমন ১১টি বোতাম, সবগুলোর দৃশ্যমান লেখা একই “কার্টে যোগ করুন”; লুকানো অংশটিই বলে দেয় কোন পণ্যের। এই ছোট বিবরণ পরে locator বাছাইয়ে বড় ভূমিকা রাখবে।

চালের card-এর DOM গাছ, আর বোতামে পৌঁছানোর চারটি পথ

One product card as a tree; four kinds of locator reach the same button

DOM গাছ: li.card → h2 → a; p.price; form → input, input, button → লেখা, লুকানো span; নিচে চারটি locator li.card data-product-id="1" h2 p.price form a মিনিকেট চাল… input × 2 hidden button data-testid="add-to-cart" দৃশ্যমান লেখা কার্টে যোগ করুন লুকানো span : মিনিকেট চাল… CSS: [data-product-id="1"] button XPath: //a[text()='…']/ancestor::li//button Role: button + নাম (লেখা + লুকানো span) Test id: card 1-এর ভেতরে add-to-cart
ছবি ৩৫.১ — একই বোতামে চারটি পথে পৌঁছানো যায়। CSS আর XPath গাছের গঠন ও attribute ধরে হাঁটে; role-ভিত্তিক locator দেখে browser-এর accessibility tree, যেখানে লুকানো span-ও নামের অংশ; test id শুধু test-এর জন্য রাখা একটি স্থির চিহ্ন।

Attribute বনাম property, আর DevTools

দুটি শব্দ গুলিয়ে যায়। Attribute হলো HTML-এ লেখা মান, যেমন <input value="1">; property হলো চলার সময় JavaScript object-এর মান। ব্যবহারকারী ঘরে নতুন কিছু টাইপ করলে property বদলায়, attribute আগের মতোই থাকে। CSS selector আর XPath দেখে attribute; তাই input[value="5"] দিয়ে “যে ঘরে ৫ লেখা হয়েছে” খোঁজা যায় না। Tester-এর প্রধান যন্ত্র browser-এর DevTools: Elements প্যানেলে গাছ দেখা, আর Console-এ $$('selector') লিখে সাথে সাথে গোনা যায় কয়টি element মেলে। Elements প্যানেলে ডান-ক্লিক করে “Copy selector” বা “Copy XPath” পাওয়া যায়, কিন্তু সেগুলো প্রায়ই অবস্থান-নির্ভর (li:nth-child(1) > form > button), অর্থাৎ বাজারের “তৃতীয় সারির দ্বিতীয় দোকান”। সেগুলো শুরু হিসেবে নিন, শেষ হিসেবে নয়।

একটি শব্দের পার্থক্যও মনে রাখুন। Selector একটি লেখা, যেমন [data-testid="add-to-cart"]; locator হলো automation tool-এর একটি বস্তু, যা একটি খোঁজার নিয়ম ধরে রাখে আর ব্যবহারের মুহূর্তে নতুন করে খোঁজে। Playwright-এর locator ভেতরে CSS, XPath বা role-এর নিয়ম রাখতে পারে; Selenium-এ একই কাজ করে By.CSS_SELECTOR, By.XPATH ইত্যাদি।

২ · Role আর accessible name — ব্যবহারকারী যেভাবে দেখেন

DOM-এর পাশাপাশি browser আরেকটি গাছ বানায়: accessibility tree. দৃষ্টিপ্রতিবন্ধী ব্যবহারকারীর screen reader পাতা পড়ে এই গাছ থেকে। সেখানে প্রতিটি অংশের দুটি মূল পরিচয়: role (এটি কী: বোতাম, লিংক, শিরোনাম, তালিকার সারি) আর accessible name (এর নাম কী)। বাসের কন্ডাক্টর যেমন “মিরপুর-১০, মিরপুর-১০” বলে ডাকেন: ধরন বাস, নাম গন্তব্য। যাত্রী রঙ বা নম্বর-প্লেট দেখে না, ধরন আর নাম শোনে।

বেশিরভাগ role HTML ট্যাগ থেকেই আসে, আলাদা করে লিখতে হয় না। ARIA attribute (role, aria-label …) লাগে শুধু তখন, যখন HTML নিজে অর্থ বোঝাতে পারে না। ARIA আর accessibility-র ভিত্তি এইচটিএমএল ও সিএসএস কোর্সের পর্ব ১২-এ। বাজারঘরের প্রথম পাতায় সত্যিকারের গোনা (Playwright, নিচে §৬):

HTMLRoleবাজারঘরের প্রথম পাতায়
<button>button১২টি: ১১টি “কার্টে যোগ করুন” + ১টি “খুঁজুন”
<a href>link১৬টি: ১২ পণ্য, লোগো, কার্ট, লগইন আর skip link
<li>listitem১২টি card
<h1> … <h6>heading (level ১–৬)পণ্যের পাতায় level ১: “মিনিকেট চাল ৫ কেজি”
<input type="search">searchbox১টি, নাম “পণ্য খুঁজুন”
<select>comboboxপণ্যের পাতায় পরিমাণ, checkout-এ জেলা আর সময়
<input type="radio">radiocheckout-এ ক্যাশ, কার্ড, মোবাইল ওয়ালেট

নাম কোথা থেকে আসে

W3C-র “Accessible Name and Description Computation” (সংক্ষেপে AccName) নির্দিষ্ট ক্রমে নাম হিসাব করে। সরল করে বললে: আগে aria-labelledby (অন্য element-এর লেখা), তারপর aria-label, তারপর ঘরের সাথে জোড়া <label> বা বোতাম-লিংকের ভেতরের লেখা, আর শেষ ভরসা title বা placeholder. বাজারঘরের খোঁজার ঘরে <label class="visually-hidden">পণ্য খুঁজুন</label> আছে, তাই নাম “পণ্য খুঁজুন”, placeholder “চাল, ডাল, তেল…” নয়।

সত্যিকারের run-এর একটি চমক: বোতামের HTML-এ লেখা “কার্টে যোগ করুন” আর লুকানো span-এর শুরু “: মিনিকেট …”, মাঝে কোনো ফাঁকা নেই। তবু Edge-এর হিসাব করা accessible name হলো কার্টে যোগ করুন : মিনিকেট চাল ৫ কেজি, কোলনের আগে একটি ফাঁকা জায়গাসহ। সম্ভাব্য কারণ: লুকানো span-টি CSS-এ position: absolute, তাই browser তাকে আলাদা block হিসেবে ধরে নামের অংশগুলোর মাঝে ফাঁকা বসায়। ফলে HTML দেখে অনুমান করা নাম (…করুন: মিনিকেট…) দিয়ে খুঁজলে ০টি মিল, আর tool-এর দেখানো নাম দিয়ে খুঁজলে ১টি। শিক্ষা: accessible name অনুমান করবেন না; tool-কে জিজ্ঞেস করুন (Playwright-এর error বার্তার aka লাইন বা aria_snapshot(), DevTools-এর Accessibility প্যানেল)।

Role-ভিত্তিক খোঁজার একটি বাড়তি লাভ আছে। get_by_role("searchbox", name="পণ্য খুঁজুন") পাস করা মানে ঘরটির একটি ব্যবহারযোগ্য নাম আছে। App-এর a11y_missing_label নামের বসানো ভুল চালু করলে label মুছে যায়; তখন এই locator কিছুই পাবে না, যদিও ঘরটি চোখে দেখা যায়। অর্থাৎ role-locator একসাথে খোঁজে আর accessibility-র একটি ছোট যাচাই করে। তবে এটি পূর্ণ accessibility testing নয়; WCAG, axe আর keyboard দিয়ে সেই কাজ পর্ব ৫৪-এ।

৩ · CSS selector — id, class, attribute, descendant, nth-child

CSS selector-এর জন্ম পাতা সাজানোর জন্য, কিন্তু একই ভাষা দিয়ে element খোঁজা যায়, browser নিজেই খুব দ্রুত তা মেলায়। পুরো ব্যাকরণ এইচটিএমএল ও সিএসএস কোর্সের পর্ব ১৭-এ; এখানে tester-এর দরকারি অংশ, বাজারঘরের প্রথম পাতায় Playwright-এর সত্যিকারের গোনাসহ:

ধরনউদাহরণমিলমন্তব্য
ট্যাগbutton১২প্রায় কখনো একা যথেষ্ট নয়
id#search-input১পাতায় একক হওয়ার কথা; কিন্তু অনেক framework id নিজে বানায়
class.card১২class সাজের জন্য, তাই designer বদলাতে পারেন
Attribute[data-testid=product-card]১২^= শুরু, $= শেষ, *= ভেতরে
Descendant (ফাঁকা)[data-product-id="1"] button১যেকোনো গভীরতায় ভেতরে
Child (>)ul.grid > li > form > button—প্রতিটি ধাপ ঠিক এক স্তর; গঠন বদলালেই ভাঙে
nth-childul.grid li:nth-child(2) button১অবস্থান ধরে; ক্রম বদলালে অন্য element
:has().card:has([data-testid=out-of-stock])—“যার ভেতরে … আছে”; নতুন, এখন সব বড় browser-এ

ড্যাশ চিহ্নিত দুটি সারি প্রথম পাতায় গোনা হয়নি; ছোট নমুনা-পাতায় সেগুলোর ফল §৪-এর চালানো যায় এমন কোডে। ফাঁকা জায়গা আর >-এর পার্থক্য (combinator) সবচেয়ে বেশি ভুল হয়: li button বলে “li-এর ভেতরে যেকোনো গভীরতার button”, আর li > button বলে “li-এর ঠিক সরাসরি সন্তান button”. বাজারঘরে button আছে form-এর ভেতরে, তাই দ্বিতীয়টি ০টি মেলাবে। আর একটি সূক্ষ্ম ব্যাপার: :nth-child(2) গোনে সব ভাই-বোনকে, শুধু একই class-এর ভাই-বোনকে নয়।

নিচের stepper-এ একটি লক্ষ্য থেকে শুরু করে ধাপে ধাপে selector সরু করা দেখুন। প্রতিটি সংখ্যা বাজারঘরের সত্যিকারের পাতায় গোনা:

1<ul class="grid">2 <li class="card"3   data-product-id="1">4  <a>মিনিকেট চাল ৫ কেজি</a>5  <button6   data-testid="add-to-cart">7   কার্টে যোগ করুন8   <span>: মিনিকেট…</span>
এই মুহূর্তে
ধরন
মিল
ঠিক element?
  1. শুধু ট্যাগ। লক্ষ্য: চালের “কার্টে যোগ করুন” বোতাম। button লিখলে প্রথম পাতায় ১২টি মিল: ১১টি পণ্যের বোতাম আর ওপরের “খুঁজুন”। চা পাতার স্টক নেই, তাই তার বোতাম নেই।
  2. Test id যোগ। [data-testid=add-to-cart] খোঁজার বোতাম বাদ দিল, কিন্তু ১১টি পণ্যের বোতামেই একই test id. Test id বলে “কোন ধরনের element”, “কোন পণ্যের” নয়।
  3. Card দিয়ে সরু করা। আগে card বাছুন (data-product-id="1"), তারপর তার ভেতরের বোতাম। ১টি মিল, পণ্য ১. Card-এর id আসে database থেকে, তাই নকশা বদলালেও বদলায় না।
  4. Role আর নাম। একই বোতাম, ব্যবহারকারীর ভাষায়: role button, নাম দৃশ্যমান লেখা আর লুকানো span মিলে। Edge-এর হিসাবে কোলনের আগে একটি ফাঁকা আছে; এই রূপে ১টি মিল, ফাঁকা ছাড়া ০টি।
  5. XPath দিয়ে। “যে li-এর ভেতরে ‘মিনিকেট চাল ৫ কেজি’ লেখা লিংক আছে, তার ভেতরের button”. ১টি মিল, পণ্য ১. লেখার ওপর নির্ভর করে, তাই পণ্যের নাম বদলালে এটি ভাঙবে।

৪ · XPath — axis, text() আর contains()

XPath XML-এর গাছে পথ লেখার একটি ভাষা; W3C ১৯৯৯ সালে XPath 1.0 প্রকাশ করে। পরে 2.0, 3.0, 3.1 এসেছে, কিন্তু browser আজও শুধু 1.0 চালায় (document.evaluate দিয়ে), তাই UI test-এ সেটুকুই কাজে লাগে। Selenium-এর শুরুর দিন থেকে XPath tester-দের খুব প্রিয়, কারণ এটি এমন কিছু পারে যা পুরোনো CSS পারত না: লেখা দিয়ে খোঁজা, আর গাছে ওপরের দিকে ওঠা।

অংশউদাহরণমানে
// আর ///li/formযেকোনো গভীরতা; ঠিক এক স্তর
Attribute//li[@data-product-id='1']@ দিয়ে attribute
text()//a[text()='মসুর ডাল ১ কেজি']নিজের লেখা হুবহু মেলে
contains()//button[contains(., 'কার্টে')]. মানে ভেতরের সব লেখা একসাথে
normalize-space()//p[normalize-space(.)='স্টক নেই']দুই পাশের আর মাঝের বাড়তি ফাঁকা বাদ
Axisancestor::li, parent::*, following-sibling::p, preceding-sibling::pগাছে ওপরে, পাশে বা নিচে হাঁটা
Index(//button)[2]সব মিলের দ্বিতীয়টি; সংখ্যা ১ থেকে শুরু

XPath-এর দুটি ফাঁদ চিনে রাখুন। প্রথমত, /html/body/main/ul/li[1]/form/button-এর মতো absolute path: বাজারঘরে এটি আজ ১টি মিল দেয়, কিন্তু ওপরের যেকোনো ধাপে একটি div ঢুকলে ভাঙবে। দ্বিতীয়ত, text() আর .-এর পার্থক্য: text() দেখে element-এর নিজের সরাসরি লেখার টুকরো, ভেতরের ট্যাগের লেখা নয়; . দেখে ভেতরের সব লেখা জোড়া লাগিয়ে। বাজারঘরের বোতামে . মানে “কার্টে যোগ করুন: মিনিকেট…”, পুরোটা।

CSS না XPath — কখন কোনটি

প্রশ্নCSSXPath 1.0
পড়তে সহজসাধারণত হ্যাঁ, developer-রা চেনেনলম্বা হলে কঠিন
লেখা দিয়ে খোঁজানেই (tool-এর নিজের যোগ, যেমন Playwright-এর :has-text())text(), contains()
ওপরের দিকে ওঠা:has() দিয়ে আংশিকancestor::, parent::
Shadow DOM-এর ভেতরেPlaywright-এর CSS খোলা shadow root-এ ঢোকেঢোকে না
ভালো ব্যবহারattribute আর test id দিয়ে ছোট selectorলেখার পাশের element ধরা, যেমন একটি লেবেলের পাশের ঘর

এবার নিজে চালান। নিচের কোড একটি ছোট নমুনা-পাতায় (বাজারঘরের তিনটি card: চাল, ডাল আর স্টক-শেষ চা) চলে; ওপরে নমুনা-পাতাটি দেখা যাবে। প্রতিটি CSS selector আর XPath-এর মিল গোনা হয়, তারপর একটি shadow DOM যোগ করে দেখা হয় document-এর খোঁজা কতদূর পৌঁছায়:

// Count matches for CSS selectors and XPath on the mini page above
function xpath(expr) {
  return document.evaluate(expr, document, null,
    XPathResult.ORDERED_NODE_SNAPSHOT_TYPE, null).snapshotLength;
}
const css = (sel) => document.querySelectorAll(sel).length;
const tries = [
  ['css  ', 'button'],
  ['css  ', '#q'],
  ['css  ', '.card'],
  ['css  ', '[data-testid="add-to-cart"]'],
  ['css  ', '[data-product-id="2"] button'],
  ['css  ', 'ul.grid > li:nth-child(2) button'],
  ['css  ', '.card:has([data-testid="out-of-stock"])'],
  ['xpath', '//button'],
  ['xpath', "//button[contains(., 'কার্টে')]"],
  ['xpath', "//a[text()='মসুর ডাল ১ কেজি']/ancestor::li//button"],
  ['xpath', "//p[text()='স্টক নেই']/preceding-sibling::p"],
  ['xpath', '/html/body/ul/li[1]/form/button'],
];
for (const [kind, sel] of tries) {
  const n = kind === 'xpath' ? xpath(sel) : css(sel);
  console.log(String(n).padStart(2), kind, sel);
}
// Shadow DOM: a button inside a shadow root is hidden from document queries
const host = document.createElement('bg-coupon');
document.body.append(host);
host.attachShadow({ mode: 'open' }).innerHTML = '<button>কুপন লাগান</button>';
console.log('after adding <bg-coupon> with a shadow root:');
console.log(' document button       :', css('button'));
console.log(' xpath //button        :', xpath('//button'));
console.log(' shadowRoot button     :', host.shadowRoot.querySelectorAll('button').length);

আসল আউটপুট:

 3 css   button
 1 css   #q
 3 css   .card
 2 css   [data-testid="add-to-cart"]
 1 css   [data-product-id="2"] button
 1 css   ul.grid > li:nth-child(2) button
 1 css   .card:has([data-testid="out-of-stock"])
 3 xpath //button
 2 xpath //button[contains(., 'কার্টে')]
 1 xpath //a[text()='মসুর ডাল ১ কেজি']/ancestor::li//button
 1 xpath //p[text()='স্টক নেই']/preceding-sibling::p
 1 xpath /html/body/ul/li[1]/form/button
after adding <bg-coupon> with a shadow root:
 document button       : 3
 xpath //button        : 3
 shadowRoot button     : 1

নমুনা-পাতায় বোতাম ৩টি (খুঁজুন, চাল, ডাল), তাই button আর //button দুটোই ৩. contains(., 'কার্টে') ২টি দিল, কারণ খোঁজার বোতামে “কার্টে” নেই। :has() “স্টক নেই” থাকা একমাত্র card, অর্থাৎ চা, খুঁজে পেয়েছে; XPath-এর preceding-sibling::p “স্টক নেই”-এর আগের ভাই p.price ধরেছে। শেষ তিন লাইন shadow DOM-এর মূল কথা: <bg-coupon>-এর ভেতরের বোতামটি পাতায় দেখা যায়, কিন্তু document-এর খোঁজায় তা নেই (এখনো ৩টি); তাকে পেতে shadowRoot-এর ভেতরে আলাদা করে খুঁজতে হয়। নিজে চেষ্টা করুন: tries-এ ['css ', 'li > button'] যোগ করে চালান; কত আসে, কেন?

৫ · ভালো locator বাছাই — test id, role, label, লেখা

একটি element-এ পৌঁছানোর পথ অনেক; প্রশ্ন হলো কোনটি বাছবেন। তিনটি পরীক্ষা যথেষ্ট। এক: ঠিক একটি element মেলে কি না (একের বেশি মিললে tool বিভ্রান্ত, শূন্য মিললে test আটকে যায়)। দুই: সঠিক element মেলে কি না (একটি মিলই যথেষ্ট নয়, সেটি ভুলও হতে পারে)। তিন: app-এর নকশা বদলালে টিকে থাকে কি না, অথচ app-এর আসল আচরণ বদলালে ধরা পড়ে কি না। শেষ শর্তটিই কঠিন: একটি ভালো locator UI-র রঙ বা বিন্যাস বদলে চুপ থাকে, কিন্তু বোতাম হারিয়ে গেলে লাল হয়।

Playwright-এর নিজস্ব locator এই চিন্তা থেকেই বানানো: get_by_role, get_by_label, get_by_placeholder, get_by_text, get_by_alt_text, get_by_title আর get_by_test_id. সাধারণ নিয়মে সবগুলো লেখার অংশ মেলায় (ছোট-বড় হাতের অক্ষর না দেখে); হুবহু মেলাতে exact=True. get_by_test_id ডিফল্টে data-testid attribute দেখে, যা দলের পছন্দমতো বদলানো যায়। Testing Library-র ধারণা থেকে আসা “ব্যবহারকারী যেভাবে দেখেন সেভাবে খুঁজুন” নীতি ফুল-স্ট্যাক ওয়েব ফ্রেমওয়ার্ক কোর্সের পর্ব ৭৬-এ developer-এর দিক থেকে আলোচিত; এখানে tester-এর দিক থেকে একটি ক্রম:

স্তরLocatorকেনদুর্বলতা
১Test id (data-testid), দরকারে card দিয়ে সরুTest-এর জন্য স্থির চুক্তি; নকশা আর লেখা বদলালেও টেকেব্যবহারকারী দেখেন না; বোতামের নাম হারালেও সবুজ
১Role + accessible nameব্যবহারকারীর চোখে খোঁজে; accessibility-র ছোট যাচাইলেখা বা অনুবাদ বদলালে ভাঙে
২Label, placeholderForm-এর ঘরের জন্য স্বাভাবিকPlaceholder label-এর বিকল্প নয়
২লেখা (get_by_text)লেখা অংশ, শিরোনাম, বার্তা খোঁজাএকই লেখা বহু জায়গায়; লুকানো লেখাও মেলে
৩ছোট CSS বা XPath, স্থির attribute দিয়েউপরের কোনোটি না থাকলেAttribute-এর মান কে বদলায়, জানা দরকার
এড়ানলম্বা CSS শিকল, nth-child, index, absolute XPath, স্বয়ংক্রিয় class (.css-1x9f2)DevTools সহজে দেয়গঠন বা ক্রম বদলালে ভাঙে, কখনো নীরবে

প্রথম স্তরে দুটি কেন? এখানে দলগুলোর মধ্যে সত্যিকারের মতভেদ আছে। Playwright-এর নথি আর Testing Library role-কে আগে রাখে, test id-কে শেষ উপায় বলে, কারণ test id দেখে না ব্যবহারকারী কী পান। অনেক automation দল উল্টো ভাবে: test id একটি লিখিত চুক্তি, developer জানেন এটি সরালে test ভাঙবে, আর অনুবাদ বা লেখা বদলালেও এটি টেকে। বাজারঘরে দুটোই আছে, তাই নীতি হলো: খোঁজার জন্য যেটি বেশি স্থির, যাচাইয়ের জন্য যেটি ব্যবহারকারীর কাছাকাছি। যেমন test id দিয়ে card ধরুন, আর assertion-এ দেখুন বোতামের নাম ঠিক আছে কি না।

Strict mode আর সরু করা

Playwright-এ একটি locator দিয়ে ক্লিক বা টাইপ করলে ঠিক একটি element মিলতে হয়; একাধিক মিললে কাজ না করে error দেয়। একে বলে strict mode. Selenium-এর find_element এমন অবস্থায় চুপচাপ প্রথমটি নেয়, যা ভুল element-এ ক্লিকের কারণ হতে পারে। একাধিক মিল হলে সরু করার উপায়: card বেছে তার ভেতরে খোঁজা (chaining), filter(has_text=…), বা role-এর সাথে নাম। .first বা .nth(1) দিয়ে চুপ করানো সহজ, কিন্তু সেটি আবার অবস্থান-নির্ভরতা ফিরিয়ে আনে।

  1. Test idcard 1 → add-to-cartস্তর ১
  2. Role + নামbutton "…করুন : মিনিকেট…"স্তর ১
  3. লেখাget_by_textস্তর ২
  4. XPath, নাম দিয়ে//li[.//a[…]]//buttonস্তর ৩
  5. CSS শিকলli:nth-child(1) > form > buttonএড়ান
  6. Indexli:nth-child(2) buttonএড়ান
Test id, card দিয়ে সরুআগে · বদল A · বদল B
মিল: 1 · 1 · 1   (সবসময় পণ্য 1)
একা add-to-cart: 11টি মিল → strict mode error
রায়: খোঁজার জন্য সবচেয়ে স্থির
Role + accessible nameআগে · বদল A · বদল B
মিল: 1 · 1 · 0   (বদল B = লেখা বদল)
শুধু "কার্টে যোগ করুন": 11টি (অংশ মেলে)
exact=True: 0 (নামে লুকানো অংশ আছে)
রায়: ব্যবহারকারীর ভাষা; লেখা বদলালে ভাঙে
get_by_text("কার্টে যোগ করুন")প্রথম পাতা
মিল: 11, exact=True হলে 0
"সয়াবিন" দিয়ে: 2 (লিংক + লুকানো span)
রায়: বার্তা আর শিরোনামের জন্য ভালো,
      বোতামের জন্য নয়
XPath, পণ্যের নাম দিয়েআগে · বদল A · বদল B
মিল: 1 · 1 · 1
গঠন বা বোতামের লেখা বদলালেও টিকেছে
কিন্তু পণ্যের নাম বদলালে ভাঙবে
রায়: চলে, তবে লম্বা আর পড়তে কঠিন
ul.grid > li:nth-child(1) > form > buttonআগে · বদল A
মিল: 1 · 0
বদল A-র পরে ক্লিক:
Locator.click: Timeout 2000ms exceeded.
রায়: জোরে ভাঙে — অন্তত চোখে পড়ে
ul.grid li:nth-child(2) buttonউদ্দেশ্য: ডাল (পণ্য 2)
আগে:   1 মিল → পণ্য 2 (ডাল) ✓
বদল A: 1 মিল → পণ্য 1 (চাল) ✗
কোনো error নেই; test ভুল পণ্য কার্টে দেয়
রায়: সবচেয়ে বিপজ্জনক — নীরবে ভুল
  1. স্তর ১, test id. একা add-to-cart ১১টি মেলে, তাই ক্লিক করলে strict mode error. Card (data-product-id="1") দিয়ে সরু করলে তিনটি অবস্থাতেই ১টি মিল, সবসময় চাল। বদল A মানে template-এর গঠন বদল, বদল B মানে বোতামের লেখা বদল (§৭)।
  2. স্তর ১, role আর নাম। পুরো নাম দিয়ে ১টি মিল, গঠন বদলেও টেকে। বোতামের লেখা “কার্টে রাখুন” হলে ০: ভাঙা, কিন্তু যুক্তিসঙ্গত, কারণ ব্যবহারকারীর দেখা লেখাই বদলেছে। শুধু “কার্টে যোগ করুন” দিলে নামের অংশ মেলে বলে ১১টি।
  3. স্তর ২, লেখা। get_by_text ১১টি মেলায়, আর exact=True দিলে ০, কারণ বোতামের লেখায় লুকানো অংশও আছে। “সয়াবিন” খুঁজলে ২টি: চোখে দেখা লিংক আর চোখে না-দেখা লুকানো span. লেখা-locator বার্তা আর শিরোনামের জন্য ভালো, বোতামের জন্য নয়।
  4. স্তর ৩, XPath পণ্যের নাম ধরে। তিন অবস্থাতেই ১টি মিল, চাল। এটি কাজ করে, কিন্তু নির্ভর করে পণ্যের নামের ওপর, যা দোকানের data বদলালে বদলাতে পারে। Test id বা role না থাকলে যুক্তিসঙ্গত বিকল্প।
  5. এড়ান, CSS শিকল। প্রতিটি > একটি অনুমান: li-এর সরাসরি সন্তান form, তার সরাসরি সন্তান button. একটি div ঢুকতেই ০টি মিল, আর ক্লিক ২ সেকেন্ড অপেক্ষা করে Timeout দিল। খারাপ, তবে অন্তত শব্দ করে ভাঙে।
  6. এড়ান, index. উদ্দেশ্য ছিল ডাল, দ্বিতীয় card. ওপরে একটি promo card বসতেই দ্বিতীয় card হলো চাল। মিল এখনো ১টি, কোনো error নেই, test চাল কার্টে দিয়ে এগিয়ে যায়। এমন নীরব ভুল সবচেয়ে বিপজ্জনক: test সবুজ, অথচ যা যাচাই করার কথা ছিল তা হয়নি।

৬ · সত্যিকারের run — Playwright দিয়ে বাজারঘরে match গোনা

এই পর্বের সব browser run একটি Windows ডেস্কটপে, আলাদা scratch ফোল্ডারে: Python 3.12, Playwright for Python 1.65.2 (Apache-2.0 লাইসেন্স), আর কম্পিউটারে আগে থেকে থাকা Microsoft Edge 157, headless অবস্থায় (জানালা ছাড়া)। Playwright-এর নিজস্ব browser নামানো হয়নি; channel="msedge" install করা Edge ব্যবহার করে। বাজারঘরের app (FastAPI, MIT) চলেছে 127.0.0.1:8791-এ, test mode-এ, নিজের database ফাইলে। Path নিরপেক্ষ করা (~/bazarghar-qa). কোনো বাইরের website ছোঁয়া হয়নি।

cd ~/bazarghar-qa
uv pip install playwright          # 1.65.2; browser download not needed
uv run bazarghar --port 8791 --test-mode --reset &
python locate.py before

Script-টি codegen ছাড়া হাতে লেখা; প্রতিটি locator-এর মিল গোনে, আর মিল ঠিক ১টি হলে card-এর data-product-id দেখে বলে কোন পণ্যে পৌঁছাল। মূল অংশ:

from playwright.sync_api import sync_playwright, Error as PWError
RICE = "মিনিকেট চাল ৫ কেজি"

def report(label, loc):
    n = loc.count()                      # how many elements match now
    who = ""
    if n == 1:
        card = loc.locator("xpath=ancestor::li[@data-product-id][1]")
        if card.count() == 1:
            who = " -> product " + card.get_attribute("data-product-id")
    print(f"{n:>3}  {label}{who}")

with sync_playwright() as p:
    browser = p.chromium.launch(channel="msedge", headless=True)
    page = browser.new_page()
    page.goto("http://127.0.0.1:8791/")
    report("get_by_test_id('add-to-cart')", page.get_by_test_id("add-to-cart"))
    report("role=button, name='কার্টে যোগ করুন'",
           page.get_by_role("button", name="কার্টে যোগ করুন"))
    report("role=button, name='…করুন : ' + RICE",
           page.get_by_role("button", name="কার্টে যোগ করুন : " + RICE))
    report("card[data-product-id=1] >> add-to-cart",
           page.locator('[data-testid=product-card][data-product-id="1"]')
               .get_by_test_id("add-to-cart"))
    report("css ul.grid li:nth-child(2) button",
           page.locator("css=ul.grid li:nth-child(2) button"))
    # … more strategies, then the strict-mode click and the Bangla text check
    browser.close()

সত্যিকারের আউটপুট; মাঝের strict mode আর বাংলা লেখার অংশ নিচে আলাদা দেখানো হয়েছে:

playwright 1.65.2 | msedge 157 headless
--- home page (before) ---
 11  get_by_test_id('add-to-cart')
 11  role=button, name='কার্টে যোগ করুন'
  0  same, exact=True
  0  role=button, name='…করুন: মিনিকেট চাল ৫ কেজি'
  1  role=button, name='…করুন : মিনিকেট চাল ৫ কেজি' -> product 1
  1  card[data-product-id=1] >> add-to-cart -> product 1
  1  card.filter(has_text=RICE) >> button -> product 1
  1  css ul.grid > li:nth-child(1) > form > button -> product 1
  1  css ul.grid li:nth-child(2) button -> product 2
  1  xpath //li[.//a[text()='মিনিকেট চাল ৫ কেজি']]//button -> product 1
 11  xpath //button[contains(., 'কার্টে')]
--- product page ---
  1  get_by_label('পরিমাণ')
  1  role=heading level=1
    heading text: মিনিকেট চাল ৫ কেজি
  1  role=searchbox name='পণ্য খুঁজুন'
  1  get_by_placeholder('চাল, ডাল')
    rating-average: 4.3

লক্ষ করুন: আজকের পাতায় সাতটি locator ঠিক চালের বোতামে পৌঁছায়, আর nth-child(2) ঠিক ডালে। আজ সবাই “কাজ করে”; পার্থক্য দেখা যাবে কাল, যখন পাতা বদলাবে (§৭)। পণ্যের পাতায় get_by_label("পরিমাণ") পরিমাণের <select> খুঁজে পেয়েছে, কারণ <label for="qty"> ঘরটির সাথে জোড়া। গড় রেটিং “4.3” এসেছে test id থেকে; এটি সেই ৪.২৫ যা half up নিয়মে ৪.৩ হয় (পর্ব ১৫-এর AC5).

Strict mode-এর বার্তা পড়া

একা get_by_test_id("add-to-cart")-এ ক্লিক করতে বললে Playwright ক্লিক করেনি। সত্যিকারের বার্তার প্রথম ছয় লাইন:

Locator.click: Error: strict mode violation: get_by_test_id("add-to-cart") 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="কার্টে যোগ করুন : মসুর ডাল ১ কেজি")
    3) <button type="submit" data-testid="add-to-cart">…</button> aka get_by_role("button", name="কার্টে যোগ করুন : সয়াবিন তেল ৫ লিটার")
    4) <button type="submit" data-testid="add-to-cart">…</button> aka get_by_role("button", name="কার্টে যোগ করুন : সরিষার তেল ১ লিটার")
    5) <button type="submit" data-testid="add-to-cart">…</button> aka get_by_role("button", name="কার্টে যোগ করুন : চিনি ১ কেজি")

এই বার্তা একটি উপহার। এটি শুধু বলে না “১১টি মিলেছে”; প্রতিটির জন্য একটি বিকল্প locator (aka) প্রস্তাব করে, যেখানে accessible name হুবহু লেখা, কোলনের আগের ফাঁকাসহ। §২-এর চমকটি এখান থেকেই ধরা পড়েছিল। পর্ব ২১-এ pytest-এর ব্যর্থতার বার্তার মতো এখানেও, বার্তা মন দিয়ে পড়াই অর্ধেক debugging.

৭ · Locator কীভাবে ভাঙে — template বদলালে

একটি UI test-এর ভঙ্গুরতা সাধারণত app-এর ভুল থেকে আসে না, আসে পাতার স্বাভাবিক বদল থেকে: designer card-এ একটি wrapper যোগ করলেন, marketing একটি অফারের ব্যানার চাইল, copywriter বোতামের লেখা বদলালেন। এই পর্বে নিজের কপি করা app-এর home.html template-এ ঠিক এমন দুটি বদল করা হলো (শেয়ার করা মূল app ছোঁয়া হয়নি):

 <ul class="grid" data-testid="product-list">
+{% if not q %}<li class="card promo" data-testid="promo">
+  <h2 class="card-title">আজকের অফার</h2>
+  <p>১০০০ টাকার বেশি কিনলে ১০% ছাড়</p></li>{% endif %}
 …
+      <div class="actions">
-    <button type="submit" data-testid="add-to-cart">কার্টে যোগ করুন…
+    <button type="submit" data-testid="add-to-cart">কার্টে রাখুন…
+      </div>

বদল A: তালিকার শুরুতে একটি promo card আর প্রতিটি বোতামের চারপাশে একটি div. বদল B: বোতামের লেখা “কার্টে যোগ করুন” থেকে “কার্টে রাখুন”। কোনো ব্যবসায়িক নিয়ম বদলায়নি; একজন ব্যবহারকারী আগের মতোই চাল কার্টে দিতে পারেন। একই script আবার চালানো হলো। বদল A-র পরে সত্যিকারের আউটপুট:

--- home page (after-A) ---
 11  get_by_test_id('add-to-cart')
 11  role=button, name='কার্টে যোগ করুন'
  1  role=button, name='…করুন : মিনিকেট চাল ৫ কেজি' -> product 1
  1  card[data-product-id=1] >> add-to-cart -> product 1
  1  card.filter(has_text=RICE) >> button -> product 1
  0  css ul.grid > li:nth-child(1) > form > button
  1  css ul.grid li:nth-child(2) button -> product 1
  1  xpath //li[.//a[text()='মিনিকেট চাল ৫ কেজি']]//button -> product 1
Locator.click: Timeout 2000ms exceeded.

বদল B (লেখা বদল) যোগ করার পরে যা বদলাল:

--- home page (after-B) ---
 11  get_by_test_id('add-to-cart')
  0  role=button, name='কার্টে যোগ করুন'
  0  role=button, name='…করুন : মিনিকেট চাল ৫ কেজি'
  1  card[data-product-id=1] >> add-to-cart -> product 1
  1  card.filter(has_text=RICE) >> button -> product 1
  0  css ul.grid > li:nth-child(1) > form > button
  1  css ul.grid li:nth-child(2) button -> product 1
  1  xpath //li[.//a[text()='মিনিকেট চাল ৫ কেজি']]//button -> product 1
1<ul class="grid">2+ <li class="card promo">3  <li … data-product-id="1">4   <form>5+   <div class="actions">6     <button data-testid=7       "add-to-cart">8~      কার্টে রাখুন
locator → মিল (পণ্য)
nth-child(2)
CSS শিকল
role + নাম
card + test id
  1. আজকের পাতা। চারটি locator-ই নিজের লক্ষ্যে পৌঁছায়: nth-child(2) ডালে (পণ্য ২), বাকি তিনটি চালে (পণ্য ১)। এই অবস্থায় কোনটি ভালো, বাইরে থেকে বোঝার উপায় নেই।
  2. Promo card বসল। তালিকার প্রথম সন্তান এখন promo, তাই দ্বিতীয় সন্তান চাল। nth-child(2) এখনো ১টি মিল দেয়, কিন্তু ভুল পণ্যে। Error নেই; “ডাল কার্টে দিন” test চাল দিয়ে এগোয়, আর পরের assertion হয়তো কোথাও অদ্ভুতভাবে লাল হয়, বা আরও খারাপ, হয় না।
  3. Wrapper div বসল। form > button আর সত্য নয়, মাঝে div. CSS শিকল ০টি মেলায়; ক্লিক ২ সেকেন্ড অপেক্ষা করে Timeout 2000ms exceeded. শব্দ করে ভাঙা, তাই অন্তত কেউ দেখবেন।
  4. লেখা বদলাল। “কার্টে রাখুন” হওয়ায় role আর নামের locator ০টি মেলায়। এটি ভাঙা, কিন্তু অর্থপূর্ণ: ব্যবহারকারীর দেখা লেখা সত্যিই বদলেছে, product owner জানেন কি না যাচাই করা দরকার। Card আর test id-এর locator তিনটি বদলেই চালে পৌঁছেছে।
  5. মেরামত। ভাঙা বা নীরবে ভুল locator-গুলো card আর test id-ভিত্তিক করা হলো, আর লেখার যাচাই রাখা হলো assertion-এ। সব locator এক জায়গায় (page object, পর্ব ৩৯) থাকলে এই মেরামত এক লাইনের কাজ, পঞ্চাশটি test-এ খোঁজাখুঁজি নয়।

একই পরীক্ষা নিজে চালিয়ে দেখুন। নিচের কোড নমুনা-পাতায় পাঁচটি locator চালায়, তারপর JavaScript দিয়ে ঠিক বদল A আর বদল B ঘটায়। Role আর নামের হিসাব browser-এর বাইরে JavaScript-এ পাওয়া যায় না, তাই এখানে তার বদলে বোতামের textContent দিয়ে একটি মোটা দাগের বিকল্প:

// Five locators; two template changes; which product does each one hit?
const q = (sel) => [...document.querySelectorAll(sel)];
const xp = (expr) => {
  const r = document.evaluate(expr, document, null, 7, null);   // 7 = snapshot
  return Array.from({ length: r.snapshotLength }, (_, i) => r.snapshotItem(i));
};
const locators = {   // the test means: "add RICE (product 1) to the cart"
  'testid in card 1': () => q('[data-product-id="1"] [data-testid="add-to-cart"]'),
  'text starts with': () => q('button').filter((b) =>
    b.textContent.startsWith('কার্টে যোগ করুন: মিনিকেট')),   // stand-in for role+name
  'css chain       ': () => q('ul.grid > li:nth-child(1) > form > button'),
  'xpath by name   ': () => xp("//li[.//a[text()='মিনিকেট চাল ৫ কেজি']]//button"),
  'nth-child(2) dal': () => q('ul.grid li:nth-child(2) button'),  // meant: dal
};
function check(stage) {
  console.log('--- ' + stage);
  for (const [name, find] of Object.entries(locators)) {
    const ids = find().map((b) => b.closest('li').dataset.productId);
    console.log(name, ids.length, ids.length ? '-> product ' + ids : '(not found)');
  }
}
check('before');
// change A (structure): a promo card first, each button wrapped in a <div>
q('ul.grid')[0].insertAdjacentHTML('afterbegin',
  '<li class="card promo"><h2>আজকের অফার</h2></li>');
q('[data-testid="add-to-cart"]').forEach((b) => {
  const d = document.createElement('div');
  b.before(d); d.append(b);
});
check('after change A');
// change B (copy): the button label becomes "কার্টে রাখুন"
q('[data-testid="add-to-cart"]').forEach((b) => { b.firstChild.data = 'কার্টে রাখুন'; });
check('after change B');

আসল আউটপুট:

--- before
testid in card 1 1 -> product 1
text starts with 1 -> product 1
css chain        1 -> product 1
xpath by name    1 -> product 1
nth-child(2) dal 1 -> product 2
--- after change A
testid in card 1 1 -> product 1
text starts with 1 -> product 1
css chain        0 (not found)
xpath by name    1 -> product 1
nth-child(2) dal 1 -> product 1
--- after change B
testid in card 1 1 -> product 1
text starts with 0 (not found)
css chain        0 (not found)
xpath by name    1 -> product 1
nth-child(2) dal 1 -> product 1

ব্রাউজারের এই ছোট মডেল আর বাজারঘরে Playwright-এর সত্যিকারের run একই গল্প বলে। CSS শিকল বদল A-তে ০; লেখা-নির্ভর locator বদল B-তে ০; card আর test id সব অবস্থায় পণ্য ১; আর nth-child(2) বদল A থেকে পণ্য ১ ধরে, যদিও উদ্দেশ্য ছিল ডাল (পণ্য ২)। “১টি মিল” তাই সাফল্যের প্রমাণ নয়; মিলটি কোন element, সেটিও যাচাই করতে হয়। নিজে চেষ্টা করুন: বদল A-তে promo card-এ একটি data-product-id="99" যোগ করুন; কোন locator-এর ফল বদলায়?

আরও কয়েকটি চেনা ভাঙার কারণ

  • স্বয়ংক্রিয় id আর class: অনেক UI framework চলার সময় id="input-4821" বা class="css-1x9f2a" বানায়, যা প্রতিটি build-এ বদলায়। এগুলো কখনো locator-এ নয়।
  • A/B test আর feature flag: একই পাতার দুটি রূপ একসাথে চলে; একটি locator এক রূপে মেলে, অন্যটিতে নয়, ফলে test কখনো পাস কখনো ফেল, অর্থাৎ flaky (পর্ব ৪০)।
  • অনুবাদ: বাংলা আর ইংরেজি UI-তে লেখা আলাদা; লেখা-locator এক ভাষায় বাঁধা।
  • সময়ের সাথে আসা element: বাজারঘরের cart badge ৪০০ মিলিসেকেন্ড পরে বদলায়। Locator ঠিক থাকলেও তখনই পড়লে পুরোনো মান আসে; অপেক্ষার নিয়ম পর্ব ৩৬-এর বিষয়।

৮ · Shadow DOM, iframe আর বাংলা লেখা

Shadow DOM

কিছু component নিজের ভেতরের গাছ লুকিয়ে রাখে shadow DOM-এ, যাতে পাতার CSS ভেতরে না ঢোকে। §৪-এর কোডে দেখেছেন, document.querySelectorAll ভেতরে পৌঁছায় না। Tool-ভেদে নিয়ম আলাদা: Playwright-এর নথি অনুযায়ী তার CSS আর role-locator খোলা (open) shadow root-এ নিজে থেকেই ঢোকে, কিন্তু XPath ঢোকে না, আর বন্ধ (closed) shadow root সমর্থিত নয়। Selenium 4-এ host element-এর shadow_root নিয়ে তার ভেতরে খুঁজতে হয়। তাই কোনো পাতায় XPath হঠাৎ ০ দিলে, element-টি shadow DOM-এ কি না DevTools-এ দেখে নিন (Elements প্যানেলে #shadow-root লেখা থাকে)।

iframe

iframe হলো পাতার ভেতরে আরেকটি পূর্ণ পাতা, নিজের DOM-সহ। বাইরের পাতার কোনো selector ভেতরে পৌঁছায় না। পেমেন্টের ঘর, মানচিত্র বা চ্যাট উইজেট প্রায়ই iframe-এ থাকে। Playwright-এ আগে frame ধরতে হয়, যেমন page.frame_locator("#pay-frame").get_by_label("কার্ড নম্বর"); Selenium-এ driver.switch_to.frame(…) দিয়ে ঢুকে কাজ শেষে আবার বের হতে হয় (পর্ব ৩৮)। বাজারঘরের নকল payment gateway app-এর ভেতরেই, তাই এখানে iframe নেই; কিন্তু বাস্তবের checkout test-এ এটি সাধারণ বাধা।

বাংলা লেখায় locator

বাংলার কয়েকটি অক্ষর Unicode-এ দুইভাবে লেখা যায়। “য়” হতে পারে একটি code point (U+09DF), বা “য” (U+09AF) আর নুক্তা “়” (U+09BC) মিলে দুটি। “ড়” আর “ঢ়”-এর ক্ষেত্রেও তাই। চোখে দুটো হুবহু এক, কিন্তু কম্পিউটারের তুলনায় আলাদা। বাজারঘর নামগুলো রাখে দুই-অংশের রূপে। সত্যিকারের run-এ get_by_text দিয়ে “সয়াবিন” খোঁজা হলো দুই বানানে:

--- Bangla text: two spellings of 'সয়াবিন' ---
  2  get_by_text(য+়)
  0  get_by_text(য় U+09DF)

দুই-অংশের রূপে ২টি মিল (লিংক আর লুকানো span), এক-অংশের রূপে ০টি। কোনো কোনো বাংলা keyboard বা লেখা রূপান্তরের tool এক-অংশের রূপ তৈরি করে; কেউ সেখান থেকে লেখা কপি করে test-এ বসালে test ব্যর্থ হবে, অথচ চোখে কোনো পার্থক্য নেই। Playwright লেখা মেলানোর আগে ফাঁকা জায়গা গুছিয়ে নেয়, কিন্তু Unicode-এর রূপ মেলায় না। সমাধান হলো Unicode normalization: তুলনার আগে দুই দিকের লেখাকে একই মানক রূপে আনা। নিচের কোড Python-এর unicodedata দিয়ে তা দেখায়:

import unicodedata as ud

YA, NUKTA, YYA = chr(0x9AF), chr(0x9BC), chr(0x9DF)   # য, ়, য়
DDA, RRA, ZWNJ = chr(0x9A1), chr(0x9DC), chr(0x200C)  # ড, ড়, zero-width
stored = "স" + YA + NUKTA + "াবিন তেল ৫ লিটার"   # how the app stores it
typed = "স" + YYA + "াবিন তেল"                  # য় typed as one code point

def cps(s):
    return " ".join(f"{ord(c):04X}" for c in s[:4])

print("stored:", cps(stored))
print("typed :", cps(typed))
print("typed in stored?", typed in stored)
for form in ("NFC", "NFD"):
    a, b = ud.normalize(form, typed), ud.normalize(form, stored)
    print(f"{form}: match={a in b}, typed -> {cps(a)}")

def norm(s):
    """NFC + collapse whitespace, the way a careful locator compares."""
    return " ".join(ud.normalize("NFC", s).split())

cases = [
    ("double space", "স" + YA + NUKTA + "াবিন  তেল", stored),
    ("rra one cp", "গুঁ" + RRA + "া দুধ", "গুঁ" + DDA + NUKTA + "া দুধ ৫০০ গ্রাম"),
    ("digits", "৫ লিটার", "সয়াবিন তেল 5 লিটার"),
    ("ZWNJ", "চাল" + ZWNJ, "মিনিকেট চাল ৫ কেজি"),
]
for label, want, page in cases:
    print(f"{label:<13} raw={str(want in page):<5} norm={norm(want) in norm(page)}")

আসল আউটপুট:

stored: 09B8 09AF 09BC 09BE
typed : 09B8 09DF 09BE 09AC
typed in stored? False
NFC: match=True, typed -> 09B8 09AF 09BC 09BE
NFD: match=True, typed -> 09B8 09AF 09BC 09BE
double space  raw=False norm=True
rra one cp    raw=False norm=True
digits        raw=False norm=False
ZWNJ          raw=False norm=False

প্রথম দুই লাইনে দুই বানানের code point: app-এ 09AF 09BC (য + নুক্তা), টাইপ করা লেখায় একটি 09DF. সরাসরি তুলনা False. চমকটি তৃতীয় অংশে: NFC (সাধারণত “জোড়া লাগানো” রূপ) করার পরেও টাইপ করা “য়” ভেঙে দুই অংশ হয়েছে। কারণ Unicode এই তিনটি বাংলা অক্ষরকে (ড়, ঢ়, য়) “composition exclusion” তালিকায় রেখেছে: NFC-তেও এরা দুই-অংশের রূপে থাকে। তাই এখানে NFC আর NFD একই ফল দেয়। norm() দ্বিগুণ ফাঁকা আর “ড়”-এর বানান-পার্থক্য সামলায়। কিন্তু দুটি ফাঁদ normalization সারায় না: বাংলা অঙ্ক “৫” আর ইংরেজি “5” আলাদা অক্ষর (একটিকে অন্যটিতে বদলানো ব্যবসায়িক সিদ্ধান্ত, normalization-এর কাজ নয়), আর অদৃশ্য ZWNJ (U+200C) থেকে যায়। এমন লেখা ঢোকে কপি-পেস্টে; DevTools-এ code point দেখে ধরুন।

ব্যবহারিক নিয়ম তিনটি। এক, test-এর লেখা app-এর source বা DOM থেকে কপি করুন, অন্য document থেকে নয়। দুই, নিজের helper-এ লেখা তুলনার আগে NFC আর ফাঁকা গুছানো; দরকার হলে Playwright-এর get_by_text-এ normalize করা লেখা দিন। তিন, যেখানে সম্ভব লেখার বদলে test id বা role ব্যবহার করুন, যাতে বানানের প্রশ্নই না ওঠে। বাংলা লেখার ভুল খোঁজার কৌশল পর্ব ১৪-এ এসেছিল; font, তারিখ আর সংখ্যাসহ পুরো localization testing পর্ব ৫৬-এ।

আরও গভীরে: Locator-এর ভঙ্গুরতা নিয়ে গবেষণাও হয়েছে। Web test-এর রক্ষণাবেক্ষণ নিয়ে কয়েকটি একাডেমিক গবেষণা (যেমন Leotta ও সহকর্মীদের ২০১০-এর দশকের কাজ) দেখিয়েছে, ভাঙা test-এর বড় অংশের কারণ locator, আর absolute XPath সবচেয়ে ভঙ্গুর; সংখ্যাগুলো প্রকল্পভেদে আলাদা, তাই নির্দিষ্ট হার না ধরে প্রবণতাটি মনে রাখুন। এ থেকে এসেছে “robust locator” তৈরির অ্যালগরিদম আর আজকের “self-healing” tool, যা একটি locator ভাঙলে বিকল্প attribute দিয়ে element খুঁজে নেয়। সুবিধা হলো কম ভাঙা test; ঝুঁকি হলো tool নীরবে ভুল element বেছে নিতে পারে, ঠিক §৭-এর nth-child-এর মতো, তাই self-healing-এর প্রতিটি “মেরামত” মানুষের review চায়।

পরীক্ষা ও ইন্টারভিউতে:

  • CSS selector আর XPath-এর পার্থক্য? CSS ছোট আর দ্রুত পড়া যায়; XPath লেখা দিয়ে খোঁজে আর ancestor::-এর মতো axis দিয়ে ওপরে উঠতে পারে, কিন্তু shadow DOM-এ ঢোকে না।
  • Absolute আর relative XPath? /html/body/… শুরু থেকে পুরো পথ, গঠন বদলালেই ভাঙে; //li[@data-product-id='1']//button attribute ধরে, অনেক মজবুত।
  • ভালো locator-এর ক্রম? Test id বা role + নাম, তারপর label ও লেখা, তারপর ছোট CSS; index আর লম্বা শিকল এড়ানো।
  • একটি locator একাধিক element মেলালে? Playwright strict mode error দেয়; Selenium-এর find_element প্রথমটি নেয়। সমাধান: parent দিয়ে সরু করা বা filter.
  • iframe-এর ভেতরের element? আগে frame-এ ঢোকা: Playwright-এ frame_locator, Selenium-এ switch_to.frame.

৯ · AI-এর যুগে — AI দিয়ে locator লেখানো

“এই পাতার জন্য Playwright test লিখে দাও” বললে AI সহকারী কয়েক সেকেন্ডে কোড দেয়, কিন্তু locator-এ তার চেনা ভুলগুলো আসে: পাতা না দেখে কল্পিত id বা class বানানো; DevTools-এর মতো লম্বা CSS শিকল বা absolute XPath; একাধিক মিল এড়াতে .first বা nth(0); element দেরিতে আসবে ভেবে sleep বসানো; বাংলা লেখা নিজের মতো টাইপ করা, ফলে অন্য Unicode রূপ; শুধু সুখী পথ (happy path); আর না চালিয়েই “test পাস করবে” দাবি। AI-কে আসল HTML দিন, নিয়ম বেঁধে দিন, আর ফল নিজে চালিয়ে যাচাই করুন।

AI-কে পাতার আসল HTML আর locator-এর নীতি দিন:

তুমি একজন অভিজ্ঞ UI automation tester. নিচে বাজারঘরের প্রথম পাতার একটি product card-এর আসল HTML দিলাম (কপি করা, বদলাবে না)। Playwright for Python-এ চালের "কার্টে যোগ করুন" বোতাম আর তার দামের জন্য locator লিখবে। নিয়ম: ১. শুধু HTML-এ সত্যিই থাকা attribute ব্যবহার করবে; কোনো id বা class অনুমান করবে না। ২. ক্রম: data-testid দিয়ে card ধরে তার ভেতরে খোঁজা, বা get_by_role + accessible name; লম্বা CSS শিকল, nth-child, index আর absolute XPath নয়। ৩. .first, .nth() বা sleep ব্যবহার করবে না। ৪. বাংলা লেখা HTML থেকে হুবহু কপি করবে, নিজে টাইপ করবে না। ৫. প্রতিটি locator-এর পাশে লিখবে কয়টি element মেলার কথা আর কেন; তুমি পাতায় চালাওনি, তাই "পাস করবে" দাবি করবে না। [এখানে card-এর HTML]

AI-এর লেখা locator হাতে পেলে — চেকলিস্ট

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

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

প্র ০১Selenium-যুগে XPath বনাম CSS নিয়ে বহু বছরের তর্ক ছিল। ইতিহাস থেকে আজকের locator বাছাইয়ে কী শিখবেন?

Selenium-এর শুরু ২০০৪ সালের দিকে, ThoughtWorks-এ Jason Huggins-এর একটি অভ্যন্তরীণ tool হিসেবে, যা browser-এর ভেতরে JavaScript চালিয়ে পাতা নিয়ন্ত্রণ করত। তখন পাতার element খোঁজার শক্তিশালী ভাষা বলতে ছিল XPath, যা W3C ১৯৯৯ সালে প্রকাশ করে; CSS selector-এর তখনকার রূপ ছিল সীমিত, লেখা দিয়ে খোঁজা বা গাছে ওপরে ওঠার উপায় ছিল না। ফলে প্রথম প্রজন্মের automation tester-রা XPath-এ অভ্যস্ত হলেন, আর record করা test-এ অবস্থানভিত্তিক XPath ভরে গেল।

সমস্যা দেখা দিল দুই দিক থেকে। প্রথমত, পুরোনো Internet Explorer-এ নিজস্ব XPath ছিল না, তাই tool-কে JavaScript-এ লেখা ধীর XPath ব্যবহার করতে হতো; অনেক দলের অভিজ্ঞতায় সেখানে XPath চোখে পড়ার মতো ধীর ছিল। দ্বিতীয়ত, /html/body/div[3]/table/tr[2]/td[4] ধাঁচের পথ প্রতিটি নকশা বদলে ভাঙত। এর প্রতিক্রিয়ায় “CSS ব্যবহার করুন” পরামর্শ জনপ্রিয় হয়; অনেকে ভাবলেন সমস্যার মূল XPath ভাষাটি।

আসলে মূল সমস্যা ছিল কী ধরে locator লেখা হচ্ছে, কোন ভাষায় নয়। এই পর্বের সত্যিকারের run-এ ul.grid > li:nth-child(1) > form > button (CSS) ভেঙেছে, অথচ //li[.//a[text()='মিনিকেট চাল ৫ কেজি']]//button (XPath) তিনটি বদলেই টিকেছে। অবস্থান ধরলে দুই ভাষাই ভঙ্গুর; অর্থপূর্ণ attribute বা লেখা ধরলে দুটোই মজবুত। আধুনিক browser-এ গতির পার্থক্যও বেশিরভাগ test-এ নগণ্য, কারণ সময় যায় পাতা লোড আর অপেক্ষায়।

আজকের role আর test id-ভিত্তিক locator এই শিক্ষারই পরের ধাপ: ভাষার তর্ক ছেড়ে পরিচয় ধরে খোঁজা। দলের নিয়মে তাই লিখুন “কোন attribute বা গুণ ধরে খুঁজব”, “কোন ভাষায়” নয়; আর ভাষা বাছুন পড়ার সুবিধা দেখে।

মূল উপলব্ধি: Locator-এর মজবুতি আসে সে কী ধরে তা থেকে: অবস্থান ভঙ্গুর, পরিচয় স্থির। CSS বনাম XPath গৌণ প্রশ্ন।

প্র ০২Test id কি production-এ পাঠানো উচিত? “ব্যবহারকারীর মতো খোঁজা” আর “স্থির চুক্তি”-র দ্বন্দ্ব কীভাবে মেটাবেন?

Testing Library ২০১৮ সালের দিকে Kent C. Dodds-এর একটি নীতি জনপ্রিয় করে: test যত বেশি সফটওয়্যারের আসল ব্যবহারের মতো, তত বেশি আস্থা দেয়। তাই সেখানে query-র ক্রমে role আর label আগে, data-testid শেষে। Playwright-এর নথিও role-locator-কে প্রথম পছন্দ বলে। যুক্তি শক্ত: test id দিয়ে খুঁজলে বোতামের নাম মুছে গেলেও test সবুজ থাকে, অথচ screen reader ব্যবহারকারী বোতামটি আর চিনতে পারেন না।

অন্য দিকে বাস্তব দলের চাপও আছে। বাংলা আর ইংরেজি দুই ভাষার UI, ঘন ঘন লেখা বদল, A/B test: এমন app-এ লেখা-নির্ভর locator প্রতি সপ্তাহে ভাঙে। Test id একটি লিখিত চুক্তি: developer জানেন data-testid="place-order" সরালে test ভাঙবে, তাই code review-তে প্রশ্ন ওঠে। এই পর্বের run-এ বোতামের লেখা বদলাতেই role-locator ০ দিয়েছে, test id দেয়নি।

Production-এ পাঠানো নিয়ে দুই মত। পক্ষে: production-এর smoke test আর synthetic monitoring (পর্ব ৬৬) একই locator ব্যবহার করতে পারে; HTML-এ কয়েকটি attribute-এর খরচ নগণ্য। বিপক্ষে: পাতার আকার সামান্য বাড়ে, আর test id-তে অভ্যন্তরীণ নাম (যেমন “legacy-payment-v2”) ফাঁস হতে পারে। কিছু দল build-এর সময় attribute মুছে ফেলে; তখন production-এ সেই test চলবে না, এটি মেনে নিতে হয়।

দ্বন্দ্ব মেটানোর একটি ব্যবহারিক উপায়: খোঁজায় স্থিরতা, যাচাইয়ে ব্যবহারকারীর দৃষ্টি। Card ধরুন test id দিয়ে, আর assertion-এ বলুন “এই card-এর ভেতরে ‘কার্টে যোগ করুন’ নামের একটি বোতাম আছে”। তাহলে নকশা বদলে test টেকে, কিন্তু নাম হারালে লাল হয়। পাশাপাশি accessibility-র পূর্ণ যাচাই আলাদা tool দিয়ে (পর্ব ৫৪)।

মূল উপলব্ধি: Test id আর role প্রতিদ্বন্দ্বী নয়; একটি খোঁজে, অন্যটি যাচাই করে। কোনটি কোথায়, দলের লিখিত নিয়মে স্পষ্ট রাখুন।

প্র ০৩Record-and-playback tool বারবার জনপ্রিয় হয়েছে, আবার হতাশও করেছে। আজকের codegen আর AI-এর সাথে তুলনা করুন।

UI automation-এর ইতিহাসে একটি চক্র বারবার ফেরে। একটি tool আসে যা ব্যবহারকারীর ক্লিক record করে test বানায়; শুরুতে সবাই মুগ্ধ, কয়েক মাস পরে test-গুলো ভাঙতে থাকে, আর দল আবার হাতে লেখায় ফেরে। Selenium IDE (প্রথমে একটি Firefox extension) এমনই একটি tool ছিল; বাণিজ্যিক জগতেও record-and-playback ধাঁচের tool বহু বছর ধরে চলেছে। ভাঙার প্রধান কারণ প্রায় সবসময় একই: record করা locator ছিল অবস্থান-নির্ভর, আর test-এ ছিল না কোনো উদ্দেশ্য, শুধু ক্লিকের ক্রম।

আজকের Playwright-এর codegen আরও বুদ্ধিমান: ক্লিক record করার সময় সম্ভব হলে get_by_role আর নাম, বা test id প্রস্তাব করে। এই পর্বের strict mode বার্তার aka get_by_role(…) লাইনও একই ভাবনার ফল। তবু codegen জানে না আপনার উদ্দেশ্য কী: “চালের বোতাম” চেয়েছেন, নাকি “প্রথম পণ্যের বোতাম”? দুটো আজকের পাতায় একই element, কিন্তু কাল আলাদা। আর codegen assertion লেখে না যা নিয়ম থেকে আসে; সে শুধু যা ঘটল তা লেখে।

AI সহকারী এই চক্রের নতুন রূপ। সে পাতা না দেখেও আত্মবিশ্বাসী locator লিখতে পারে, আর তার ভুল record-এর চেয়েও কঠিন ধরা, কারণ কোড পরিপাটি দেখায়। কল্পিত id, লম্বা শিকল, sleep: সবই এই পর্বের চেকলিস্টে।

শিক্ষা হলো, tool খসড়া দেয়, নকশা দেয় না। একজন tester-এর কাজ তিনটি: (১) উদ্দেশ্য অনুযায়ী locator বাছা, (২) assertion নিয়ম থেকে লেখা, আর (৩) ইচ্ছা করে পাতা বদলে (wrapper, promo, লেখা) দেখা test কী করে। এই পর্বের মতো একটি ছোট “ভাঙন-মহড়া” যেকোনো উৎসের locator-এর মান বিচারের সবচেয়ে সস্তা উপায়।

মূল উপলব্ধি: Record, codegen বা AI, যেখান থেকেই আসুক, locator-কে পাতা বদলে পরীক্ষা না করা পর্যন্ত তা একটি অনুমান মাত্র।

প্র ০৪Role-ভিত্তিক locator accessibility-র ওপর দাঁড়িয়ে। এতে testability আর accessibility কীভাবে একে অপরকে সাহায্য করে, আর সীমা কোথায়?

Accessibility tree মূলত সহায়ক প্রযুক্তির জন্য: screen reader, switch device, voice control. W3C-র WAI-ARIA আর “Accessible Name and Description Computation” (AccName; এর 1.1 সংস্করণ ২০১৮ সালের দিকে W3C Recommendation হয়) নির্ধারণ করে কোন element-এর role আর নাম কী হবে। Test tool যখন এই গাছ ধরে খোঁজে, তখন একটি সুন্দর মিল ঘটে: যে পাতা automation-এর জন্য সহজে খোঁজা যায়, সেটি একজন দৃষ্টিপ্রতিবন্ধী ব্যবহারকারীর জন্যও সাধারণত বেশি ব্যবহারযোগ্য। Label ছাড়া ঘর get_by_label-এ পাওয়া যায় না, আর screen reader-ও তার নাম বলতে পারে না।

বাজারঘরে এর একটি স্পষ্ট উদাহরণ a11y_missing_label নামের বসানো ভুল। এটি চালু করলে খোঁজার ঘরের label মুছে যায়; ঘরটি চোখে আগের মতোই, কিন্তু get_by_role("searchbox", name="পণ্য খুঁজুন") আর তাকে পাবে না। ফলে একটি সাধারণ UI test অজান্তে একটি accessibility regression ধরে ফেলে।

তবে সীমাও স্পষ্ট। এক, role-locator শুধু সেই element দেখে যা test ছোঁয়; পাতার বাকি অংশের রঙের contrast, keyboard দিয়ে চলাচল, focus-এর ক্রম সে যাচাই করে না। দুই, accessible name tool আর browser-ভেদে সামান্য আলাদা হতে পারে, যেমন এই পর্বের কোলনের আগের ফাঁকা: লুকানো span-এর CSS-এর কারণে Edge নামের মাঝে একটি ফাঁকা বসিয়েছে, যা HTML পড়ে বোঝা যায় না। তিন, ARIA-র ভুল ব্যবহার (যেমন div-এ role="button" দিয়ে keyboard সমর্থন না দেওয়া) role-locator-কে খুশি করে, কিন্তু ব্যবহারকারীকে নয়।

তাই role-locator-কে accessibility-র “ধোঁয়া পরীক্ষা” (smoke check) ভাবুন: সস্তা, প্রতিটি run-এ, কিন্তু অসম্পূর্ণ। পূর্ণ যাচাইয়ের জন্য axe-এর মতো স্বয়ংক্রিয় tool, keyboard-এ হাতে পরীক্ষা আর আসল সহায়ক প্রযুক্তির ব্যবহারকারী লাগে (পর্ব ৫৪)।

মূল উপলব্ধি: ভালো accessibility ভালো testability দেয়, আর role-locator তার একটি অংশ পাহারা দেয়; কিন্তু পাহারাদার পুরো বাড়ির নিরাপত্তা নয়।

প্র ০৫বাংলা লেখার Unicode-এর ইতিহাস কীভাবে আজকের test-এ ফাঁদ তৈরি করে?

Unicode আসার আগে বাংলা কম্পিউটারে লেখা হতো মূলত নিজস্ব ASCII-ভিত্তিক font-এ: কি-বোর্ডের একটি ইংরেজি অক্ষরের জায়গায় font একটি বাংলা আকার এঁকে দিত। এই লেখা দেখতে বাংলা, কিন্তু ভেতরে ইংরেজি অক্ষরের সারি; অন্য font-এ খুললে অর্থহীন। Unicode-এ বাংলার নিজস্ব code point আসার পর ধীরে ধীরে সেই পুরোনো লেখা রূপান্তর করতে হয়েছে, আর আজও পুরোনো document, PDF বা ছবি থেকে লেখা তুলতে গেলে নানা রূপ মিশে যায়।

Unicode নিজেও কিছু দ্বৈততা রেখেছে। “ড়”, “ঢ়” আর “য়” আলাদা code point হিসেবে আছে, আবার মূল অক্ষর আর নুক্তা দিয়েও লেখা যায়। Unicode-এর normalization-এর নিয়ম (Unicode Standard Annex #15) স্থিতিশীলতার নীতিতে বাঁধা: একবার কোনো অক্ষরের রূপান্তর ঠিক হলে তা আর বদলায় না। এই তিন বাংলা অক্ষর “composition exclusion” তালিকায়, তাই NFC-তেও এরা দুই-অংশে ভাঙে, যা এই পর্বের Python কোডে দেখেছেন। বেশিরভাগ ইংরেজি-ভাষী developer এমন খুঁটিনাটি জানেন না, ফলে বাংলা লেখা তুলনার কোডে ভুল থেকে যায়।

Test-এ এই ইতিহাস তিনভাবে ফাঁদ বসায়। এক, test-এর expected লেখা কেউ Word বা চ্যাট থেকে কপি করলেন, যেখানে অন্য রূপ; test লাল, অথচ পর্দায় কোনো পার্থক্য নেই। দুই, অদৃশ্য অক্ষর (ZWNJ, ZWJ) কিছু যুক্তাক্ষরের রূপ নিয়ন্ত্রণে কাজে লাগে, তাই সরানোও সবসময় নিরাপদ নয়। তিন, অঙ্ক: বাজারঘর ফোন নম্বরে বাংলা অঙ্ক নেয় না, কিন্তু পণ্যের নামে “৫ কেজি” বাংলা অঙ্কে; একটি locator-এ “5 কেজি” লিখলে মিলবে না।

করণীয়: test data আর expected লেখা app-এর নিজের উৎস থেকে নেওয়া; লেখার তুলনা একটি helper দিয়ে (NFC আর ফাঁকা গুছানো), যা দলের সবাই ব্যবহার করে; আর app-এর দিকেও প্রশ্ন তোলা, ইনপুট সংরক্ষণের আগে normalize হয় কি না। নইলে একই পণ্য দুই বানানে দুবার database-এ ঢুকতে পারে, আর খোঁজায় একটি পাওয়া যাবে না। এটি তখন আর locator-এর সমস্যা নয়, app-এর defect.

মূল উপলব্ধি: বাংলা লেখা চোখে এক হলেও ভেতরে আলাদা হতে পারে; তুলনার আগে normalize করা, আর লেখা উৎস থেকে কপি করা, বাংলা UI test-এর মৌলিক অভ্যাস।

অনুশীলন

উত্তর দেখার আগে কাগজে নিজে করুন। সব মিলের সংখ্যা সত্যিকারের run থেকে।

  1. Spec থেকে locator-এর নকশা: বাজারঘরের checkout পাতায় আছে: “জেলা” label-সহ একটি <select>, “ঠিকানা” label-সহ textarea, “মোবাইল নম্বর” label-সহ ফোনের ঘর, “পেমেন্ট পদ্ধতি” fieldset-এ তিনটি radio (ক্যাশ, কার্ড, মোবাইল ওয়ালেট), মোট দামের ঘর (data-testid="quote-total") আর “অর্ডার করুন” বোতাম। “মোবাইল ওয়ালেটে ঢাকায় অর্ডার” test-এর জন্য প্রতিটির locator লিখুন, আর বলুন কোনটিতে সাবধান হতে হবে।
    page.get_by_label("জেলা")                         # 1
    page.get_by_label("ঠিকানা")                       # 1
    page.get_by_label("মোবাইল নম্বর")                 # 1
    page.get_by_role("radio", name="মোবাইল ওয়ালেট")  # 1
    page.get_by_test_id("quote-total")                # 1
    page.get_by_role("button", name="অর্ডার করুন")   # 1

    সত্যিকারের run-এ (mitu লগইন, কার্টে একটি পণ্য) প্রতিটির মিল ঠিক ১. ফাঁদটি ফোনের ঘরে: get_by_label("মোবাইল") লিখলে ২টি মিল, কারণ লেখার অংশ মেলে আর “মোবাইল ওয়ালেট” radio-র label-ও “মোবাইল” দিয়ে শুরু। পুরো label দিন, বা exact=True. একইভাবে get_by_role("combobox") ২টি দেয় (জেলা আর ডেলিভারির সময়), নাম দিলে ১. মোট দামের জন্য test id ভালো, কারণ সংখ্যাটি বদলায় আর তার কোনো স্থির নাম নেই; তবে মান পড়ার আগে ৪০০ মিলিসেকেন্ডের দেরি মাথায় রাখুন (পর্ব ৩৬)।

  2. আউটপুট অনুমান করুন: §৪-এর নমুনা-পাতায় (খোঁজার ঘর ও বোতাম; চাল আর ডালের card-এ “কার্টে যোগ করুন” বোতাম, ভেতরে লুকানো span; চায়ের card-এ বোতাম নেই, “স্টক নেই”) প্রতিটির মিল কত? (ক) li button (খ) //li[3]//button (গ) //button[normalize-space(text())='কার্টে যোগ করুন'] (ঘ) //button[normalize-space(.)='কার্টে যোগ করুন'] (ঙ) //a[contains(text(),'ডাল')]/../following-sibling::p

    Edge-এ চালানো ফল: (ক) ২; খোঁজার বোতাম li-এর ভেতরে নয়। (খ) ০; তৃতীয় li চা, তার বোতাম নেই। (গ) ২; text() শুধু বোতামের নিজের প্রথম লেখার টুকরো দেখে, লুকানো span-এর লেখা নয়। (ঘ) ০; . সব লেখা জোড়া লাগায়, তাই “কার্টে যোগ করুন: মিনিকেট…”, হুবহু মেলে না। (ঙ) ১; ডালের লিংক থেকে parent h2, তার পরের ভাই p.price. (গ) আর (ঘ)-এর পার্থক্যই XPath-এ সবচেয়ে বেশি ভুল বোঝা বিষয়।

  3. Test-এ ভুল খুঁজুন: একজন সহকর্মী “ডাল কার্টে দেওয়া” test লিখলেন; গত সপ্তাহে সবুজ, এই সপ্তাহে কখনো লাল, কখনো সবুজ, আর একবার কার্টে চাল দেখা গেছে। চারটি সমস্যা খুঁজুন।
    page.goto(BASE + "/")
    time.sleep(3)
    page.locator("xpath=/html/body/main/ul/li[2]/form/button").click()
    time.sleep(1)
    assert page.locator(".badge.css-7f3a2c").inner_text() == "1"
    assert page.get_by_text("সয়াবিন তেল").count() == 2   # typed by hand

    (১) Absolute XPath আর index li[2]: ওপরে promo card বসলে দ্বিতীয় li চাল হয়ে যায়, তাই কার্টে চাল; লিখুন page.locator('[data-product-id="2"]').get_by_test_id("add-to-cart"). (২) time.sleep: ধীর CI-তে ৩ সেকেন্ড কম, দ্রুত যন্ত্রে অপচয়; cart badge ৪০০ মিলিসেকেন্ড পরে বদলায়, ১ সেকেন্ডের ঘুম কখনো যথেষ্ট, কখনো নয়, তাই flaky. অপেক্ষা হওয়া উচিত শর্তে (পর্ব ৩৬-এর web-first assertion). (৩) .css-7f3a2c স্বয়ংক্রিয় class, build-এ বদলায়; লিখুন get_by_test_id("cart-count"). (৪) হাতে টাইপ করা “সয়াবিন”-এ “য়” এক code point হলে ০টি মিল, এই পর্বের সত্যিকারের run-এ ঠিক তাই হয়েছে; লেখা app থেকে কপি করুন বা NFC করুন। আর ২ সংখ্যাটি নির্ভর করছে লুকানো span-এর ওপর, যা একটি ভঙ্গুর অনুমান।

  4. Bug report-এ ভুল খুঁজুন: Template বদলের পরের nightly run দেখে লেখা: “শিরোনাম: কার্টে যোগ বোতাম কাজ করে না। Severity: Critical. ধাপ: test suite চালান। পাওয়া: Locator.click: Timeout 2000ms exceeded. প্রত্যাশা: পাস।” কী ভুল, আর কী করবেন?

    প্রথমে যাচাই করুন ভুলটি app-এর না test-এর। হাতে পাতা খুলে চালের বোতাম চাপুন: কার্টে যোগ হয় কি না। এই ক্ষেত্রে হয়; Timeout এসেছে কারণ CSS শিকল li:nth-child(1) > form > button নতুন div-এর পরে ০টি মেলে। তাহলে এটি app-এর defect নয়, test-এর রক্ষণাবেক্ষণের কাজ; Critical severity আর “বোতাম কাজ করে না” শিরোনাম ভুল পথে নিয়ে যায়, developer সময় নষ্ট করবেন। করণীয়: test-এর ticket খুলুন (“template-এ wrapper div যোগের পরে add-to-cart-এর CSS locator ভেঙেছে”), কোন commit-এ বদল তা দিন, locator card আর test id-ভিত্তিক করুন। আর যদি হাতে চেষ্টাতেও বোতাম কাজ না করত, তখন রিপোর্টে লাগত সঠিক ধাপ (কোন পাতা, কোন পণ্য), browser ও version, প্রত্যাশা নিয়ম থেকে, আর screenshot বা trace; “test suite চালান” ধাপ নয় (পর্ব ১৮)।

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

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

ক্রমএকটি UI element-এর জন্য মজবুত locator তৈরির ধাপগুলো সঠিক ক্রমে সাজান (▲▼ চেপে সরান)

  1. Test-এর উদ্দেশ্য ঠিক করা: কোন element, কেন (যেমন “চালের কার্টে যোগ বোতাম”)
  2. DevTools-এ DOM আর accessibility tree দেখে test id, role আর নাম খোঁজা
  3. সবচেয়ে স্থির পরিচয় দিয়ে locator লেখা, দরকারে parent দিয়ে সরু করা
  4. আসল পাতায় চালিয়ে মিল ঠিক ১টি আর সঠিক element কি না দেখা
  5. Template বদলে (wrapper, নতুন card, লেখা) locator টেকে কি না যাচাই
  6. Locator এক জায়গায় (page object) রেখে test-গুলোতে ব্যবহার

একটি পাতায় ১১টি পণ্যের card, প্রতিটিতে একই data-testid="add-to-cart" বোতাম। Playwright-এ page.get_by_test_id("add-to-cart").click() চালালে কী হবে?

  • প্রথম বোতামে ক্লিক হবে
  • ১১টি বোতামেই একে একে ক্লিক হবে
  • Strict mode violation error, ক্লিক হবে না
  • Timeout হবে, কারণ element পাওয়া যায়নি

একটি তালিকার দ্বিতীয় পণ্য ধরতে লেখা হয়েছে ul.grid li:nth-child(2) button. পরে তালিকার শুরুতে একটি promo card যোগ হলো, যাতে কোনো বোতাম নেই। কী ঘটবে?

  • ০টি মিল, test Timeout-এ ভাঙবে
  • ১টি মিল, কিন্তু আগের প্রথম পণ্যের বোতাম; কোনো error নেই
  • ২টি মিল, strict mode error
  • একই পণ্যের বোতাম, কারণ selector নিজে মানিয়ে নেয়

একটি বোতামের HTML: <button>কার্টে যোগ করুন<span class="visually-hidden">: চাল</span></button>. XPath //button[normalize-space(.)='কার্টে যোগ করুন'] কয়টি মেলাবে, কেন?

  • ১টি, কারণ normalize-space লুকানো লেখা বাদ দেয়
  • ১টি, কারণ XPath শুধু দৃশ্যমান লেখা দেখে
  • Error, কারণ normalize-space-এ . দেওয়া যায় না
  • ০টি, কারণ .-তে লুকানো span-এর লেখাও যুক্ত হয়

একটি web component তার বোতাম রাখে খোলা (open) shadow root-এর ভেতরে। কোন কথাটি সঠিক?

  • Playwright-এর CSS locator বোতামটি পায়, XPath পায় না
  • document.querySelectorAll('button') বোতামটি গোনে
  • XPath সবসময় shadow DOM-এ ঢোকে
  • কোনো automation tool বোতামটি খুঁজতে পারে না

একটি app পণ্যের নামে “য়” রাখে য (U+09AF) + নুক্তা (U+09BC) হিসেবে। Test-এ লেখা “য়” এক code point (U+09DF). Python-এ দুই দিকেই unicodedata.normalize("NFC", …) করার পরে কী হয়?

  • দুটোই U+09DF হয়, মিলে যায়
  • দুটোই U+09AF U+09BC হয়, মিলে যায়
  • দুটো আলাদাই থাকে, মেলে না
  • Error, বাংলা অক্ষর normalize করা যায় না

একটি form-এ দুটি label: “মোবাইল নম্বর” (ফোনের ঘর) আর “মোবাইল ওয়ালেট” (একটি radio). Playwright-এ page.get_by_label("মোবাইল") কয়টি element মেলাবে?

  • ১টি, প্রথম label-এর ঘর
  • ০টি, কারণ হুবহু মেলে না
  • ২টি: ফোনের ঘর আর radio
  • ৪টি: দুটি label আর দুটি ঘর

কোন locator-টি পাতার বিন্যাস বদলে (wrapper div, নতুন card) সবচেয়ে বেশি টিকে থাকার সম্ভাবনা রাখে?

  • [data-product-id="1"] [data-testid="add-to-cart"]
  • ul.grid > li:nth-child(1) > form > button
  • /html/body/main/ul/li[1]/form/button
  • (//button)[2]

শব্দকোষ

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

মনে রাখুন

  1. দুটি গাছ: DOM-এ ট্যাগ আর attribute, accessibility tree-তে role আর accessible name; locator এর যেকোনো একটি ধরে খোঁজে।
  2. তিন পরীক্ষা: ঠিক একটি মিল, সঠিক element, আর নকশা বদলে টিকে থাকা; “১টি মিল” একা যথেষ্ট নয়।
  3. ক্রম: test id বা role + নাম, তারপর label ও লেখা, তারপর ছোট CSS/XPath; শিকল, index আর absolute XPath এড়ান।
  4. ভাঙন: শিকল জোরে ভাঙে (Timeout), index নীরবে ভুল ধরে; template বদলে locator-এর মহড়া দিন।
  5. বিশেষ ক্ষেত্র: shadow DOM-এ XPath ঢোকে না, iframe-এ আগে frame ধরা, আর বাংলা লেখা তুলনার আগে NFC ও ফাঁকা গুছানো।

পরের পর্বে: এই locator-গুলো দিয়ে বাজারঘরে সত্যিকারের Playwright test: browser, context আর page, ক্লিকের আগে actionability-র পরীক্ষা, auto-wait, আর ৪০০ মিলিসেকেন্ড দেরিতে বদলানো cart badge-এ তাড়াহুড়োর পড়া কীভাবে ব্যর্থ হয় আর expect কীভাবে পাস করে।

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

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