summaryrefslogtreecommitdiffstats
path: root/chrome/common/extensions/docs/experimental.processes.html
diff options
context:
space:
mode:
Diffstat (limited to 'chrome/common/extensions/docs/experimental.processes.html')
-rw-r--r--chrome/common/extensions/docs/experimental.processes.html136
1 files changed, 33 insertions, 103 deletions
diff --git a/chrome/common/extensions/docs/experimental.processes.html b/chrome/common/extensions/docs/experimental.processes.html
index d334cc6..394d3ec 100644
--- a/chrome/common/extensions/docs/experimental.processes.html
+++ b/chrome/common/extensions/docs/experimental.processes.html
@@ -288,9 +288,7 @@
</div>
</em>
</dt>
- <dd class="todo">
- Undocumented.
- </dd>
+ <dd>The ID of the tab for which the renderer process ID is to be returned.</dd>
<!-- OBJECT PROPERTIES -->
<!-- OBJECT METHODS -->
<!-- OBJECT EVENT FIELDS -->
@@ -397,9 +395,7 @@
</div>
</em>
</dt>
- <dd class="todo">
- Undocumented.
- </dd>
+ <dd>The list of process IDs or single process ID for which to return the process information. An empty list indicates all processes are requested.</dd>
<!-- OBJECT PROPERTIES -->
<!-- OBJECT METHODS -->
<!-- OBJECT EVENT FIELDS -->
@@ -422,9 +418,7 @@
</div>
</em>
</dt>
- <dd class="todo">
- Undocumented.
- </dd>
+ <dd>True if detailed memory usage is required. Note, collecting memory usage information incurs extra CPU usage and should only be queried for when needed.</dd>
<!-- OBJECT PROPERTIES -->
<!-- OBJECT METHODS -->
<!-- OBJECT EVENT FIELDS -->
@@ -447,9 +441,7 @@
</div>
</em>
</dt>
- <dd class="todo">
- Undocumented.
- </dd>
+ <dd>Called when the processes information is collected.</dd>
<!-- OBJECT PROPERTIES -->
<!-- OBJECT METHODS -->
<!-- OBJECT EVENT FIELDS -->
@@ -488,9 +480,7 @@
</div>
</em>
</dt>
- <dd class="todo">
- Undocumented.
- </dd>
+ <dd>A dictionary of Process objects for each requested process that is a live child process of the current browser process, indexed by process ID. Metrics requiring aggregation over time will not be populated in each Process object.</dd>
<!-- OBJECT PROPERTIES -->
<!-- OBJECT METHODS -->
<!-- OBJECT EVENT FIELDS -->
@@ -532,9 +522,7 @@
</div>
</em>
</dt>
- <dd class="todo">
- Undocumented.
- </dd>
+ <dd>The ID of the process to be terminated.</dd>
<!-- OBJECT PROPERTIES -->
<!-- OBJECT METHODS -->
<!-- OBJECT EVENT FIELDS -->
@@ -599,7 +587,7 @@
</div>
</em>
</dt>
- <dd>True if the process was successfully killed.</dd>
+ <dd>True if terminating the process was successful, otherwise false.</dd>
<!-- OBJECT PROPERTIES -->
<!-- OBJECT METHODS -->
<!-- OBJECT EVENT FIELDS -->
@@ -623,7 +611,7 @@
<h4>onCreated</h4>
<div class="summary">
<!-- Note: intentionally longer 80 columns -->
- <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>);
+ <span class="subdued">chrome.experimental.processes.</span><span>onCreated</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 is created, providing the corrseponding Process object.</p>
@@ -634,31 +622,6 @@
<div>
<div>
<dt>
- <var>processId</var>
- <em>
- <!-- TYPE -->
- <div style="display:inline">
- (
- <span id="typeTemplate">
- <span>
- <span>integer</span>
- </span>
- </span>
- )
- </div>
- </em>
- </dt>
- <dd class="todo">
- Undocumented.
- </dd>
- <!-- OBJECT PROPERTIES -->
- <!-- OBJECT METHODS -->
- <!-- OBJECT EVENT FIELDS -->
- <!-- FUNCTION PARAMETERS -->
- </div>
- </div><div>
- <div>
- <dt>
<var>process</var>
<em>
<!-- TYPE -->
@@ -673,9 +636,7 @@
</div>
</em>
</dt>
- <dd class="todo">
- Undocumented.
- </dd>
+ <dd>Details of the process that was created. Metrics requiring aggregation over time will not be populated in the object.</dd>
<!-- OBJECT PROPERTIES -->
<!-- OBJECT METHODS -->
<!-- OBJECT EVENT FIELDS -->
@@ -689,6 +650,7 @@
<dl>
</dl>
</div> <!-- /description -->
+ <!-- /description -->
</div><div class="apiItem">
<a name="event-onExited"></a>
<h4>onExited</h4>
@@ -719,9 +681,7 @@
</div>
</em>
</dt>
- <dd class="todo">
- Undocumented.
- </dd>
+ <dd>The ID of the process that exited.</dd>
<!-- OBJECT PROPERTIES -->
<!-- OBJECT METHODS -->
<!-- OBJECT EVENT FIELDS -->
@@ -744,9 +704,7 @@
</div>
</em>
</dt>
- <dd class="todo">
- Undocumented.
- </dd>
+ <dd>The type of exit that occurred for the process - normal, abnormal, killed, crashed. Only available for renderer processes.</dd>
<!-- OBJECT PROPERTIES -->
<!-- OBJECT METHODS -->
<!-- OBJECT EVENT FIELDS -->
@@ -769,9 +727,7 @@
</div>
</em>
</dt>
- <dd class="todo">
- Undocumented.
- </dd>
+ <dd>The exit code if the process exited abnormally. Only available for renderer processes.</dd>
<!-- OBJECT PROPERTIES -->
<!-- OBJECT METHODS -->
<!-- OBJECT EVENT FIELDS -->
@@ -785,6 +741,7 @@
<dl>
</dl>
</div> <!-- /description -->
+ <!-- /description -->
</div><div class="apiItem">
<a name="event-onUnresponsive"></a>
<h4>onUnresponsive</h4>
@@ -815,9 +772,7 @@
</div>
</em>
</dt>
- <dd class="todo">
- Undocumented.
- </dd>
+ <dd>Details of the unresponsive process. Metrics requiring aggregation over time will not be populated in the object. Only available for renderer processes.</dd>
<!-- OBJECT PROPERTIES -->
<!-- OBJECT METHODS -->
<!-- OBJECT EVENT FIELDS -->
@@ -831,6 +786,7 @@
<dl>
</dl>
</div> <!-- /description -->
+ <!-- /description -->
</div><div class="apiItem">
<a name="event-onUpdated"></a>
<h4>onUpdated</h4>
@@ -861,9 +817,7 @@
</div>
</em>
</dt>
- <dd class="todo">
- Undocumented.
- </dd>
+ <dd>A dictionary of updated Process objects for each live process in the browser, indexed by process ID. Metrics requiring aggregation over time will be populated in each Process object.</dd>
<!-- OBJECT PROPERTIES -->
<!-- OBJECT METHODS -->
<!-- OBJECT EVENT FIELDS -->
@@ -877,6 +831,7 @@
<dl>
</dl>
</div> <!-- /description -->
+ <!-- /description -->
</div><div class="apiItem">
<a name="event-onUpdatedWithMemory"></a>
<h4>onUpdatedWithMemory</h4>
@@ -907,9 +862,7 @@
</div>
</em>
</dt>
- <dd class="todo">
- Undocumented.
- </dd>
+ <dd>A dictionary of updated Process objects for each live process in the browser, indexed by process ID. Memory usage details will be included in each Process object.</dd>
<!-- OBJECT PROPERTIES -->
<!-- OBJECT METHODS -->
<!-- OBJECT EVENT FIELDS -->
@@ -923,6 +876,7 @@
<dl>
</dl>
</div> <!-- /description -->
+ <!-- /description -->
</div> <!-- /apiItem -->
</div> <!-- /apiGroup -->
<!-- TYPES -->
@@ -969,7 +923,7 @@
</div>
</em>
</dt>
- <dd>Unique ID of the process provided by Chrome.</dd>
+ <dd>Unique ID of the process provided by the browser.</dd>
<!-- OBJECT PROPERTIES -->
<!-- OBJECT METHODS -->
<!-- OBJECT EVENT FIELDS -->
@@ -1069,7 +1023,7 @@
</div>
</em>
</dt>
- <dd>Array of Tab IDs that have a page rendered by this process (for renderer processes only).</dd>
+ <dd>Array of Tab IDs that have a page rendered by this process. The list will be non-empty for renderer processes only.</dd>
<!-- OBJECT PROPERTIES -->
<!-- OBJECT METHODS -->
<!-- OBJECT EVENT FIELDS -->
@@ -1093,7 +1047,7 @@
</div>
</em>
</dt>
- <dd>The most recent measurement of the process CPU usage, between 0 and 100%.</dd>
+ <dd>The most recent measurement of the process CPU usage, between 0 and 100%. Only available when receiving the object as part of a callback from onUpdated or onUpdatedWithMemory.</dd>
<!-- OBJECT PROPERTIES -->
<!-- OBJECT METHODS -->
<!-- OBJECT EVENT FIELDS -->
@@ -1117,7 +1071,7 @@
</div>
</em>
</dt>
- <dd>The most recent measurement of the process network usage, in bytes per second.</dd>
+ <dd>The most recent measurement of the process network usage, in bytes per second. Only available when receiving the object as part of a callback from onUpdated or onUpdatedWithMemory.</dd>
<!-- OBJECT PROPERTIES -->
<!-- OBJECT METHODS -->
<!-- OBJECT EVENT FIELDS -->
@@ -1141,31 +1095,7 @@
</div>
</em>
</dt>
- <dd>The most recent measurement of the process private memory usage, in bytes.</dd>
- <!-- OBJECT PROPERTIES -->
- <!-- OBJECT METHODS -->
- <!-- OBJECT EVENT FIELDS -->
- <!-- FUNCTION PARAMETERS -->
- </div>
- </div><div>
- <div>
- <dt>
- <var>memoryUsage</var>
- <em>
- <!-- TYPE -->
- <div style="display:inline">
- (
- <span class="optional">optional</span>
- <span id="typeTemplate">
- <span>
- <a>MemoryUsage</a>
- </span>
- </span>
- )
- </div>
- </em>
- </dt>
- <dd>Object containing the most recent details about process memory usage, in bytes.</dd>
+ <dd>The most recent measurement of the process private memory usage, in bytes. Only available when receiving the object as part of a callback from onUpdatedWithMemory or getProcessInfo with the includeMemory flag.</dd>
<!-- OBJECT PROPERTIES -->
<!-- OBJECT METHODS -->
<!-- OBJECT EVENT FIELDS -->
@@ -1189,7 +1119,7 @@
</div>
</em>
</dt>
- <dd>The most recent measurement of the process JavaScript allocated memory, in bytes.</dd>
+ <dd>The most recent measurement of the process JavaScript allocated memory, in bytes. Only available when receiving the object as part of a callback from onUpdated or onUpdatedWithMemory.</dd>
<!-- OBJECT PROPERTIES -->
<!-- OBJECT METHODS -->
<!-- OBJECT EVENT FIELDS -->
@@ -1213,7 +1143,7 @@
</div>
</em>
</dt>
- <dd>The most recent measurement of the process JavaScript memory used, in bytes.</dd>
+ <dd>The most recent measurement of the process JavaScript memory used, in bytes. Only available when receiving the object as part of a callback from onUpdated or onUpdatedWithMemory.</dd>
<!-- OBJECT PROPERTIES -->
<!-- OBJECT METHODS -->
<!-- OBJECT EVENT FIELDS -->
@@ -1237,7 +1167,7 @@
</div>
</em>
</dt>
- <dd>The most recent measurement of the process’s SQLite memory usage, in bytes.</dd>
+ <dd>The most recent measurement of the process’s SQLite memory usage, in bytes. Only available when receiving the object as part of a callback from onUpdated or onUpdatedWithMemory.</dd>
<!-- OBJECT PROPERTIES -->
<!-- OBJECT METHODS -->
<!-- OBJECT EVENT FIELDS -->
@@ -1261,7 +1191,7 @@
</div>
</em>
</dt>
- <dd>The most recent measurement of the process frames per second.</dd>
+ <dd>The most recent measurement of the process frames per second. Only available when receiving the object as part of a callback from onUpdated or onUpdatedWithMemory.</dd>
<!-- OBJECT PROPERTIES -->
<!-- OBJECT METHODS -->
<!-- OBJECT EVENT FIELDS -->
@@ -1285,7 +1215,7 @@
</div>
</em>
</dt>
- <dd>The most recent information about the image cache for the process.</dd>
+ <dd>The most recent information about the image cache for the process. Only available when receiving the object as part of a callback from onUpdated or onUpdatedWithMemory.</dd>
<!-- OBJECT PROPERTIES -->
<!-- OBJECT METHODS -->
<!-- OBJECT EVENT FIELDS -->
@@ -1309,7 +1239,7 @@
</div>
</em>
</dt>
- <dd>The most recent information about the script cache for the process.</dd>
+ <dd>The most recent information about the script cache for the process. Only available when receiving the object as part of a callback from onUpdated or onUpdatedWithMemory.</dd>
<!-- OBJECT PROPERTIES -->
<!-- OBJECT METHODS -->
<!-- OBJECT EVENT FIELDS -->
@@ -1333,7 +1263,7 @@
</div>
</em>
</dt>
- <dd>The most recent information about the CSS cache for the process.</dd>
+ <dd>The most recent information about the CSS cache for the process. Only available when receiving the object as part of a callback from onUpdated or onUpdatedWithMemory.</dd>
<!-- OBJECT PROPERTIES -->
<!-- OBJECT METHODS -->
<!-- OBJECT EVENT FIELDS -->
@@ -1364,7 +1294,7 @@
</div>
</em>
</dt>
- <dd>The Cache object contains information about the size and utilization of a cache used by Chromium.</dd>
+ <dd>The Cache object contains information about the size and utilization of a cache used by the browser.</dd>
<!-- OBJECT PROPERTIES -->
<dd>
<dl>