ব্রাউজার বাগ সম্পর্কে কীভাবে সঠিকভাবে অভিযোগ জানাবেন

ব্রাউজারে আপনি যেসব সমস্যা খুঁজে পান সেগুলি ব্রাউজার ভেন্ডরকে জানানো ওয়েব প্ল্যাটফর্মকে আরও উন্নত করার একটি অবিচ্ছেদ্য অংশ।

তবে, কোনও সমস্যা সম্পর্কে সঠিক তথ্য সহ অভিযোগ জানাতে একটু পরিশ্রম করতে হয়। আপনার লক্ষ্য হওয়া উচিত, ব্রাউজার ইঞ্জিনিয়ারদের জন্য যতটা সম্ভব সহজ করে তোলা যাতে তারা বুঝতে পারেন যে কোথায় সমস্যা হয়েছে, মূল কারণ খুঁজে বের করতে পারেন এবং সবচেয়ে গুরুত্বপূর্ণ হল, সমস্যা সমাধানের উপায় খুঁজে বের করতে পারেন। যেসব বাগ দ্রুত সমাধান করা যায় সেগুলি সাধারণত দ্রুত রিপ্রোডিউস করা যায় এবং সেগুলির প্রত্যাশিত আচরণ স্পষ্ট হয়।

এটি যে একটি সমস্যা তা যাচাই করুন

প্রথম ধাপ হল, "সঠিক" আচরণ কী হওয়া উচিত তা খুঁজে বের করা।

সঠিক আচরণ কী?

MDN-এ প্রাসঙ্গিক API ডকুমেন্ট চেক করুন অথবা সম্পর্কিত স্পেসিফিকেশন খোঁজার চেষ্টা করুন। এই তথ্য আপনাকে সিদ্ধান্ত নিতে সাহায্য করতে পারে যে কোন API আসলে কাজ করছে না, কোথায় কাজ করছে না এবং প্রত্যাশিত আচরণ কী।

এটি কি অন্য ব্রাউজারে কাজ করে?

বিভিন্ন ব্রাউজারে আলাদা আলাদা আচরণকে সাধারণত ইন্টারঅপারেবিলিটি সমস্যা হিসেবে বেশি অগ্রাধিকার দেওয়া হয়, বিশেষ করে যখন বাগ থাকা ব্রাউজারটি অন্যদের থেকে আলাদা হয়। Chrome, Firefox, Safari ও Edge-এর লেটেস্ট ভার্সনে পরীক্ষা করে দেখুন, সম্ভব হলে BrowserStack-এর মতো টুল ব্যবহার করুন।

সম্ভব হলে, ইউজার এজেন্ট স্নিফিংয়ের কারণে পৃষ্ঠাটি ইচ্ছাকৃতভাবে অন্যরকম আচরণ করছে কিনা তা চেক করুন। Chrome DevTools-এ, User-Agent স্ট্রিং অন্য ব্রাউজারে সেট করার চেষ্টা করুন।

এটি কি সাম্প্রতিক রিলিজে কাজ করা বন্ধ করে দিয়েছে?

এটি কি আগে প্রত্যাশা অনুযায়ী কাজ করেছে, কিন্তু সাম্প্রতিক ব্রাউজার রিলিজে কাজ করা বন্ধ করে দিয়েছে? এই ধরনের রিগ্রেশন অনেক দ্রুত সমাধান করা যেতে পারে, বিশেষ করে যদি আপনি এমন একটি ভার্সন নম্বর প্রদান করেন যেখানে এটি কাজ করেছে এবং একটি ভার্সন যেখানে এটি ব্যর্থ হয়েছে। পুরনো ব্রাউজার ভার্সন চেক করতে আপনি BrowserStack-এর মতো টুল ব্যবহার করতে পারেন। পরিবর্তন খুঁজতে bisect-builds টুল (Chromium-এর জন্য)-এর মতো টুল ব্যবহার করুন।

কোনও সমস্যা যদি রিগ্রেশন হয় এবং সেটি আবার তৈরি করা যায়, তাহলে সাধারণত মূল কারণ খুঁজে পাওয়া যায় এবং দ্রুত সমাধান করা যায়।

অন্যরাও কি একই সমস্যা দেখতে পাচ্ছেন?

