chrome.processes

الوصف

استخدام واجهة برمجة التطبيقات chrome.processes API للتفاعل مع عمليات المتصفِّح

الأذونات

processes

مدى توفّر الخدمة

قناة مطوّري البرامج

الأنواع

Cache

أماكن إقامة

  • liveSize

    الرقم

    يشير ذلك المصطلح إلى جزء ذاكرة التخزين المؤقت المُستخدَم بالبايت.

  • الحجم

    الرقم

    حجم ذاكرة التخزين المؤقت، بالبايت.

Process

أماكن إقامة

  • cpu

    الرقم اختياري

    القياس الأحدث لاستخدام وحدة المعالجة المركزية (CPU) خلال العملية، ويتم التعبير عنه بالنسبة المئوية المستخدمة إجمالاً من خلال جميع سلاسل العملية الخاصة بوحدة معالجة مركزية واحدة. وهذا يعطي قيمة من صفر إلى CpuInfo.numOfProcessors*100، والتي يمكن أن تتجاوز 100% في العمليات المتعددة السلاسل. لا يتوفّر هذا الخيار إلا عند تلقّي العنصر كجزء من طلب استدعاء من onupdated أو onupdatedWithMemory.

  • cssCache

    ذاكرة التخزين المؤقت اختيارية

    أحدث المعلومات عن ذاكرة التخزين المؤقت في CSS الخاصة بالعملية. لا يتوفّر هذا الخيار إلا عند تلقّي العنصر كجزء من طلب استدعاء من onupdated أو onupdatedWithMemory.

  • id

    الرقم

    معرّف فريد للعملية التي يوفّرها المتصفِّح.

  • imageCache

    ذاكرة التخزين المؤقت اختيارية

    أحدث المعلومات عن ذاكرة التخزين المؤقت للصور الخاصة بالعملية. لا يتوفّر هذا الخيار إلا عند تلقّي العنصر كجزء من طلب استدعاء من onupdated أو onupdatedWithMemory.

  • jsMemoryAllocated

    الرقم اختياري

    أحدث قياس للعملية الذي خصّصته JavaScript للذاكرة، بالبايت لا يتوفّر هذا الخيار إلا عند تلقّي العنصر كجزء من طلب استدعاء من onupdated أو onupdatedWithMemory.

  • jsMemoryUsed

    الرقم اختياري

    أحدث قياس للعملية المستخدمة في ذاكرة JavaScript بالبايت. لا يتوفّر هذا الخيار إلا عند تلقّي العنصر كجزء من طلب استدعاء من onupdated أو onupdatedWithMemory.

  • naclDebugPort

    الرقم

    منفذ تصحيح الأخطاء لعمليات Native Client الصفر لأنواع العمليات الأخرى ولعمليات NaCl التي لم يتم تفعيل تصحيح الأخطاء لها.

  • شبكة

    الرقم اختياري

    أحدث قياس لمعالجة استخدام الشبكة بوحدات البايت في الثانية لا يتوفّر هذا الخيار إلا عند تلقّي العنصر كجزء من طلب استدعاء من onupdated أو onupdatedWithMemory.

  • osProcessId

    الرقم

    معرّف العملية، وفقًا لما يوفّره نظام التشغيل.

  • privateMemory

    الرقم اختياري

    أحدث قياس لعملية استخدام الذاكرة الخاصة بالبايت لا يتوفّر هذا الخيار إلا عند تلقّي العنصر كجزء من طلب استدعاء من onupdatedWithMemory أو getProcessInfo مع علامة includeMemory.

  • الملف الشخصي

    سلسلة

    الملف الشخصي المرتبط بالعملية.

  • scriptCache

    ذاكرة التخزين المؤقت اختيارية

    أحدث المعلومات عن ذاكرة التخزين المؤقت للنص البرمجي للعملية لا يتوفّر هذا الخيار إلا عند تلقّي العنصر كجزء من طلب استدعاء من onupdated أو onupdatedWithMemory.

  • sqliteMemory

    الرقم اختياري

    أحدث قياس لاستخدام ذاكرة SQLite للعملية بالبايت. لا يتوفّر هذا الخيار إلا عند تلقّي العنصر كجزء من طلب استدعاء من onupdated أو onupdatedWithMemory.

  • الْمَهَامّْ

    TaskInfo[]

    مصفوفة من TaskInfos التي تمثل المهام التي يتم تشغيلها في هذه العملية.

  • كتابة

    ProcessType

    نوع العملية.

ProcessType

أنواع العمليات التي يعالجها المتصفّح.

التعداد

"nacl"

"utility"

"gpu"

TaskInfo

أماكن إقامة

  • tabId

    الرقم اختياري

    رقم تعريف علامة تبويب اختياري إذا كانت هذه المهمة تمثّل علامة تبويب يتم تشغيلها على عملية عارض.

  • title

    سلسلة

    عنوان المهمة.

الطُرق

getProcessIdForTab()

وعد 
chrome.processes.getProcessIdForTab(
  tabId: number,
  callback?: function,
)

تعرض هذه الدالة معرّف عملية العارض لعلامة التبويب المحدّدة.

المَعلمات

  • tabId

    الرقم

    رقم تعريف علامة التبويب التي سيتم عرض رقم تعريف عملية العارض لها

  • معاودة الاتصال

    الدالة اختيارية

    تبدو معلَمة callback على النحو التالي: 

    (processId: number)=>void

    • processId

      الرقم

      معرّف العملية الخاص بعملية عرض علامة التبويب

