2014-05-05 06:49:05 +00:00
|
|
|
# Synopsis
|
|
|
|
|
|
2016-04-22 17:30:49 +00:00
|
|
|
> How to use Node.js and Electron APIs.
|
2016-04-21 22:35:29 +00:00
|
|
|
|
2015-08-29 05:46:31 +00:00
|
|
|
All of [Node.js's built-in modules](http://nodejs.org/api/) are available in
|
|
|
|
|
Electron and third-party node modules also fully supported as well (including
|
|
|
|
|
the [native modules](../tutorial/using-native-node-modules.md)).
|
2014-05-05 06:49:05 +00:00
|
|
|
|
2015-04-16 03:31:12 +00:00
|
|
|
Electron also provides some extra built-in modules for developing native
|
2015-09-04 20:44:40 +00:00
|
|
|
desktop applications. Some modules are only available in the main process, some
|
2015-09-01 22:42:10 +00:00
|
|
|
are only available in the renderer process (web page), and some can be used in
|
2015-08-29 05:46:31 +00:00
|
|
|
both processes.
|
|
|
|
|
|
2015-11-12 14:24:11 +00:00
|
|
|
The basic rule is: if a module is [GUI][gui] or low-level system related, then
|
|
|
|
|
it should be only available in the main process. You need to be familiar with
|
2016-04-22 13:53:26 +00:00
|
|
|
the concept of [main process vs. renderer process](../tutorial/quick-start.md#the-main-process)
|
|
|
|
|
scripts to be able to use those modules.
|
2014-05-05 06:49:05 +00:00
|
|
|
|
2015-08-29 05:46:31 +00:00
|
|
|
The main process script is just like a normal Node.js script:
|
2014-05-05 06:49:05 +00:00
|
|
|
|
|
|
|
|
```javascript
|
2016-05-10 16:26:38 +00:00
|
|
|
const {app, BrowserWindow} = require('electron');
|
2014-05-05 06:49:05 +00:00
|
|
|
|
2016-05-04 17:59:40 +00:00
|
|
|
let window = null;
|
2014-05-05 06:49:05 +00:00
|
|
|
|
2016-05-04 17:59:40 +00:00
|
|
|
app.on('ready', () => {
|
2014-05-05 06:49:05 +00:00
|
|
|
window = new BrowserWindow({width: 800, height: 600});
|
2015-11-13 08:03:40 +00:00
|
|
|
window.loadURL('https://github.com');
|
2014-05-05 06:49:05 +00:00
|
|
|
});
|
|
|
|
|
```
|
|
|
|
|
|
2015-11-12 14:24:11 +00:00
|
|
|
The renderer process is no different than a normal web page, except for the
|
|
|
|
|
extra ability to use node modules:
|
2014-05-05 06:49:05 +00:00
|
|
|
|
|
|
|
|
```html
|
|
|
|
|
<!DOCTYPE html>
|
|
|
|
|
<html>
|
2015-11-12 14:24:11 +00:00
|
|
|
<body>
|
|
|
|
|
<script>
|
2016-05-10 16:26:38 +00:00
|
|
|
const {app} = require('electron').remote;
|
|
|
|
|
console.log(app.getVersion());
|
2015-11-12 14:24:11 +00:00
|
|
|
</script>
|
|
|
|
|
</body>
|
2014-05-05 06:49:05 +00:00
|
|
|
</html>
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
To run your app, read [Run your app](../tutorial/quick-start.md#run-your-app).
|
2015-11-12 14:24:11 +00:00
|
|
|
|
|
|
|
|
## Destructuring assignment
|
|
|
|
|
|
2016-05-04 17:59:40 +00:00
|
|
|
As of 0.37, you can use
|
2016-03-06 07:28:39 +00:00
|
|
|
[destructuring assignment][destructuring-assignment] to make it easier to use
|
2016-05-04 17:59:40 +00:00
|
|
|
built-in modules.
|
|
|
|
|
|
|
|
|
|
```javascript
|
2016-05-10 16:26:38 +00:00
|
|
|
const {app, BrowserWindow} = require('electron');
|
2016-05-04 17:59:40 +00:00
|
|
|
```
|
|
|
|
|
|
|
|
|
|
If you need the entire `electron` module, you can require it and then using
|
|
|
|
|
destructuring to access the individual modules from `electron`.
|
2015-11-12 14:24:11 +00:00
|
|
|
|
|
|
|
|
```javascript
|
2016-05-04 17:59:40 +00:00
|
|
|
const electron = require('electron');
|
2016-05-10 16:26:38 +00:00
|
|
|
const {app, BrowserWindow} = electron;
|
2015-11-12 14:24:11 +00:00
|
|
|
```
|
|
|
|
|
|
2016-05-04 17:59:40 +00:00
|
|
|
This is equivalent to the following code:
|
|
|
|
|
|
|
|
|
|
```javascript
|
|
|
|
|
const electron = require('electron');
|
|
|
|
|
const app = electron.app;
|
|
|
|
|
const BrowserWindow = electron.BrowserWindow;
|
|
|
|
|
```
|
2015-11-12 14:24:11 +00:00
|
|
|
|
|
|
|
|
## Disable old styles of using built-in modules
|
|
|
|
|
|
|
|
|
|
Before v0.35.0, all built-in modules have to be used in the form of
|
|
|
|
|
`require('module-name')`, though it has [many disadvantages][issue-387], we are
|
|
|
|
|
still supporting it for compatibility with old apps.
|
|
|
|
|
|
|
|
|
|
To disable the old styles completely, you can set the
|
|
|
|
|
`ELECTRON_HIDE_INTERNAL_MODULES` environment variable:
|
|
|
|
|
|
|
|
|
|
```javascript
|
|
|
|
|
process.env.ELECTRON_HIDE_INTERNAL_MODULES = 'true'
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
Or call the `hideInternalModules` API:
|
|
|
|
|
|
|
|
|
|
```javascript
|
|
|
|
|
require('electron').hideInternalModules()
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
[gui]: https://en.wikipedia.org/wiki/Graphical_user_interface
|
2016-03-06 07:28:39 +00:00
|
|
|
[destructuring-assignment]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/Destructuring_assignment
|
2016-03-31 23:49:59 +00:00
|
|
|
[issue-387]: https://github.com/electron/electron/issues/387
|
