chrome/common/extensions/docs/experimental.processes.html - Issue 10175008: Improving the process model extension API

Unified Diff: chrome/common/extensions/docs/experimental.processes.html

Issue 10175008: Improving the process model extension API (Closed) Base URL: svn://svn.chromium.org/chrome/trunk/src

Patch Set: Syncing to the latest tree after a week away. Created 8 years, 7 months ago

Use n/p to move between diff chunks; N/P to move between comments. Draft comments are only viewable by you.

Jump to:

View side-by-side diff with in-line comments

Download patch

« no previous file with comments | « chrome/common/extensions/docs/examples/api/processes/process_monitor/popup.js ('k') | chrome/common/extensions/docs/samples.html » ('j') | no next file with comments »
Expand Comments ('e') | Collapse Comments ('c') | Hide Comments ('s')

Index: chrome/common/extensions/docs/experimental.processes.html

diff --git a/chrome/common/extensions/docs/experimental.processes.html b/chrome/common/extensions/docs/experimental.processes.html

new file mode 100644

index 0000000000000000000000000000000000000000..d334cc6c71eb12fda44c1c9dbd22d10e4bdc26ee

--- /dev/null

+++ b/chrome/common/extensions/docs/experimental.processes.html

@@ -0,0 +1,1463 @@

+<!DOCTYPE html><!-- This page is a placeholder for generated extensions api doc. Note:

+ 1) The <head> information in this page is significant, should be uniform

+ across api docs and should be edited only with knowledge of the

+ templating mechanism.

+ 3) All <body>.innerHTML is genereated as an rendering step. If viewed in a

+ browser, it will be re-generated from the template, json schema and

+ authored overview content.

+ 4) The <body>.innerHTML is also generated by an offline step so that this

+ page may easily be indexed by search engines.

+--><html xmlns="http://www.w3.org/1999/xhtml"><head>

+ <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">

+ <link href="css/ApiRefStyles.css" rel="stylesheet" type="text/css">

+ <link href="css/print.css" rel="stylesheet" type="text/css" media="print">

+ <script type="text/javascript" src="../../../third_party/jstemplate/jstemplate_compiled.js">

+ </script>

+ <script type="text/javascript" src="../../../../third_party/json_minify/minify-sans-regexp.js">

+ </script>

+ <script type="text/javascript" src="js/api_page_generator.js"></script>

+ <script type="text/javascript" src="js/bootstrap.js"></script>

+ <script type="text/javascript" src="js/sidebar.js"></script>

+ <meta name="description" content="Documentation for the chrome.experimental.processes module, which is part of the Google Chrome extension APIs."><title>chrome.experimental.processes - Google Chrome Extensions - Google Code</title></head>

+ <body> <div id="devModeWarning" class="displayModeWarning">

+ You are viewing extension docs in chrome via the 'file:' scheme: are you expecting to see local changes when you refresh? You'll need run chrome with --allow-file-access-from-files.

+ </div>

+ <div id="branchWarning" class="displayModeWarning">

+ <span>WARNING: This is the <span id="branchName">BETA</span> documentation.

+ It may not work with the stable release of Chrome.</span>

+ <select id="branchChooser">

+ <option>Choose a different version...

+ </option><option value="">Stable

+ </option><option value="beta">Beta

+ </option><option value="dev">Dev

+ </option><option value="trunk">Trunk

+ </option></select>

+ </div>

+ <div id="unofficialWarning" class="displayModeWarning">

+ <span>WARNING: This is unofficial documentation. It may not work with the

+ current release of Chrome.</span>

+ <button id="goToOfficialDocs">Go to the official docs</button>

+ </div>

+ <div id="gc-container" class="labs">

+

+ <!-- In particular, sub-templates that recurse, must be used by allowing

+ jstemplate to make a copy of the template in this section which

+ are not operated on by way of the jsskip="true" -->

+

+ <a id="top"></a>

+ <div id="skipto">

+ <a href="#gc-pagecontent">Skip to page content</a>

+ <a href="#gc-toc">Skip to main navigation</a>

+ </div>

+

+ <table id="header" width="100%" cellspacing="0" border="0">

+ <tbody><tr>

+ <td valign="middle"><a href="http://code.google.com/"><img src="images/code_labs_logo.gif" height="43" width="161" alt="Google Code Labs" style="border:0; margin:0;"></a></td>

+ <td valign="middle" width="100%" style="padding-left:0.6em;">

+ <form action="http://www.google.com/cse" id="cse" style="margin-top:0.5em">

+ <div id="gsc-search-box">

+ <input type="hidden" name="cx" value="002967670403910741006:61_cvzfqtno">

