An easy-to-use, efficient, and multi-process safe settings framework for Electron that presumes a single application configuration file.
Written to allow settings to be shared between the main process and renderer processes through ipcMain and ipcRenderer communication. The main process acts as the master to all renderer processes, loading the initial configuration file, managing synchronization, and the saving of the configuration on application quit.
Compatible with electron-config generated configuration files.
- Advantages
- Simple syntax allowing for escaped dot notation
- e.g., "my\.property" => {"my\.property": ...}
- Automatic merging of default values
- IPC-based with no-config settings synchronization
- Simple to use -- require wherever needed and begin usage!
- Simple syntax allowing for escaped dot notation
- Disadvantages
- No key=>value monitoring (yet)
- Only save-on-quit (to be further expanded)
- Single settings file (could be changed, but might be beyond the module's scope)
$ npm install electron-app-settings --save
electron-app-settings can simply be required wherever it is needed, regardless of if it has been loaded in the main process or not, as the module will automatically handle setting itself up in the main process. If using a packer, it may be necessary to disable the use of remote.require via the NO_REMOTE_REQUIRE environment variable. If NO_REMOTE_REQUIRE is set, then you must ensure that the main process requires electron-app-settings as well as the renderer process.
The configuration file is presumed to be located at "userData/Settings" and will be saved on application quit.
// MAIN PROCESS
const settings = require('electron-app-settings');
settings.set('cat', {
name: 'Cat',
limbs: 4,
fuzzy: true
});
settings.get('cat.name');
// => "Cat"
settings.has('cat.bark');
// => false
/* Object-only merge-style defaults */
settings.set({
{ dog: {
name: "Dog",
tail: true
}
}, true);
settings.get('cat');
// => {name: "Cat", limbs: 4, fuzzy: true, tail: true}
settings.get('dog');
// => {name: "Dog", tail: true}
// RENDERER PROCESS
const settings = require('electron-app-settings');
// ... on app-ready
settings.get('cat');
// => {name: "Cat", limbs: 4, fuzzy: true, tail: true}electron-app-settings also has a Promise-style API accessible through the promises property of the settings object returned via require('electron-app-settings'). It functions exactly the same as the normal API with any return values being returned through the Promise's resolve callback. Access through the promises interface ensures that full renderer to main process IPC communication has already been completed.
// RENDERER PROCESS
const settings = require('electron-app-settings');
// ... somewhere in an async function
await settings.promises.get('cat');
// => {name: "Cat", limbs: 4, fuzzy: true, tail: true}
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent