chrome.processes

الوصف

استخدِم chrome.processes API للتفاعل مع عمليات المتصفِّح.

الأذونات

processes

مدى التوفّر

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

الأنواع

Cache

أماكن إقامة

  • liveSize

    الرقم

    الجزء المستخدم من ذاكرة التخزين المؤقت بالبايت.

  • الحجم

    الرقم

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

Process

أماكن إقامة

  • وحدة المعالجة المركزية (CPU)

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

    يشير هذا المقياس إلى أحدث قياس لاستخدام وحدة المعالجة المركزية (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 مع العلامة وتشمل الذاكرة.

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

    سلسلة

    تمثّل هذه السمة الملف الشخصي الذي ترتبط به العملية.

  • scriptCache

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

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

  • sqliteMemory

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

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

  • المهام

    TaskInfo[]

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

  • كتابة

    ProcessType

    نوع العملية.

ProcessType

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

Enum

"المتصفح"

"renderer"

"الإضافة"

"الإشعار"

"المكوّن الإضافي"

"عامل"

"nacl"

"service_worker"

"الأداة"

"gpu"

"other"

TaskInfo

أماكن إقامة

  • tabId

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

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

  • title

    سلسلة

    تمثّل هذه السمة عنوان المهمّة.

الطُرق

getProcessIdForTab()

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

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

المعلمات

  • tabId

    الرقم

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

  • رد الاتصال

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

    تظهر المَعلمة callback على النحو التالي: 

    (processId: number) => void

    • processId

      الرقم

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

المرتجعات

  • Promise<number>

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

getProcessInfo()

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

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

المعلمات

  • processIds

    الرقم | رقم[]

    تمثّل هذه السمة قائمة بأرقام تعريف العمليات أو أرقام تعريف العملية الفردية التي يتم عرض معلومات العملية الخاصة بها. تشير القائمة الفارغة إلى أن جميع العمليات مطلوبة.

  • includeMemory

    منطقي

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

  • رد الاتصال

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

    تظهر المَعلمة callback على النحو التالي: 

    (processes: object) => void

    • العمليات

      كائن

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

المرتجعات

  • Promise<object>

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

terminate()

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

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

المعلمات

  • processId

    الرقم

    معرّف العملية المراد إنهاؤها.

  • رد الاتصال

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

    تظهر المَعلمة callback على النحو التالي: 

    (didTerminate: boolean) => void

    • didTerminate

      منطقي

      صحيح إذا تم إنهاء العملية بنجاح، وخطأ في الحالات الأخرى.

المرتجعات

  • Promise<boolean>

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

فعاليات

onCreated

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

يتم إطلاقها في كل مرة يتم فيها إنشاء عملية، ما يؤدي إلى توفير كائن العملية المتجانس.

المعلمات

  • رد الاتصال

    دالة

    تظهر المَعلمة callback على النحو التالي: 

    (process: Process) => void

onExited

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

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

المعلمات

  • رد الاتصال

    دالة

    تظهر المَعلمة callback على النحو التالي: 

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

    • processId

      الرقم

    • exitType

      الرقم

    • رمز خروج

      الرقم

onUnresponsive

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

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

المعلمات

  • رد الاتصال

    دالة

    تظهر المَعلمة callback على النحو التالي: 

    (process: Process) => void

onUpdated

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

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

المعلمات

  • رد الاتصال

    دالة

    تظهر المَعلمة callback على النحو التالي: 

    (processes: object) => void

    • العمليات

      كائن

onUpdatedWithMemory

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

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

المعلمات

  • رد الاتصال

    دالة

    تظهر المَعلمة callback على النحو التالي: 

    (processes: object) => void

    • العمليات

      كائن