+ <input type="hidden" name="ie" value="UTF-8">

+ <input type="text" name="q" value="" size="55">

+ <input class="gsc-search-button" type="submit" name="sa" value="Search">

+ <br>

+ <span class="greytext">e.g. "page action" or "tabs"</span>

+ </div>

+ </form>

+ <script type="text/javascript" src="https://www.google.com/jsapi"></script>

+ <script type="text/javascript">google.load("elements", "1", {packages: "transliteration"});</script>

+ <script type="text/javascript" src="https://www.google.com/coop/cse/t13n?form=cse&t13n_langs=en"></script>

+ <script type="text/javascript" src="https://www.google.com/coop/cse/brand?form=cse&lang=en"></script>

+ </td>

+ </tr>

+ </tbody></table>

+ <div id="codesiteContent" class="">

+ <a id="gc-topnav-anchor"></a>

+ <div id="gc-topnav">

+ <h1>Google Chrome Extensions (<a href="http://code.google.com/labs/">Labs</a>)</h1>

+ <ul id="home" class="gc-topnav-tabs">

+ <li id="home_link">

+ <a href="index.html" title="Google Chrome Extensions home page">Home</a>

+ </li>

+ <li id="docs_link">

+ <a href="docs.html" title="Official Google Chrome Extensions documentation">Docs</a>

+ </li>

+ <li id="faq_link">

+ <a href="faq.html" title="Answers to frequently asked questions about Google Chrome Extensions">FAQ</a>

+ </li>

+ <li id="samples_link">

+ <a href="samples.html" title="Sample extensions (with source code)">Samples</a>

+ </li>

+ <li id="group_link">

+ <a href="http://groups.google.com/a/chromium.org/group/chromium-extensions" title="Google Chrome Extensions developer forum">Group</a>

+ </li>

+ <li id="so_link">

+ <a href="http://stackoverflow.com/questions/tagged/google-chrome-extension" title="[google-chrome-extension] tag on Stack Overflow">Questions?</a>

+ </li>

+ </ul>

+ </div>

+ <div class="g-section g-tpl-170">

+

+ <div class="g-unit g-first" id="gc-toc">

+ <ul>

+ <li><a href="getstarted.html">Getting Started</a></li>

+ <li><a href="overview.html">Overview</a></li>

+ <li><a href="whats_new.html">What's New?</a></li>

+ <li><h2><a href="devguide.html">Developer's Guide</a></h2>

+ <ul>

+ <li>Browser UI

+ <ul>

+ <li><a href="browserAction.html">Browser Actions</a></li>

+ <li><a href="contextMenus.html">Context Menus</a></li>

+ <li><a href="notifications.html">Desktop Notifications</a></li>

+ <li><a href="omnibox.html">Omnibox</a></li>

+ <li><a href="options.html">Options Pages</a></li>

+ <li><a href="override.html">Override Pages</a></li>

+ <li><a href="pageAction.html">Page Actions</a></li>

+ </ul>

+ </li>

+ <li>Browser Interaction

+ <ul>

+ <li><a href="bookmarks.html">Bookmarks</a></li>

+ <li><a href="cookies.html">Cookies</a></li>

+ <li><a href="devtools.html">Developer Tools</a></li>

+ <li><a href="events.html">Events</a></li>

+ <li><a href="history.html">History</a></li>

+ <li><a href="management.html">Management</a></li>

+ <li><a href="tabs.html">Tabs</a></li>

+ <li><a href="windows.html">Windows</a></li>

+ </ul>

+ </li>

+ <li>Implementation

+ <ul>

+ <li><a href="a11y.html">Accessibility</a></li>

+ <li><a href="background_pages.html">Background Pages</a></li>

+ <li><a href="content_scripts.html">Content Scripts</a></li>

+ <li><a href="xhr.html">Cross-Origin XHR</a></li>

+ <li><a href="i18n.html">Internationalization</a></li>

+ <li><a href="messaging.html">Message Passing</a></li>

+ <li><a href="permissions.html">Optional Permissions</a></li>

+ <li><a href="npapi.html">NPAPI Plugins</a></li>

+ </ul>

+ </li>

+ <li>Finishing

+ <ul>

+ <li><a href="hosting.html">Hosting</a></li>

+ <li><a href="external_extensions.html">Other Deployment Options</a></li>

+ </ul>

+ </li>

+ </ul>

+ </li>

+ <li><h2><a href="apps.html">Packaged Apps</a></h2></li>

+ <li><h2><a href="tutorials.html">Tutorials</a></h2>

+ <ul>

+ <li><a href="tut_debugging.html">Debugging</a></li>

