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,
  callback?: function,
): Promise<number>

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

المعلمات

  • tabId

    الرقم

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

  • callback

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

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

    (processId: number) => void

    • processId

      الرقم

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

المرتجعات

  • Promise<number>

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

getProcessInfo()

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

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

المعلمات

  • processIds

    number | number[]

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

  • includeMemory

    قيمة منطقية

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

  • callback

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

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

    (processes: object) => void

    • للعمليات

      عنصر

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

المرتجعات

  • Promise<object>

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

terminate()

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

يؤدي هذا الخيار إلى إنهاء عملية العرض المحدّدة. يؤدي هذا الخيار إلى تنفيذ إجراء مماثل لزيارة 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,
)

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

المعلمات

  • 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

    • للعمليات

      عنصر