আপনি যদি সমস্যার সম্মুখীন হন, তাহলে অন্যান্য ডেভেলপাররাও একই সমস্যার সম্মুখীন হতে পারেন। প্রথমে, Stack Overflow-তে বাগটি সার্চ করে দেখুন। এটি আপনাকে একটি বিমূর্ত সমস্যাকে একটি নির্দিষ্ট ভাঙা API-তে অনুবাদ করতে সাহায্য করতে পারে, এবং এটি আপনাকে বাগ ঠিক না হওয়া পর্যন্ত একটি স্বল্পমেয়াদী সমাধান খুঁজে পেতে সাহায্য করতে পারে।

এটি কি আগে রিপোর্ট করা হয়েছে?

সমস্যাটি কী তা বুঝতে পারলে, ব্রাউজার সমস্যা ডেটাবেস সার্চ করে দেখুন যে সমস্যাটি ইতিমধ্যেই রিপোর্ট করা হয়েছে কিনা।

আপনি যদি এমন কোনও আগে থেকে থাকা বাগ খুঁজে পান যা সমস্যার বিবরণ দেয়, তাহলে বাগটিতে স্টার, ফেভারিট বা কমেন্ট করে আপনার সমর্থন যোগ করুন। এছাড়াও, অনেক সাইটে, আপনি নিজেকে CC তালিকায় যোগ করতে পারবেন এবং বাগ পরিবর্তন হলে আপডেট পাবেন।

আপনি যদি বাগ সম্পর্কে মন্তব্য করার সিদ্ধান্ত নেন, তাহলে বাগটি কীভাবে আপনার ওয়েবসাইটকে প্রভাবিত করে সেই সম্পর্কে তথ্য অন্তর্ভুক্ত করুন। "+১" স্টাইলের কমেন্ট যোগ করা এড়িয়ে চলুন, কারণ বাগ ট্র্যাকার সাধারণত প্রতিটি কমেন্টের জন্য ইমেল পাঠায়।

বাগ সম্পর্কে অভিযোগ জানান

সমস্যাটি আগে রিপোর্ট করা না হলে, ব্রাউজার ভেন্ডরকে এই সম্পর্কে জানানোর সময় এসেছে।

মিনিমাইজ করা টেস্ট কেস তৈরি করুন

Mozilla-তে কীভাবে মিনিমাইজ করা টেস্ট কেস তৈরি করতে হয় সেই সম্পর্কে একটি দারুণ নিবন্ধ আছে। সংক্ষেপে বলতে গেলে, সমস্যার বিবরণ দেওয়াটা একটা ভালো শুরু হলেও, সমস্যাটি দেখায় এমন একটি লিঙ্ক করা ডেমো প্রদান করার চেয়ে ভালো আর কিছু হয় না। সমস্যাটি দ্রুত সমাধান করার সম্ভাবনা বাড়াতে, উদাহরণে সমস্যাটি দেখানোর জন্য প্রয়োজনীয় ন্যূনতম কোড থাকতে হবে। আপনার সমস্যাটি সমাধান করার সম্ভাবনা বাড়ানোর জন্য আপনি যে কাজটি করতে পারেন তা হল একটি ন্যূনতম কোড স্যাম্পেল প্রদান করা।

টেস্ট কেস মিনিমাইজ করার জন্য এখানে কিছু পরামর্শ দেওয়া হল:

  • ওয়েব পেজ ডাউনলোড করুন, <base href="https://original.url"> যোগ করুন এবং লোকাল ডিভাইসে বাগটি আছে কিনা তা যাচাই করুন। URL-এ HTTPS ব্যবহার করা হলে, এর জন্য লাইভ HTTPS সার্ভারের প্রয়োজন হতে পারে।
  • যতগুলি সম্ভব ব্রাউজারের লেটেস্ট বিল্ডে লোকাল ফাইলগুলি পরীক্ষা করুন।
  • সবকিছু ১টি ফাইলে সংক্ষিপ্ত করার চেষ্টা করুন।
  • বাগ দূর না হওয়া পর্যন্ত কোড (যেসব জিনিস অপ্রয়োজনীয় বলে আপনি জানেন সেগুলি দিয়ে শুরু করে) সরিয়ে দিন।
  • ভার্সন কন্ট্রোল ব্যবহার করুন যাতে আপনি নিজের কাজ সেভ করতে পারেন এবং কোনও ভুল হলে তা আগের অবস্থায় ফিরিয়ে আনতে পারেন।

