chrome.processes

توضیحات

از API chrome.processes برای تعامل با فرآیندهای مرورگر استفاده کنید.

مجوزها

processes

در دسترس بودن

کانال توسعه‌دهندگان

انواع

Cache

خواص

  • اندازه زنده

    شماره

    بخشی از حافظه پنهان که مورد استفاده قرار می‌گیرد، بر حسب بایت.

  • اندازه

    شماره

    اندازه حافظه پنهان، بر حسب بایت.

Process

خواص

  • پردازنده

    شماره اختیاری

    جدیدترین اندازه‌گیری میزان استفاده از CPU توسط یک فرآیند، که به صورت درصد استفاده از یک هسته CPU در کل، توسط تمام رشته‌های فرآیند بیان می‌شود. این مقدار مقداری از صفر تا CpuInfo.numOfProcessors*100 را ارائه می‌دهد که می‌تواند در فرآیندهای چند رشته‌ای از 100٪ فراتر رود. فقط هنگام دریافت شیء به عنوان بخشی از یک فراخوانی از onUpdated یا onUpdatedWithMemory در دسترس است.

  • cssCache

    حافظه پنهان اختیاری

    جدیدترین اطلاعات در مورد حافظه پنهان CSS برای فرآیند. فقط هنگام دریافت شیء به عنوان بخشی از فراخوانی از onUpdated یا onUpdatedWithMemory در دسترس است.

  • شناسه

    شماره

    شناسه منحصر به فرد فرآیند ارائه شده توسط مرورگر.

  • ایمیج کش

    حافظه پنهان اختیاری

    جدیدترین اطلاعات در مورد حافظه پنهان تصویر برای فرآیند. فقط هنگام دریافت شیء به عنوان بخشی از فراخوانی از onUpdated یا onUpdatedWithMemory در دسترس است.

  • jsMemoryAllocated

    شماره اختیاری

    جدیدترین اندازه‌گیری فرآیند تخصیص حافظه توسط جاوا اسکریپت، بر حسب بایت. فقط هنگام دریافت شیء به عنوان بخشی از یک فراخوانی از onUpdated یا onUpdatedWithMemory در دسترس است.

  • jsMemoryUsed

    شماره اختیاری

    جدیدترین اندازه‌گیری حافظه جاوا اسکریپت مورد استفاده در فرآیند، بر حسب بایت. فقط هنگام دریافت شیء به عنوان بخشی از یک فراخوانی از onUpdated یا onUpdatedWithMemory در دسترس است.

  • پورت اشکال‌زدایی nacl

    شماره

    پورت اشکال‌زدایی برای فرآیندهای Native Client. صفر برای سایر انواع فرآیند و برای فرآیندهای NaCl که اشکال‌زدایی در آنها فعال نیست.

  • شبکه

    شماره اختیاری

    آخرین اندازه‌گیری میزان استفاده از شبکه‌ی پردازش، بر حسب بایت در ثانیه. فقط هنگام دریافت شیء به عنوان بخشی از یک فراخوانی برگشتی از onUpdated یا onUpdatedWithMemory در دسترس است.

  • شناسه پردازش سیستم (osProcessId)

    شماره

    شناسه‌ی فرآیند، همانطور که توسط سیستم عامل ارائه شده است.

  • حافظه خصوصی

    شماره اختیاری

    آخرین اندازه‌گیری میزان استفاده از حافظه خصوصی فرآیند، بر حسب بایت. فقط هنگام دریافت شیء به عنوان بخشی از یک فراخوانی مجدد از onUpdatedWithMemory یا getProcessInfo با پرچم includeMemory در دسترس است.

  • پروفایل

    رشته

    نمایه‌ای که فرآیند با آن مرتبط است.

  • اسکریپت کش

    حافظه پنهان اختیاری

    جدیدترین اطلاعات در مورد حافظه پنهان اسکریپت برای فرآیند. فقط هنگام دریافت شیء به عنوان بخشی از یک فراخوانی از onUpdated یا onUpdatedWithMemory در دسترس است.

  • حافظه sqlite

    شماره اختیاری

    آخرین اندازه‌گیری میزان استفاده از حافظه SQLite توسط فرآیند، بر حسب بایت. فقط هنگام دریافت شیء به عنوان بخشی از یک فراخوانی از onUpdated یا onUpdatedWithMemory در دسترس است.

  • آرایه‌ای از TaskInfos که وظایف در حال اجرا روی این فرآیند را نشان می‌دهد.

  • نوع فرآیند.

ProcessType

انواع پردازش‌های مرورگر.

شمارشی

"مرورگر"

"رندر کننده"

"امتداد"

"اطلاع رسانی"

"افزونه"

"کارگر"
منسوخ شده، هرگز بازگردانده نخواهد شد.

"نمک"

"کارگر_خدماتی"
منسوخ شده، هرگز بازگردانده نخواهد شد.

"سودمندی"

"جی پی یو"

«دیگر»

TaskInfo

خواص

  • شناسه برگه

    شماره اختیاری

    شناسه برگه اختیاری است، اگر این وظیفه نشان دهنده برگه‌ای باشد که در حال اجرا روی یک فرآیند رندر است.

  • عنوان

    رشته

    عنوان وظیفه.