+ <li><a href="tut_analytics.html">Google Analytics</a></li>

+ <li><a href="tut_oauth.html">OAuth</a></li>

+ </ul>

+ </li>

+ <li><h2>Reference</h2>

+ <ul>

+ <li>Formats

+ <ul>

+ <li><a href="manifest.html">Manifest Files</a></li>

+ <li><a href="match_patterns.html">Match Patterns</a></li>

+ </ul>

+ </li>

+ <li><a href="permission_warnings.html">Permission Warnings</a></li>

+ <li><a href="api_index.html">chrome.* APIs</a></li>

+ <li><a href="api_other.html">Other APIs</a></li>

+ </ul>

+ </li>

+ <li><h2><a href="samples.html">Samples</a></h2></li>

+ <div class="line"> </div>

+ <li><h2>More</h2>

+ <ul>

+ <li><a href="http://code.google.com/chrome/webstore/docs/index.html">Chrome Web Store</a></li>

+ <li><a href="http://code.google.com/chrome/apps/docs/developers_guide.html">Hosted Apps</a></li>

+ <li><a href="themes.html">Themes</a></li>

+ </ul>

+ </li>

+ </ul>

+ </div>

+ <script>

+ initToggles();

+ </script>

+ <div class="g-unit" id="gc-pagecontent">

+ <div id="pageTitle">

+ <h1 class="page_title">chrome.experimental.processes</h1>

+ </div>

+

+ <div id="toc">

+ <h2>Contents</h2>

+ <ol>

+ <li>

+ <a href="#apiReference">API reference: chrome.experimental.processes</a>

+ <ol>

+ <li>

+ <a href="#global-methods">Methods</a>

+ <ol>

+ <li>

+ <a href="#method-getProcessIdForTab">getProcessIdForTab</a>

+ </li><li>

+ <a href="#method-getProcessInfo">getProcessInfo</a>

+ </li><li>

+ <a href="#method-terminate">terminate</a>

+ </li>

+ </ol>

+ </li>

+ <li>

+ <a href="#global-events">Events</a>

+ <ol>

+ <li>

+ <a href="#event-onCreated">onCreated</a>

+ </li><li>

+ <a href="#event-onExited">onExited</a>

+ </li><li>

+ <a href="#event-onUnresponsive">onUnresponsive</a>

+ </li><li>

+ <a href="#event-onUpdated">onUpdated</a>

+ </li><li>

+ <a href="#event-onUpdatedWithMemory">onUpdatedWithMemory</a>

+ </li>

+ </ol>

+ </li>

+ <li>

+ <a href="#types">Types</a>

+ <ol>

+ <li>

+ <a href="#type-Process">Process</a>

+ <ol>

+ </ol>

+ </li><li>

+ <a href="#type-Cache">Cache</a>

+ <ol>

+ </ol>

+ </li>

+ </ol>

+ </li>

+ </ol>

+ </li>

+ </ol>

+ </div>

+

+

+ <p id="classSummary">

+ For information on how to use experimental APIs, see the <a href="experimental.html">chrome.experimental.* APIs</a> page.

+ </p>

+

+ <div id="static"></div>

+

+ <div class="apiPage">

+ <a name="apiReference"></a>

+ <h2>API reference: chrome.experimental.processes</h2>

+

+

+

+ <div id="methodsTemplate" class="apiGroup">

+ <a name="global-methods"></a>

+ <h3>Methods</h3>

+

+ <div class="apiItem">

+ <a name="method-getProcessIdForTab"></a>

+ <h4>getProcessIdForTab</h4>

+ <div class="summary">

+

+ <span>chrome.experimental.processes.getProcessIdForTab</span>(<span class="null"><span>integer</span>

+ <var><span>tabId</span></var></span><span class="null"><span>, </span><span>function</span>

+ <var><span>callback</span></var></span>)</div>

+ <div class="description">

+ <p>Returns the ID of the renderer process for the specified tab.</p>

+

+ <h4>Parameters</h4>

+ <dl>

+ <div>

+ <dt>

+ <var>tabId</var>

+ <em>

+

+ <div style="display:inline">

+ (

+ <span id="typeTemplate">

+ <span>

+ <span>integer</span>

+ </span>

+ )

+ </div>

+ </em>

+ </dt>

+ <dd class="todo">

+ Undocumented.

+ </dd>

+

+

+

+

+ </div>

+ </div><div>

+ <div>

+ <dt>

+ <var>callback</var>

+ <em>

+

+ <div style="display:inline">

+ (

+ <span id="typeTemplate">

+ <span>

+ <span>function</span>

+ </span>

+ )

+ </div>

