chrome.processes

الوصف

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

الأذونات

processes

مدى التوفّر

قناة الإصدار التجريبي

الأنواع

Cache

الخصائص

  • liveSize

    الرقم

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

  • الحجم

    الرقم

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

Process

الخصائص

  • cpu

    number اختياري

    أحدث قياس لمعدّل استخدام وحدة المعالجة المركزية في العملية، ويتم التعبير عنه كنسبة مئوية من إجمالي استخدام نواة واحدة لوحدة المعالجة المركزية، وذلك من خلال جميع سلاسل تنفيذ العملية. ويؤدي ذلك إلى عرض قيمة تتراوح بين صفر وCpuInfo.numOfProcessors*100، والتي يمكن أن تتجاوز ‎100% في العمليات المتعددة مؤشرات الترابط. لا يتوفّر إلا عند تلقّي العنصر كجزء من دالة ردّ من onUpdated أو onUpdatedWithMemory.

  • cssCache

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

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

  • id

    الرقم

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

  • imageCache

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

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

  • jsMemoryAllocated

    number اختياري

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

  • jsMemoryUsed

    number اختياري

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

  • naclDebugPort

    الرقم

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

  • شبكة

    number اختياري

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

  • osProcessId

    الرقم

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

  • privateMemory

    number اختياري

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

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

    سلسلة

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

  • scriptCache

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

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

  • sqliteMemory

    number اختياري

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

  • المهام

    TaskInfo[]

    مصفوفة من TaskInfo تمثّل المهام التي يتم تنفيذها في هذه العملية.

  • النوع

    ProcessType

    نوع العملية

ProcessType

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

Enum

"browser"

"renderer"

"extension"

"notification"

"plugin"

"worker"
تم إيقافه نهائيًا، ولن يتم عرضه أبدًا.

"nacl"

"service_worker"
قديم، لن يتم عرضه أبدًا.

"utility"

"gpu"

"other"

TaskInfo

الخصائص

  • tabId

    number اختياري

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

  • title

    سلسلة

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

الطُرق

getProcessIdForTab()

chrome.processes.getProcessIdForTab(
  tabId: number,
): Promise<number>

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

المعلمات

  • tabId

    الرقم

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

المرتجعات

  • Promise<number>

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

getProcessInfo()

chrome.processes.getProcessInfo(
  processIds: number | number[],
  includeMemory: boolean,
): Promise<object>

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

المعلمات

  • processIds

    number | number[]

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

  • includeMemory

    قيمة منطقية

    يتم ضبط القيمة على "صحيح" إذا كان من المطلوب الحصول على تفاصيل استخدام الذاكرة. يُرجى العِلم أنّ جمع معلومات استخدام الذاكرة يؤدي إلى زيادة استخدام وحدة المعالجة المركزية، ويجب عدم طلبها إلا عند الحاجة.

المرتجعات

  • Promise<object>

    يتم استدعاء دالة رد الاتصال عند جمع معلومات العمليات.

terminate()

chrome.processes.terminate(
  processId: number,
): Promise<boolean>

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

المعلمات

  • processId

    الرقم

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

المرتجعات

  • Promise<boolean>

    دالة ردّ الاتصال للإبلاغ عن حالة الإنهاء

الفعاليات

onCreated

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

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

المعلمات

  • callback

    دالة

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

    (process: Process) => void

onExited

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

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

المعلمات

  • callback

    دالة

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

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

    • processId

      الرقم

    • exitType

      الرقم

    • exitCode

      الرقم

onUnresponsive

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

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

المعلمات

  • callback

    دالة

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

    (process: Process) => void

onUpdated

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

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

المعلمات

  • callback

    دالة

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

    (processes: object) => void

    • للعمليات

      عنصر

onUpdatedWithMemory

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

يتم تشغيل هذا الحدث في كل مرة يحدّث فيها "مدير المهام" إحصاءات العمليات، ما يوفّر قاموسًا لعناصر العملية المعدَّلة، مفهرسًا حسب رقم تعريف العملية. تشبه onUpdate، مع إضافة تفاصيل استخدام الذاكرة المُضمَّنة في كل عنصر Process. يُرجى العِلم أنّ جمع معلومات استخدام الذاكرة يؤدي إلى زيادة استخدام وحدة المعالجة المركزية، ويجب الاستماع إليها فقط عند الحاجة.

المعلمات

  • callback

    دالة

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

    (processes: object) => void

    • للعمليات

      عنصر