روش‌ها

getProcessIdForTab()

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

شناسه‌ی فرآیند رندرکننده‌ی تب مشخص‌شده را برمی‌گرداند.

پارامترها

  • شناسه برگه

    شماره

    شناسه‌ی برگه‌ای که قرار است شناسه‌ی فرآیند رندرکننده برای آن برگردانده شود.

  • تماس برگشتی

    تابع اختیاری

    پارامتر callback به شکل زیر است: 

    (processId: number) => void

    • شناسه فرآیند

      شماره

      شناسه‌ی پردازش مربوط به پردازش رندرکننده‌ی برگه.

بازگشت‌ها

  • قول<number>

    یک تابع فراخوانی برای برگرداندن شناسه‌ی فرآیند رندر یک تب.

    Promiseها فقط برای Manifest V3 و نسخه‌های بعدی پشتیبانی می‌شوند، سایر پلتفرم‌ها باید از callbackها استفاده کنند.

getProcessInfo()

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

اطلاعات فرآیند را برای هر شناسه فرآیند مشخص شده بازیابی می‌کند.

پارامترها

  • شناسه‌های فرآیند

    عدد | عدد[]

    فهرست شناسه‌های فرآیند یا شناسه تک فرآیندی که اطلاعات فرآیند برای آن برگردانده می‌شود. یک فهرست خالی نشان می‌دهد که همه فرآیندها درخواست شده‌اند.

  • شامل حافظه

    بولی

    اگر جزئیات استفاده از حافظه مورد نیاز باشد، صحیح است. توجه داشته باشید که جمع‌آوری اطلاعات استفاده از حافظه، باعث استفاده اضافی از CPU می‌شود و فقط باید در صورت نیاز، درخواست شود.

  • تماس برگشتی

    تابع اختیاری

    پارامتر callback به شکل زیر است: 

    (processes: object) => void

    • فرآیندها

      شیء

      یک دیکشنری از اشیاء Process برای هر فرآیند درخواستی که یک فرآیند فرزند زنده از فرآیند مرورگر فعلی است و بر اساس شناسه فرآیند فهرست‌بندی شده است. معیارهایی که نیاز به تجمیع در طول زمان دارند، در هر شیء Process قرار داده نمی‌شوند.

بازگشت‌ها

  • قول دادن<object>

    یک فراخوانی برگشتی که هنگام جمع‌آوری اطلاعات فرآیندها فراخوانی می‌شود.

    Promiseها فقط برای Manifest V3 و نسخه‌های بعدی پشتیبانی می‌شوند، سایر پلتفرم‌ها باید از callbackها استفاده کنند.

terminate()

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

فرآیند رندر مشخص شده را خاتمه می‌دهد. معادل بازدید از about:crash است، اما بدون تغییر URL برگه.

پارامترها

  • شناسه فرآیند

    شماره

    شناسه فرآیندی که قرار است خاتمه یابد.

  • تماس برگشتی

    تابع اختیاری

    پارامتر callback به شکل زیر است: 

    (didTerminate: boolean) => void

    • خاتمه داد

      بولی

      اگر خاتمه فرآیند موفقیت‌آمیز باشد، مقدار True و در غیر این صورت False برمی‌گرداند.

بازگشت‌ها

  • قول <boolean>

    یک تماس برگشتی برای گزارش وضعیت فسخ.

    Promiseها فقط برای Manifest V3 و نسخه‌های بعدی پشتیبانی می‌شوند، سایر پلتفرم‌ها باید از callbackها استفاده کنند.

رویدادها

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

    • شناسه فرآیند

      شماره

    • نوع خروج

      شماره

    • کد خروج

      شماره

onUnresponsive

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

هر بار که یک فرآیند پاسخگو نباشد، اجرا می‌شود و شیء Process مربوطه را ارائه می‌دهد.

پارامترها

  • تماس برگشتی

    تابع

    پارامتر callback به شکل زیر است: 

    (process: Process) => void

onUpdated

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

هر بار که Task Manager آمار پردازش‌های خود را به‌روزرسانی می‌کند، اجرا می‌شود و دیکشنری اشیاء پردازش به‌روزرسانی‌شده را که بر اساس شناسه پردازش فهرست‌بندی شده‌اند، ارائه می‌دهد.

پارامترها

  • تماس برگشتی

    تابع

    پارامتر callback به شکل زیر است: 

    (processes: object) => void

    • فرآیندها

      شیء

onUpdatedWithMemory

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

هر بار که Task Manager آمار فرآیند خود را به‌روزرسانی می‌کند، اجرا می‌شود و دیکشنری اشیاء فرآیند به‌روزرسانی‌شده را که بر اساس شناسه فرآیند فهرست‌بندی شده‌اند، ارائه می‌دهد. مشابه onUpdate، با این تفاوت که جزئیات استفاده از حافظه در هر شیء فرآیند گنجانده شده است. توجه داشته باشید که جمع‌آوری اطلاعات استفاده از حافظه باعث استفاده اضافی از CPU می‌شود و فقط باید در صورت نیاز به آن گوش داد.

پارامترها

  • تماس برگشتی

    تابع

    پارامتر callback به شکل زیر است: 

    (processes: object) => void

    • فرآیندها

      شیء