একটি ছোট করা টেস্ট কেস হোস্ট করুন

আপনার মিনিফায়েড টেস্ট কেস হোস্ট করার জন্য কোনও ভালো জায়গা খুঁজলে, এখানে বেশ কয়েকটি ভালো জায়গা উপলভ্য আছে:

মনে রাখবেন, এইসব সাইটের মধ্যে কয়েকটি iframe-এ কন্টেন্ট দেখায়, যার ফলে ফিচার বা সমস্যা অন্যভাবে কাজ করতে পারে।

আপনার সমস্যা সম্পর্কে জানান

আপনার কাছে মিনিমাইজ করা টেস্ট কেস থাকলে, আপনি সেই বাগ ফাইল করার জন্য প্রস্তুত। সঠিক বাগ ট্র্যাকিং সাইটে যান এবং একটি নতুন সমস্যা তৈরি করুন।

স্পষ্ট বিবরণ এবং রেপ্লিকেট করার ধাপ যোগ করুন

প্রথমে, সমস্যাটি কী তা ইঞ্জিনিয়ারদের দ্রুত বুঝতে সাহায্য করার জন্য একটি স্পষ্ট বিবরণ প্রদান করুন এবং সমস্যাটি ট্রাইজ করতে সাহায্য করুন।

When installing a PWA using the `beforeinstallprompt.prompt()`, the
`appinstalled` event fires before the call to `prompt()` resolves.

এরপর, সমস্যাটি রিপ্রোডিউস করার জন্য প্রয়োজনীয় ধাপগুলি বিস্তারিতভাবে জানান এবং প্রত্যাশিত ও প্রকৃত ফলাফল বর্ণনা করুন।

What is the expected result? In the console:
0. INSTALL: Available (logged when `beforeinstallprompt` event fired)
1. INSTALL_PROMPT_RESPONSE: {outcome: "accepted", platform: "web"}
   (logged when beforeinstallprompt.prompt()` resolves)
2. INSTALL: Success (logged when `appinstalled` event fired)

What is the actual result? In the console:
0. INSTALL: Available (logged when `beforeinstallprompt` event fired)
1. INSTALL: Success (logged when `appinstalled` event fired)
2. INSTALL_PROMPT_RESPONSE: {outcome: "accepted", platform: "web"}
   (logged when beforeinstallprompt.prompt()` resolves)

আরও তথ্যের জন্য, MDN-এ বাগ রিপোর্ট লেখার নির্দেশিকা চেক করুন।

বোনাস: সমস্যার স্ক্রিনশট বা স্ক্রিনকাস্ট যোগ করুন

প্রয়োজন না হলেও, সমস্যার স্ক্রিনশট বা স্ক্রিনকাস্ট যোগ করলে প্রায়ই তা সহায়ক হয়। বেশ কয়েকটি ধাপ বা অস্বাভাবিক অ্যাক্টিভিটির পরে কোনও সমস্যা হলে, এটি বিশেষভাবে সহায়ক হয়। স্ক্রিনকাস্ট এবং স্ক্রিনশট প্রায়শই ব্রাউজার ইঞ্জিনিয়ারদের কাছে কী ঘটেছে তা আরও ভালভাবে দেখাতে পারে।

পরিবেশের বিবরণ অন্তর্ভুক্ত করুন

কিছু সমস্যা শুধুমাত্র নির্দিষ্ট অপারেটিং সিস্টেম বা নির্দিষ্ট ধরনের ডিসপ্লেতে (যেমন, কম-DPI বা বেশি-DPI) দেখা যায়। আপনার ব্যবহার করা যেকোনও টেস্ট এনভায়রনমেন্টের বিবরণ অন্তর্ভুক্ত করতে ভুলবেন না।

বাগ জমা দিন

সবশেষে, সমস্যাটি জমা দিন। সমস্যার উত্তর পেতে আপনার ইমেলে নজর রাখুন। সাধারণত, তদন্ত চলাকালীন ইঞ্জিনিয়ারদের আরও প্রশ্ন থাকতে পারে। সমস্যাটি পুনরায় তৈরি করতে অসুবিধা হলে, তারা আপনার সাথে যোগাযোগ করতে পারেন।