chrome.debugger

বর্ণনা

অনুমতি

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

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

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

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

টার্গেট

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

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

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

নিরাপত্তার কারণে, chrome.debugger API সমস্ত Chrome DevTools প্রোটোকল ডোমেনে অ্যাক্সেস প্রদান করে না। উপলব্ধ ডোমেনগুলি হল: অ্যাক্সেসিবিলিটি , অডিট , ক্যাশেস্টোরেজ , কনসোল , CSS , ডেটাবেস , ডিবাগার , DOM , DOMDebugger , DOMSnapshot , Emulation , Fetch , IO , Input , Inspector , Log , Network , Overlay , Perform , Spage , Runtor , Protor , টার্গেট , ট্রেসিং , WebAudio , এবং WebAuthn ।

ফ্রেম সঙ্গে কাজ

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

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

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

• প্রক্রিয়ার বাইরের ফ্রেমগুলি সনাক্ত করতে সম্পর্কিত লক্ষ্যগুলির সাথে সংযুক্ত করার পদক্ষেপগুলি অনুসরণ করুন৷

সম্পর্কিত লক্ষ্য সংযুক্ত করুন

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

Chrome 125 থেকে শুরু করে, 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-এর সাথে সেশন সংযুক্ত করার জন্য Target.setAutoAttach কেও B-কে ডাকতে হবে।

উদাহরণ

এই APIটি চেষ্টা করতে, chrome-extension-samples repository থেকে ডিবাগার 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,
)