chrome.debugger

বর্ণনা

অনুমতি

এই এপিআইটি ব্যবহার করার জন্য আপনাকে আপনার এক্সটেনশনের ম্যানিফেস্টে "debugger" পারমিশনটি অবশ্যই ঘোষণা করতে হবে।

{
  "name": "My extension",
  ...
  "permissions": [
    "debugger",
  ],
  ...
}

এন্টারপ্রাইজ নীতি সীমাবদ্ধতা

এন্টারপ্রাইজ ডিভাইসগুলিতে, কিছু পলিসি অ্যাটাচ করার সময় ( chrome.debugger.attach() ) একটি অল-অর-নাথিং মডেল ব্যবহার করে এক্সটেনশনগুলিকে ডিবাগার অ্যাটাচ করা থেকে সীমাবদ্ধ করতে পারে:

• হোস্ট সীমাবদ্ধতা: যদি এন্টারপ্রাইজ পলিসি ExtensionSettings কোনো এক্সটেনশনের জন্য ব্লক করা হোস্ট ( runtime_blocked_hosts ) কনফিগার করে, তাহলে chrome.debugger.attach() সমস্ত টার্গেটে "Host access is restricted by policy." ত্রুটি সহ ব্লক হয়ে যায় (এমনকি যদি স্বতন্ত্র অরিজিনগুলো runtime_allowed_hosts এর মধ্যে থাকে)।
• স্ক্রিনশট এবং ডিএলপি পলিসি: যদি এন্টারপ্রাইজ পলিসি ' DisableScreenshots স্ক্রিনশট ক্যাপচার নিষ্ক্রিয় করে রাখে অথবা টার্গেটের উপর ডেটা লস প্রিভেনশন (ডিএলপি) নিয়ম প্রযোজ্য হয়, তাহলে chrome.debugger.attach() "Screenshot capture is restricted by policy." ত্রুটি দেখিয়ে ব্যর্থ হয়।

ধারণা এবং ব্যবহার

একবার সংযুক্ত হয়ে গেলে, chrome.debugger API আপনাকে একটি নির্দিষ্ট টার্গেটে Chrome DevTools Protocol (CDP) কমান্ড পাঠাতে দেয়। এই ডকুমেন্টেশনে CDP-এর বিস্তারিত ব্যাখ্যা দেওয়া সম্ভব নয়—CDP সম্পর্কে আরও জানতে অফিসিয়াল CDP ডকুমেন্টেশন দেখুন।

লক্ষ্য

টার্গেট হলো এমন কিছু যা ডিবাগ করা হচ্ছে—এর মধ্যে একটি ট্যাব, একটি আইফ্রেম বা একটি ওয়ার্কার অন্তর্ভুক্ত থাকতে পারে। প্রতিটি টার্গেট একটি UUID দ্বারা চিহ্নিত হয় এবং এর সাথে একটি সংশ্লিষ্ট টাইপ (যেমন iframe , shared_worker , ইত্যাদি) থাকে।

একটি টার্গেটের মধ্যে একাধিক এক্সিকিউশন কনটেক্সট থাকতে পারে—উদাহরণস্বরূপ, একই প্রসেসের আইফ্রেমগুলোর জন্য কোনো স্বতন্ত্র টার্গেট থাকে না, বরং সেগুলোকে ভিন্ন ভিন্ন কনটেক্সট হিসেবে উপস্থাপন করা হয়, যেগুলো একটিমাত্র টার্গেট থেকে অ্যাক্সেস করা যায়।

সীমাবদ্ধ ডোমেন

নিরাপত্তাজনিত কারণে, chrome.debugger API সমস্ত Chrome DevTools প্রোটোকল ডোমেইনে অ্যাক্সেস প্রদান করে না। উপলব্ধ ডোমেইনগুলো হলো: Accessibility , Audits , CacheStorage , Console , CSS , Database , Debugger , DOM , DOMDebugger , DOMSnapshot , Emulation , Fetch , IO , Input , Inspector , Log , Network , Overlay , Page , Performance , Profiler , Runtime , Storage , Target , Tracing , WebAudio , এবং WebAuthn ।

ফ্রেম নিয়ে কাজ করুন

ফ্রেম এবং টার্গেটের মধ্যে কোনো এক-এক সম্পর্ক নেই। একটিমাত্র ট্যাবের মধ্যে, একই প্রসেসের একাধিক ফ্রেম একই টার্গেট শেয়ার করতে পারে, কিন্তু ভিন্ন এক্সিকিউশন কনটেক্সট ব্যবহার করতে পারে। অন্যদিকে, একটি আউট-অফ-প্রসেস আইফ্রেমের জন্য একটি নতুন টার্গেট তৈরি করা যেতে পারে।