+ </em>

+ </dt>

+ <dd class="todo">

+ Undocumented.

+ </dd>

+

+

+

+

+ </div>

+ </dl>

+

+ <dl>

+ </dl>

+

+ <div>

+ <h4>Callback function</h4>

+ <p>

+ The callback <em>parameter</em> should specify a function

+ that looks like this:

+ </p>

+

+ <pre>function(<span>integer processId</span>) <span class="subdued">{...}</span>;</pre>

+ <dl>

+ <div>

+ <dt>

+ <var>processId</var>

+ <em>

+

+ <div style="display:inline">

+ (

+ <span id="typeTemplate">

+ <span>

+ <span>integer</span>

+ </span>

+ )

+ </div>

+ </em>

+ </dt>

+ <dd>Process ID of the tab's renderer process.</dd>

+

+

+

+

+ </div>

+ </dl>

+ </div>

+

+ </div>

+ </div><div class="apiItem">

+ <a name="method-getProcessInfo"></a>

+ <h4>getProcessInfo</h4>

+ <div class="summary">

+

+ <span>chrome.experimental.processes.getProcessInfo</span>(<span class="null"><span>integer or array of integer</span>

+ <var><span>processIds</span></var></span><span class="null"><span>, </span><span>boolean</span>

+ <var><span>includeMemory</span></var></span><span class="null"><span>, </span><span>function</span>

+ <var><span>callback</span></var></span>)</div>

+ <div class="description">

+ <p>Retrieves the process information for each process ID specified.</p>

+

+ <h4>Parameters</h4>

+ <dl>

+ <div>

+ <dt>

+ <var>processIds</var>

+ <em>

+

+ <div style="display:inline">

+ (

+ <span id="typeTemplate">

+ <span>

+ <span>integer or array of integer</span>

+ </span>

+ )

+ </div>

+ </em>

+ </dt>

+ <dd class="todo">

+ Undocumented.

+ </dd>

+

+

+

+

+ </div>

+ </div><div>

+ <div>

+ <dt>

+ <var>includeMemory</var>

+ <em>

+

+ <div style="display:inline">

+ (

+ <span id="typeTemplate">

+ <span>

+ <span>boolean</span>

+ </span>

+ )

+ </div>

+ </em>

+ </dt>

+ <dd class="todo">

+ Undocumented.

+ </dd>

+

+

+

+

+ </div>

+ </div><div>

+ <div>

+ <dt>

+ <var>callback</var>

+ <em>

+

+ <div style="display:inline">

+ (

+ <span id="typeTemplate">

+ <span>

+ <span>function</span>

+ </span>

+ )

+ </div>

+ </em>

+ </dt>

+ <dd class="todo">

+ Undocumented.

+ </dd>

+

+

+

+

+ </div>

+ </dl>

+

+ <dl>

+ </dl>

+

+ <div>

+ <h4>Callback function</h4>

+ <p>

+ The callback <em>parameter</em> should specify a function

+ that looks like this:

+ </p>

+

+ <pre>function(<span>object processes</span>) <span class="subdued">{...}</span>;</pre>

+ <dl>

+ <div>

+ <dt>

+ <var>processes</var>

+ <em>

+

+ <div style="display:inline">

+ (

+ <span id="typeTemplate">

+ <span>

+ <span>object</span>

+ </span>

+ )

+ </div>

+ </em>

+ </dt>

+ <dd class="todo">

+ Undocumented.

+ </dd>

+

+

+

+

+ </div>

+ </dl>

+ </div>

+

+ </div>

+ </div><div class="apiItem">

+ <a name="method-terminate"></a>

+ <h4>terminate</h4>

+ <div class="summary">

+

+ <span>chrome.experimental.processes.terminate</span>(<span class="null"><span>integer</span>

+ <var><span>processId</span></var></span><span class="optional"><span>, </span><span>function</span>

+ <var><span>callback</span></var></span>)</div>

+ <div class="description">

+ <p>Terminates the specified renderer process. Equivalent to visiting about:crash, but without changing the tab's URL.</p>

+

+ <h4>Parameters</h4>

+ <dl>

+ <div>

+ <dt>

+ <var>processId</var>

+ <em>

+

+ <div style="display:inline">

+ (

+ <span id="typeTemplate">

+ <span>

+ <span>integer</span>

+ </span>

+ )

+ </div>

+ </em>

+ </dt>

+ <dd class="todo">

+ Undocumented.

+ </dd>

+

+

+

+

+ </div>

+ </div><div>

+ <div>

+ <dt>

+ <var>callback</var>

+ <em>

+

+ <div style="display:inline">

