chrome.processes

الوصف

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

الأذونات

processes

مدى التوفّر

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

الأنواع

Cache

الخصائص

  • liveSize

    الرقم

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

  • الحجم

    الرقم

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

Process

الخصائص

  • 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

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

تعداد

"browser"

"renderer"

"extension"

"notification"

"plugin"

"worker"

"nacl"

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

"utility"

"gpu"

"other"

TaskInfo

الخصائص

  • tabId

    رقم اختياري

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

  • title

    سلسلة

    عنوان المهمة

الطُرق

getProcessIdForTab()

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

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

المعلمات

  • tabId

    الرقم

    رقم تعريف علامة التبويب التي يجب عرض رقم تعريف عملية عرض المحتوى لها.

  • callback

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

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

    (processId: number) => void

    • processId

      الرقم

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

المرتجعات

  • Promise<number>

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

getProcessInfo()

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

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

المعلمات

  • processIds

    عدد | عدد[]

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

  • includeMemory

    قيمة منطقية

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

  • callback

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

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

    (processes: object) => void

    • للعمليات

      عنصر

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

المرتجعات

  • Promise<object>

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

terminate()

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

تُنهي هذه العملية عملية عرض الرسوم المحدّدة. يعادل الانتقال إلى about:crash، ولكن بدون تغيير عنوان URL لعلامة التبويب.

المعلمات

  • processId

    الرقم

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

  • callback

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

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

    (didTerminate: boolean) => void

    • didTerminate

      قيمة منطقية

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

المرتجعات

  • Promise<boolean>

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

الفعاليات

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,
)

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

المعلمات

  • 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

    • للعمليات

      عنصر