المرتجعات

  • وعد<الرقم>

    تتوفّر الوعود في إصدار Manifest V3 والإصدارات الأحدث، ولكن يتم توفير عمليات معاودة الاتصال من أجل التوافق مع الأنظمة القديمة. لا يمكنك استخدام كليهما في نفس استدعاء الدالة. يتم حل الوعد بنفس النوع الذي يتم تمريره إلى معاودة الاتصال.

getProcessInfo()

وعد 
chrome.processes.getProcessInfo(
  processIds: number|number[],
  includeMemory: boolean,
  callback?: function,
)

استرداد معلومات العملية لكل رقم تعريف عملية محدّد

المَعلمات

  • processIds

    رقم|رقم[]

    قائمة بأرقام تعريف العمليات أو رقم تعريف واحد للعملية يتم عرض معلومات العملية له. تشير القائمة الفارغة إلى أن جميع العمليات مطلوبة.

  • includeMemory

    boolean

    صحيح إذا كان استخدام الذاكرة التفصيلي مطلوبًا. ملاحظة: يؤدي جمع معلومات استخدام الذاكرة إلى زيادة استخدام وحدة المعالجة المركزية (CPU) ويجب طلب البحث عنها عند الحاجة فقط.

  • معاودة الاتصال

    الدالة اختيارية

    تبدو معلَمة callback على النحو التالي: 

    (processes: object)=>void

    • العمليات

      كائن

      قاموس مكوّن من عناصر Process لكل عملية مطلوبة تمثّل عملية فرعية مباشرة من عملية المتصفِّح الحالية، وتتم فهرستها حسب رقم تعريف العملية. لن تتم تعبئة المقاييس التي تتطلب تجميع البيانات بمرور الوقت في كل عنصر من عناصر العملية.

المرتجعات

  • Promise<object>

    تتوفّر الوعود في إصدار Manifest V3 والإصدارات الأحدث، ولكن يتم توفير عمليات معاودة الاتصال من أجل التوافق مع الأنظمة القديمة. لا يمكنك استخدام كليهما في نفس استدعاء الدالة. يتم حل الوعد بنفس النوع الذي يتم تمريره إلى معاودة الاتصال.

terminate()

وعد 
chrome.processes.terminate(
  processId: number,
  callback?: function,
)

إنهاء عملية العارض المحدّدة تعادل زيارة about:crash، ولكن بدون تغيير عنوان URL لعلامة التبويب.

المَعلمات

  • processId

    الرقم

    رقم تعريف العملية المطلوب إنهاؤها.

  • معاودة الاتصال

    الدالة اختيارية

    تبدو معلَمة callback على النحو التالي: 

    (didTerminate: boolean)=>void

    • didTerminate

      boolean

      True إذا كان إنهاء العملية ناجحًا، وfalse في الحالات الأخرى.

المرتجعات

  • Promise<boolean>

    تتوفّر الوعود في إصدار Manifest V3 والإصدارات الأحدث، ولكن يتم توفير عمليات معاودة الاتصال من أجل التوافق مع الأنظمة القديمة. لا يمكنك استخدام كليهما في نفس استدعاء الدالة. يتم حل الوعد بنفس النوع الذي يتم تمريره إلى معاودة الاتصال.

فعاليات

onCreated

chrome.processes.onCreated.addListener(
  callback: function,
)

يتم تنشيطها في كل مرة يتم فيها إنشاء عملية، مما يوفر كائن corrseponding Process.

المَعلمات

  • معاودة الاتصال

    الوظيفة

    تبدو معلَمة callback على النحو التالي: 

    (process: Process)=>void

onExited

chrome.processes.onExited.addListener(
  callback: function,
)

يتم تنشيطها في كل مرة يتم فيها إنهاء عملية، مع توفير نوع الخروج.

المَعلمات

  • معاودة الاتصال

    الوظيفة

    تبدو معلَمة callback على النحو التالي: 

    (processId: number,exitType: number,exitCode: number)=>void

    • processId

      الرقم

    • exitType

      الرقم

    • exitCode

      الرقم

onUnresponsive

chrome.processes.onUnresponsive.addListener(
  callback: function,
)

يتم تنشيطها في كل مرة تصبح فيها العملية غير مستجيبة، مما يوفر كائن corrseponding العملية.

المَعلمات

  • معاودة الاتصال

    الوظيفة

    تبدو معلَمة callback على النحو التالي: 

    (process: Process)=>void

onUpdated

chrome.processes.onUpdated.addListener(
  callback: function,
)

يتم تنشيطها في كل مرة يحدّث فيها مدير المهام إحصاءات العملية، مع توفير قاموس عناصر العملية المحدّثة، المفهرسة حسب معرّف العملية.

المَعلمات

  • معاودة الاتصال

    الوظيفة

    تبدو معلَمة callback على النحو التالي: 

    (processes: object)=>void

    • العمليات

      كائن

onUpdatedWithMemory

chrome.processes.onUpdatedWithMemory.addListener(
  callback: function,
)

يتم تنشيطها في كل مرة يحدّث فيها مدير المهام إحصاءات العملية، مع توفير قاموس عناصر العملية المحدّثة، المفهرسة حسب معرّف العملية. مماثلة لـ onUpdate، مع إضافة تفاصيل استخدام الذاكرة المضمّنة في كل عنصر من عناصر العملية. ملاحظة: يؤدي جمع معلومات استخدام الذاكرة إلى زيادة استخدام وحدة المعالجة المركزية (CPU) ويجب عدم الاستماع إليها إلا عند الحاجة.

المَعلمات

  • معاودة الاتصال

    الوظيفة

    تبدو معلَمة callback على النحو التالي: 

    (processes: object)=>void

    • العمليات

      كائن