+ (

+ <span class="optional">optional</span>

+ <span id="typeTemplate">

+ <span>

+ <span>function</span>

+ </span>

+ )

+ </div>

+ </em>

+ </dt>

+ <dd class="todo">

+ Undocumented.

+ </dd>

+

+

+

+

+ </div>

+ </dl>

+

+ <dl>

+ </dl>

+

+ <div>

+ <h4>Callback function</h4>

+ <p>

+ If you specify the <em>callback</em> parameter, it should

+ specify a function that looks like this:

+ </p>

+

+ <pre>function(<span>boolean didTerminate</span>) <span class="subdued">{...}</span>;</pre>

+ <dl>

+ <div>

+ <dt>

+ <var>didTerminate</var>

+ <em>

+

+ <div style="display:inline">

+ (

+ <span id="typeTemplate">

+ <span>

+ <span>boolean</span>

+ </span>

+ )

+ </div>

+ </em>

+ </dt>

+ <dd>True if the process was successfully killed.</dd>

+

+

+

+

+ </div>

+ </dl>

+ </div>

+

+ </div>

+ </div>

+ </div>

+

+ <div id="eventsTemplate" class="apiGroup">

+ <a name="global-events"></a>

+ <h3>Events</h3>

+

+ <div class="apiItem">

+ <a name="event-onCreated"></a>

+ <h4>onCreated</h4>

+ <div class="summary">

+

+ <span class="subdued">chrome.experimental.processes.</span><span>onCreated</span><span class="subdued">.addListener</span>(function(<span>integer processId, Process process</span>) <span class="subdued">{...}</span><span></span>);

+ </div>

+ <div class="description">

+ <p>Fired each time a process is created, providing the corrseponding Process object.</p>

+

+ <div>

+ <h4>Listener parameters</h4>

+ <dl>

+ <div>

+ <dt>

+ <var>processId</var>

+ <em>

+

+ <div style="display:inline">

+ (

+ <span id="typeTemplate">

+ <span>

+ <span>integer</span>

+ </span>

+ )

+ </div>

+ </em>

+ </dt>

+ <dd class="todo">

+ Undocumented.

+ </dd>

+

+

+

+

+ </div>

+ </div><div>

+ <div>

+ <dt>

+ <var>process</var>

+ <em>

+

+ <div style="display:inline">

+ (

+ <span id="typeTemplate">

+ <span>

+ <a href="experimental.processes.html#type-Process">Process</a>

+ </span>

+ )

+ </div>

+ </em>

+ </dt>

+ <dd class="todo">

+ Undocumented.

+ </dd>

+

+

+

+

+ </div>

+ </dl>

+ </div>

+

+

+ <dl>

+ </dl>

+ </div>

+ </div><div class="apiItem">

+ <a name="event-onExited"></a>

+ <h4>onExited</h4>

+ <div class="summary">

+

+ <span class="subdued">chrome.experimental.processes.</span><span>onExited</span><span class="subdued">.addListener</span>(function(<span>integer processId, integer exitType, integer exitCode</span>) <span class="subdued">{...}</span><span></span>);

+ </div>

+ <div class="description">

+ <p>Fired each time a process is terminated, providing the type of exit.</p>

+

+ <div>

+ <h4>Listener parameters</h4>

+ <dl>

+ <div>

+ <dt>

+ <var>processId</var>

+ <em>

+

+ <div style="display:inline">

+ (

+ <span id="typeTemplate">

+ <span>

+ <span>integer</span>

+ </span>

+ )

+ </div>

+ </em>

+ </dt>

+ <dd class="todo">

+ Undocumented.

+ </dd>

+

+

+

+

+ </div>

+ </div><div>

+ <div>

+ <dt>

+ <var>exitType</var>

+ <em>

+

+ <div style="display:inline">

+ (

+ <span id="typeTemplate">

+ <span>

+ <span>integer</span>

+ </span>

+ )

+ </div>

+ </em>

+ </dt>

+ <dd class="todo">

+ Undocumented.

+ </dd>

+

+

+

+

+ </div>

+ </div><div>

+ <div>

+ <dt>

+ <var>exitCode</var>

+ <em>

+

+ <div style="display:inline">

+ (

+ <span id="typeTemplate">

+ <span>

+ <span>integer</span>

+ </span>

+ )

+ </div>

+ </em>

+ </dt>

+ <dd class="todo">

+ Undocumented.

+ </dd>

+

+

+

+

+ </div>

+ </dl>

+ </div>

+

+

+ <dl>

+ </dl>

+ </div>

+ </div><div class="apiItem">

+ <a name="event-onUnresponsive"></a>

+ <h4>onUnresponsive</h4>

+ <div class="summary">

+

+ <span class="subdued">chrome.experimental.processes.</span><span>onUnresponsive</span><span class="subdued">.addListener</span>(function(<span>Process process</span>) <span class="subdued">{...}</span><span></span>);

+ </div>

+ <div class="description">

+ <p>Fired each time a process becomes unresponsive, providing the corrseponding Process object.</p>

+

+ <div>

+ <h4>Listener parameters</h4>

+ <dl>

+ <div>

+ <dt>

+ <var>process</var>

+ <em>

+

+ <div style="display:inline">

+ (

+ <span id="typeTemplate">

+ <span>

+ <a href="experimental.processes.html#type-Process">Process</a>

+ </span>

+ )

+ </div>

+ </em>

+ </dt>

+ <dd class="todo">

+ Undocumented.

+ </dd>

+

+

+

+

+ </div>

+ </dl>

+ </div>

+

+

+ <dl>

+ </dl>

+ </div>

+ </div><div class="apiItem">

+ <a name="event-onUpdated"></a>

+ <h4>onUpdated</h4>

+ <div class="summary">

+

+ <span class="subdued">chrome.experimental.processes.</span><span>onUpdated</span><span class="subdued">.addListener</span>(function(<span>object processes</span>) <span class="subdued">{...}</span><span></span>);

+ </div>

+ <div class="description">

+ <p>Fired each time the Task Manager updates its process statistics, providing the dictionary of updated Process objects, indexed by process ID.</p>

+

+ <div>

+ <h4>Listener parameters</h4>

+ <dl>

+ <div>

+ <dt>

+ <var>processes</var>

+ <em>

+

+ <div style="display:inline">

+ (

+ <span id="typeTemplate">

+ <span>

+ <span>object</span>

+ </span>

+ )

+ </div>

+ </em>

+ </dt>

+ <dd class="todo">

+ Undocumented.

+ </dd>

+

+

+

+

+ </div>

+ </dl>

+ </div>

+

+

+ <dl>

+ </dl>

+ </div>

+ </div><div class="apiItem">

+ <a name="event-onUpdatedWithMemory"></a>

+ <h4>onUpdatedWithMemory</h4>

+ <div class="summary">

+

+ <span class="subdued">chrome.experimental.processes.</span><span>onUpdatedWithMemory</span><span class="subdued">.addListener</span>(function(<span>object processes</span>) <span class="subdued">{...}</span><span></span>);

+ </div>

+ <div class="description">

+ <p>Fired each time the Task Manager updates its process statistics, providing the dictionary of updated Process objects, indexed by process ID. Identical to onUpdate, with the addition of memory usage details included in each Process object. Note, collecting memory usage information incurs extra CPU usage and should only be listened for when needed.</p>

+

+ <div>

+ <h4>Listener parameters</h4>

+ <dl>

+ <div>

+ <dt>

+ <var>processes</var>

+ <em>

+

+ <div style="display:inline">

+ (

+ <span id="typeTemplate">

+ <span>

+ <span>object</span>

+ </span>

+ )

+ </div>

+ </em>

+ </dt>

+ <dd class="todo">

+ Undocumented.

+ </dd>

+

+

+

+

+ </div>

+ </dl>

+ </div>

+

+

+ <dl>

+ </dl>

+ </div>

+ </div>

+ </div>

+

+ <div class="apiGroup">

+ <a name="types"></a>

+ <h3 id="types">Types</h3>

+

+ <div class="apiItem">

+ <a name="type-Process"></a>

+ <h4>Process</h4>

+ <div>

+ <dt>

+ <em>

+

+ <div style="display:inline">

+ (

+ <span id="typeTemplate">

+ <span>

+ <span>object</span>

+ </span>

+ )

+ </div>

+ </em>

+ </dt>

+ <dd>An object containing information about one of the browser's processes.</dd>

+

+ <dd>

+ <dl>

+ <div>

+ <dt>

+ <var>id</var>

+ <em>

+

+ <div style="display:inline">

+ (

+ <span id="typeTemplate">

+ <span>

+ <span>integer</span>

+ </span>

+ )

+ </div>

+ </em>

+ </dt>

+ <dd>Unique ID of the process provided by Chrome.</dd>

+

+

+

+

+ </div>

+ </div><div>

+ <div>

+ <dt>

+ <var>osProcessId</var>

+ <em>

+

+ <div style="display:inline">

+ (

+ <span id="typeTemplate">

+ <span>

+ <span>integer</span>

+ </span>

+ )

+ </div>

+ </em>

+ </dt>

+ <dd>The ID of the process, as provided by the OS.</dd>

+

+

+

+

+ </div>

+ </div><div>

+ <div>

+ <dt>

+ <var>type</var>

+ <em>

+

+ <div style="display:inline">

+ (

+ <span class="enum">enumerated</span>

+ <span id="typeTemplate">

+ <span>

+ <span>string</span>

+ <span>["browser", "renderer", "extension", "notification", "plugin", "worker", "nacl", "utility", "gpu", "other"]</span>

+ </span>

+ )

+ </div>

+ </em>

+ </dt>

+ <dd>The type of process.</dd>

+

+

+

+

+ </div>

+ </div><div>

+ <div>

+ <dt>

+ <var>profile</var>

+ <em>

+

+ <div style="display:inline">

+ (

+ <span id="typeTemplate">

+ <span>

+ <span>string</span>

+ </span>

+ )

+ </div>

+ </em>

+ </dt>

+ <dd>The profile which the process is associated with.</dd>

+

+

+

+

+ </div>

+ </div><div>

+ <div>

+ <dt>

+ <var>tabs</var>

+ <em>

+

+ <div style="display:inline">

+ (

+ <span id="typeTemplate">

+ <span>

+ array of <span><span>

+ <span>

+ <span>integer</span>

+ </span>

+ </span></span>

+ </span>

+ )

+ </div>

+ </em>

+ </dt>

+ <dd>Array of Tab IDs that have a page rendered by this process (for renderer processes only).</dd>

+

+

+

+

+ </div>

+ </div><div>

+ <div>

+ <dt>

+ <var>cpu</var>

+ <em>

+

+ <div style="display:inline">

+ (

+ <span class="optional">optional</span>

+ <span id="typeTemplate">

+ <span>

+ <span>number</span>

+ </span>

+ )

+ </div>

+ </em>

+ </dt>

+ <dd>The most recent measurement of the process CPU usage, between 0 and 100%.</dd>

+

+

+

+

+ </div>

+ </div><div>

+ <div>

+ <dt>

+ <var>network</var>

+ <em>

+

+ <div style="display:inline">

+ (

+ <span class="optional">optional</span>

+ <span id="typeTemplate">

+ <span>

+ <span>number</span>

+ </span>

+ )

+ </div>

+ </em>

+ </dt>

+ <dd>The most recent measurement of the process network usage, in bytes per second.</dd>

+

+

+

+

+ </div>

+ </div><div>

+ <div>

+ <dt>

+ <var>privateMemory</var>

+ <em>

+

+ <div style="display:inline">

+ (

+ <span class="optional">optional</span>

+ <span id="typeTemplate">

+ <span>

+ <span>number</span>

+ </span>

+ )

+ </div>

+ </em>

+ </dt>

+ <dd>The most recent measurement of the process private memory usage, in bytes.</dd>

+

+

+

+

+ </div>

+ </div><div>

+ <div>

+ <dt>

+ <var>memoryUsage</var>

+ <em>

+

+ <div style="display:inline">

+ (

+ <span class="optional">optional</span>

+ <span id="typeTemplate">

+ <span>

+ <a>MemoryUsage</a>

+ </span>

+ )

+ </div>

+ </em>

+ </dt>

+ <dd>Object containing the most recent details about process memory usage, in bytes.</dd>

+

+

+

+

+ </div>

+ </div><div>

+ <div>

+ <dt>

+ <var>jsMemoryAllocated</var>

+ <em>

+

+ <div style="display:inline">

+ (

+ <span class="optional">optional</span>

+ <span id="typeTemplate">

+ <span>

+ <span>number</span>

+ </span>

+ )

+ </div>

+ </em>

+ </dt>

+ <dd>The most recent measurement of the process JavaScript allocated memory, in bytes.</dd>

+

+

+

+

+ </div>

+ </div><div>

+ <div>

+ <dt>

+ <var>jsMemoryUsed</var>

+ <em>

+

+ <div style="display:inline">

+ (

+ <span class="optional">optional</span>

+ <span id="typeTemplate">

+ <span>

+ <span>number</span>

+ </span>

+ )

+ </div>

+ </em>

+ </dt>

+ <dd>The most recent measurement of the process JavaScript memory used, in bytes.</dd>

+

+

+

+

+ </div>

+ </div><div>

+ <div>

+ <dt>

+ <var>sqliteMemory</var>

+ <em>

+

+ <div style="display:inline">

+ (

+ <span class="optional">optional</span>

+ <span id="typeTemplate">

+ <span>

+ <span>number</span>

+ </span>

+ )

+ </div>

+ </em>

+ </dt>

