2015-09-01 16:21:29 -07:00
|
|
|
# process
|
2014-05-23 22:56:56 +08:00
|
|
|
|
2016-05-19 20:12:56 +09:00
|
|
|
> Extensions to process object.
|
|
|
|
|
|
|
|
The `process` object is extended in Electron with following APIs:
|
|
|
|
|
2015-10-05 11:41:36 +08:00
|
|
|
## Events
|
|
|
|
|
|
|
|
### Event: 'loaded'
|
|
|
|
|
|
|
|
Emitted when Electron has loaded its internal initialization script and is
|
|
|
|
beginning to load the web page or the main script.
|
|
|
|
|
|
|
|
It can be used by the preload script to add removed Node global symbols back to
|
|
|
|
the global scope when node integration is turned off:
|
|
|
|
|
2016-04-22 23:15:31 +09:00
|
|
|
```javascript
|
2015-10-05 11:41:36 +08:00
|
|
|
// preload.js
|
2016-07-25 18:39:25 -07:00
|
|
|
const _setImmediate = setImmediate
|
|
|
|
const _clearImmediate = clearImmediate
|
2016-05-11 02:15:09 +09:00
|
|
|
process.once('loaded', () => {
|
2016-07-25 18:39:25 -07:00
|
|
|
global.setImmediate = _setImmediate
|
|
|
|
global.clearImmediate = _clearImmediate
|
|
|
|
})
|
2015-10-05 11:41:36 +08:00
|
|
|
```
|
|
|
|
|
2015-12-01 13:43:52 +08:00
|
|
|
## Properties
|
|
|
|
|
|
|
|
### `process.noAsar`
|
|
|
|
|
|
|
|
Setting this to `true` can disable the support for `asar` archives in Node's
|
|
|
|
built-in modules.
|
|
|
|
|
2016-05-19 20:12:56 +09:00
|
|
|
### `process.type`
|
|
|
|
|
|
|
|
Current process's type, can be `"browser"` (i.e. main process) or `"renderer"`.
|
|
|
|
|
|
|
|
### `process.versions.electron`
|
|
|
|
|
|
|
|
Electron's version string.
|
|
|
|
|
|
|
|
### `process.versions.chrome`
|
|
|
|
|
|
|
|
Chrome's version string.
|
|
|
|
|
|
|
|
### `process.resourcesPath`
|
|
|
|
|
|
|
|
Path to the resources directory.
|
|
|
|
|
|
|
|
### `process.mas`
|
|
|
|
|
|
|
|
For Mac App Store build, this property is `true`, for other builds it is
|
|
|
|
`undefined`.
|
|
|
|
|
|
|
|
### `process.windowsStore`
|
|
|
|
|
|
|
|
If the app is running as a Windows Store app (appx), this property is `true`,
|
|
|
|
for otherwise it is `undefined`.
|
|
|
|
|
|
|
|
### `process.defaultApp`
|
|
|
|
|
|
|
|
When app is started by being passed as parameter to the default app, this
|
|
|
|
property is `true` in the main process, otherwise it is `undefined`.
|
|
|
|
|
2015-10-05 11:41:36 +08:00
|
|
|
## Methods
|
2015-08-28 21:47:31 -07:00
|
|
|
|
|
|
|
The `process` object has the following method:
|
|
|
|
|
2016-04-22 23:58:41 +02:00
|
|
|
### `process.crash()`
|
|
|
|
|
|
|
|
Causes the main thread of the current process crash.
|
|
|
|
|
2015-12-01 13:43:52 +08:00
|
|
|
### `process.hang()`
|
2015-06-17 20:13:43 +05:30
|
|
|
|
|
|
|
Causes the main thread of the current process hang.
|
2015-08-29 20:44:52 +05:30
|
|
|
|
2016-06-18 15:26:26 +02:00
|
|
|
### `process.setFdLimit(maxDescriptors)` _macOS_ _Linux_
|
2015-08-29 20:44:52 +05:30
|
|
|
|
|
|
|
* `maxDescriptors` Integer
|
|
|
|
|
|
|
|
Sets the file descriptor soft limit to `maxDescriptors` or the OS hard
|
|
|
|
limit, whichever is lower for the current process.
|
2016-05-17 14:46:50 -07:00
|
|
|
|
2016-05-19 20:12:56 +09:00
|
|
|
### `process.getProcessMemoryInfo()`
|
2016-05-17 14:46:50 -07:00
|
|
|
|
2016-05-19 20:12:56 +09:00
|
|
|
Returns an object giving memory usage statistics about the current process. Note
|
2016-05-17 14:54:33 -07:00
|
|
|
that all statistics are reported in Kilobytes.
|
2016-05-17 14:46:50 -07:00
|
|
|
|
2016-07-14 16:10:19 -07:00
|
|
|
* `workingSetSize` Integer - The amount of memory currently pinned to actual physical
|
2016-05-19 20:12:56 +09:00
|
|
|
RAM.
|
2016-07-14 16:10:19 -07:00
|
|
|
* `peakWorkingSetSize` Integer - The maximum amount of memory that has ever been pinned
|
2016-05-19 20:12:56 +09:00
|
|
|
to actual physical RAM.
|
2016-07-14 16:10:19 -07:00
|
|
|
* `privateBytes` Integer - The amount of memory not shared by other processes, such as
|
2016-05-17 14:54:33 -07:00
|
|
|
JS heap or HTML content.
|
2016-07-14 16:10:19 -07:00
|
|
|
* `sharedBytes` Integer - The amount of memory shared between processes, typically
|
2016-05-17 14:54:33 -07:00
|
|
|
memory consumed by the Electron code itself
|
2016-05-17 14:46:50 -07:00
|
|
|
|
2016-05-19 20:12:56 +09:00
|
|
|
### `process.getSystemMemoryInfo()`
|
2016-05-17 14:46:50 -07:00
|
|
|
|
2016-05-19 20:12:56 +09:00
|
|
|
Returns an object giving memory usage statistics about the entire system. Note
|
2016-05-17 14:54:33 -07:00
|
|
|
that all statistics are reported in Kilobytes.
|
2016-05-17 14:46:50 -07:00
|
|
|
|
2016-07-14 16:10:19 -07:00
|
|
|
* `total` Integer - The total amount of physical memory in Kilobytes available to the
|
2016-05-19 20:12:56 +09:00
|
|
|
system.
|
2016-07-14 16:10:19 -07:00
|
|
|
* `free` Integer - The total amount of memory not being used by applications or disk
|
2016-05-19 20:12:56 +09:00
|
|
|
cache.
|
2016-07-14 16:09:29 -07:00
|
|
|
* `swapTotal` Integer - The total amount of swap memory in Kilobytes available to the
|
|
|
|
system. _Windows_ _Linux_
|
|
|
|
* `swapFree` Integer - The free amount of swap memory in Kilobytes available to the
|
|
|
|
system. _Windows_ _Linux_
|