সবগুলো ফ্রেমে সংযুক্ত করার জন্য, আপনাকে প্রতিটি ধরণের ফ্রেম আলাদাভাবে পরিচালনা করতে হবে:

• একই প্রসেস ফ্রেমের সাথে যুক্ত নতুন এক্সিকিউশন কনটেক্সট শনাক্ত করতে Runtime.executionContextCreated ইভেন্টটি শুনুন।

• প্রক্রিয়াবহির্ভূত ফ্রেম শনাক্ত করতে সংশ্লিষ্ট টার্গেটগুলোর সাথে সংযুক্ত হওয়ার জন্য ধাপগুলো অনুসরণ করুন।

সম্পর্কিত লক্ষ্যবস্তুগুলির সাথে সংযুক্ত করুন

কোনো একটি টার্গেটের সাথে সংযোগ স্থাপন করার পর, আপনি আউট-অফ-প্রসেস চাইল্ড ফ্রেম বা সংশ্লিষ্ট ওয়ার্কার সহ আরও সম্পর্কিত টার্গেটগুলোর সাথে সংযোগ স্থাপন করতে চাইতে পারেন।

ক্রোম ১২৫ থেকে, chrome.debugger API ফ্ল্যাট সেশন সমর্থন করে। এর ফলে আপনি আপনার মূল ডিবাগার সেশনে অতিরিক্ত টার্গেটকে চাইল্ড হিসেবে যুক্ত করতে পারেন এবং chrome.debugger.attach কে পুনরায় কল না করেই সেগুলোতে মেসেজ পাঠাতে পারেন। এর পরিবর্তে, আপনি যে চাইল্ড টার্গেটে কমান্ড পাঠাতে চান, সেটিকে শনাক্ত করার জন্য chrome.debugger.sendCommand কল করার সময় একটি sessionId প্রপার্টি যোগ করতে পারেন।

প্রক্রিয়াধীন নয় এমন চাইল্ড ফ্রেমে স্বয়ংক্রিয়ভাবে সংযুক্ত হতে, প্রথমে Target.attachedToTarget ইভেন্টের জন্য একটি লিসেনার যোগ করুন:

chrome.debugger.onEvent.addListener((source, method, params) => {
  if (method === "Target.attachedToTarget") {
    // `source` identifies the parent session, but we need to construct a new
    // identifier for the child session
    const session = { ...source, sessionId: params.sessionId };

    // Call any needed CDP commands for the child session
    await chrome.debugger.sendCommand(session, "Runtime.enable");
  }
});

তারপর, flatten অপশনটি true সেট করে Target.setAutoAttach কমান্ডটি পাঠিয়ে অটো অ্যাটাচ চালু করুন:

await chrome.debugger.sendCommand({ tabId }, "Target.setAutoAttach", {
  autoAttach: true,
  waitForDebuggerOnStart: false,
  flatten: true,
  filter: [{ type: "iframe", exclude: false }]
});

অটো-অ্যাটাচ শুধুমাত্র সেই ফ্রেমগুলোর সাথেই সংযুক্ত হয় যেগুলো সম্পর্কে টার্গেট অবগত থাকে, এবং এটি শুধুমাত্র সেইসব ফ্রেমের মধ্যেই সীমাবদ্ধ যেগুলো এর সাথে যুক্ত কোনো ফ্রেমের ঠিক পরের ফ্রেম। উদাহরণস্বরূপ, A -> B -> C ফ্রেমের স্তরবিন্যাসে (যেখানে সবগুলোই ক্রস-অরিজিন), A-এর সাথে যুক্ত টার্গেটের জন্য Target.setAutoAttach কল করলে সেশনটি B-এর সাথেও সংযুক্ত হয়ে যাবে। তবে, এটি রিকার্সিভ নয়, তাই সেশনটিকে C-এর সাথে সংযুক্ত করার জন্য B-এর ক্ষেত্রেও Target.setAutoAttach কল করতে হবে।

উদাহরণ

এই API-টি ব্যবহার করে দেখতে, chrome-extension-samples রিপোজিটরি থেকে ডিবাগার API উদাহরণটি ইনস্টল করুন।

chrome.debugger.attach(
  target: Debuggee,
  requiredVersion: string,
): Promise<void>

chrome.debugger.detach(
  target: Debuggee,
): Promise<void>

chrome.debugger.getTargets(): Promise<TargetInfo[]>

chrome.debugger.sendCommand(
  target: DebuggerSession,
  method: string,
  commandParams?: object,
): Promise<object | undefined>

chrome.debugger.onDetach.addListener(
  callback: function,
)

chrome.debugger.onEvent.addListener(
  callback: function,
)