chrome.processes

refresh date: 2026-09-25 robots: noindex

الوصف

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

الأذونات

processes

مدى التوفّر

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

الأنواع

Cache

الخصائص

  • liveSize

    الرقم

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

  • الحجم

    الرقم

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

Process

الخصائص

  • cpu

    number اختياري

    أحدث قياس لاستخدام وحدة المعالجة المركزية (CPU) في العملية، ويتم التعبير عنه كنسبة مئوية من إجمالي استخدام نواة واحدة لوحدة المعالجة المركزية، من خلال جميع سلاسل العمليات. يؤدي ذلك إلى عرض قيمة تتراوح بين صفر و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

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

تعداد

"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 لكل عملية مطلوبة وهي عملية فرعية نشطة لعملية المتصفح الحالية، مفهرسة حسب رقم تعريف العملية. لن يتم ملء المقاييس التي تتطلّب التجميع بمرور الوقت في كل عنصر 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

    • للعمليات

      عنصر