+ <dd>The most recent measurement of the process’s SQLite memory usage, in bytes.</dd>

+

+

+

+

+ </div>

+ </div><div>

+ <div>

+ <dt>

+ <var>fps</var>

+ <em>

+

+ <div style="display:inline">

+ (

+ <span class="optional">optional</span>

+ <span id="typeTemplate">

+ <span>

+ <span>number</span>

+ </span>

+ )

+ </div>

+ </em>

+ </dt>

+ <dd>The most recent measurement of the process frames per second.</dd>

+

+

+

+

+ </div>

+ </div><div>

+ <div>

+ <dt>

+ <var>imageCache</var>

+ <em>

+

+ <div style="display:inline">

+ (

+ <span class="optional">optional</span>

+ <span id="typeTemplate">

+ <span>

+ <a href="experimental.processes.html#type-Cache">Cache</a>

+ </span>

+ )

+ </div>

+ </em>

+ </dt>

+ <dd>The most recent information about the image cache for the process.</dd>

+

+

+

+

+ </div>

+ </div><div>

+ <div>

+ <dt>

+ <var>scriptCache</var>

+ <em>

+

+ <div style="display:inline">

+ (

+ <span class="optional">optional</span>

+ <span id="typeTemplate">

+ <span>

+ <a href="experimental.processes.html#type-Cache">Cache</a>

+ </span>

+ )

+ </div>

+ </em>

+ </dt>

+ <dd>The most recent information about the script cache for the process.</dd>

+

+

+

+

+ </div>

+ </div><div>

+ <div>

+ <dt>

+ <var>cssCache</var>

+ <em>

+

+ <div style="display:inline">

+ (

+ <span class="optional">optional</span>

+ <span id="typeTemplate">

+ <span>

+ <a href="experimental.processes.html#type-Cache">Cache</a>

+ </span>

+ )

+ </div>

+ </em>

+ </dt>

+ <dd>The most recent information about the CSS cache for the process.</dd>

+

+

+

+

+ </div>

+ </dl>

+ </dd>

+

+

+

+ </div>

+ </div><div class="apiItem">

+ <a name="type-Cache"></a>

+ <h4>Cache</h4>

+ <div>

+ <dt>

+ <em>

+

+ <div style="display:inline">

+ (

+ <span id="typeTemplate">

+ <span>

+ <span>object</span>

+ </span>

+ )

+ </div>

+ </em>

+ </dt>

+ <dd>The Cache object contains information about the size and utilization of a cache used by Chromium.</dd>

+

+ <dd>

+ <dl>

+ <div>

+ <dt>

+ <var>size</var>

+ <em>

+

+ <div style="display:inline">

+ (

+ <span id="typeTemplate">

+ <span>

+ <span>number</span>

+ </span>

+ )

+ </div>

+ </em>

+ </dt>

+ <dd>The size of the cache, in bytes.</dd>

+

+

+

+

+ </div>

+ </div><div>

+ <div>

+ <dt>

+ <var>liveSize</var>

+ <em>

+

+ <div style="display:inline">

+ (

+ <span id="typeTemplate">

+ <span>

+ <span>number</span>

+ </span>

+ )

+ </div>

+ </em>

+ </dt>

+ <dd>The part of the cache that is utilized, in bytes.</dd>

+

+

+

+

+ </div>

+ </dl>

+ </dd>

+

+

+

+ </div>

+ </div>

+ </div>

+ </div>

+ </div>

+ </div>

+ </div>

+ <div id="gc-footer" --="">

+ <div class="text">

+ <p>

+ Except as otherwise <a href="http://code.google.com/policies.html#restrictions">noted</a>,

+ the content of this page is licensed under the <a rel="license" href="http://creativecommons.org/licenses/by/3.0/">Creative Commons

+ Attribution 3.0 License</a>, and code samples are licensed under the

+ <a rel="license" href="http://code.google.com/google_bsd_license.html">BSD License</a>.

+ </p>

+ <p>

+ </p>

+

+<script src="https://www.google-analytics.com/urchin.js" type="text/javascript"></script>

+<script src="https://www.google-analytics.com/ga.js" type="text/javascript"></script>

+<script type="text/javascript">

+ // chrome doc tracking

+ try {

+ var engdocs = _gat._getTracker("YT-10763712-2");

+ engdocs._trackPageview();

+ } catch(err) {}

+ // code.google.com site-wide tracking

+ try {

+ _uacct="UA-18071-1";

+ _uanchor=1;

+ _uff=0;

+ urchinTracker();

+ }

+ catch(e) {/* urchinTracker not available. */}

+</script>

+

+ </div>

+ </div>

+ </div>

+</body></html>