Command line switches supported by Electron.
You can use app.commandLine.appendSwitch to append them in your app’s main script before the ready event of the app module is emitted:
const {app} = require('electron')
app.commandLine.appendSwitch('remote-debugging-port', '8315')
app.commandLine.appendSwitch('host-rules', 'MAP * 127.0.0.1')
app.on('ready', () => {
// Your code here
})
domains
Ignore the connections limit for domains
list separated by ,
.
Disables the disk cache for HTTP requests.
Disable HTTP/2 and SPDY/3.1 protocols.
port
and –inspect-brk=port
Debug-related flags, see the Debugging the Main Process guide for details.
port
Enables remote debugging over HTTP on the specified port
.
size
Forces the maximum disk space to be used by the disk cache, in bytes.
flags
Specifies the flags passed to the Node JS engine. It has to be passed when starting Electron if you want to enable the flags
in the main process.
$ electron --js-flags="--harmony_proxies --harmony_collections" your-app
See the Node documentation or run node --help
in your terminal for a list of available flags. Additionally, run node --v8-options
to see a list of flags that specifically refer to Node’s V8 JavaScript engine.
address:port
Use a specified proxy server, which overrides the system setting. This switch only affects requests with HTTP protocol, including HTTPS and WebSocket requests. It is also noteworthy that not all proxy servers support HTTPS and WebSocket requests.
hosts
Instructs Electron to bypass the proxy server for the given semi-colon-separated list of hosts. This flag has an effect only if used in tandem with --proxy-server
.
For example:
const {app} = require('electron')
app.commandLine.appendSwitch('proxy-bypass-list', '<local>;*.google.com;*foo.com;1.2.3.4:5678')
Will use the proxy server for all hosts except for local addresses (localhost
, 127.0.0.1
etc.), google.com
subdomains, hosts that contain the suffix foo.com
and anything at 1.2.3.4:5678
.
url
Uses the PAC script at the specified url
.
Don’t use a proxy server and always make direct connections. Overrides any other proxy server flags that are passed.
rules
A comma-separated list of rules
that control how hostnames are mapped.
For example:
MAP * 127.0.0.1
Forces all hostnames to be mapped to 127.0.0.1MAP *.google.com proxy
Forces all google.com subdomains to be resolved to “proxy”.MAP test.com [::1]:77
Forces “test.com” to resolve to IPv6 loopback. Will also force the port of the resulting socket address to be 77.MAP * baz, EXCLUDE www.google.com
Remaps everything to “baz”, except for “www.google.com”.These mappings apply to the endpoint host in a net request (the TCP connect and host resolver in a direct connection, and the CONNECT
in an HTTP proxy connection, and the endpoint host in a SOCKS
proxy connection).
rules
Like --host-rules
but these rules
only apply to the host resolver.
url
A comma-separated list of servers for which integrated authentication is enabled.
For example:
--auth-server-whitelist='*example.com, *foobar.com, *baz'
then any url
ending with example.com
, foobar.com
, baz
will be considered for integrated authentication. Without *
prefix the url has to match exactly.
url
A comma-separated list of servers for which delegation of user credentials is required. Without *
prefix the url has to match exactly.
Ignores certificate related errors.
path
Sets the path
of the pepper flash plugin.
version
Sets the version
of the pepper flash plugin.
path
Enables net log events to be saved and writes them to path
.
Prevents Chromium from lowering the priority of invisible pages’ renderer processes.
This flag is global to all renderer processes, if you only want to disable throttling in one window, you can take the hack of playing silent audio.
Prints Chromium’s logging into console.
This switch can not be used in app.commandLine.appendSwitch
since it is parsed earlier than user’s app is loaded, but you can set the ELECTRON_ENABLE_LOGGING
environment variable to achieve the same effect.
log_level
Gives the default maximal active V-logging level; 0 is the default. Normally positive values are used for V-logging levels.
This switch only works when --enable-logging
is also passed.
pattern
Gives the per-module maximal V-logging levels to override the value given by --v
. E.g. my_module=2,foo*=3
would change the logging level for all code in source files my_module.*
and foo*.*
.
Any pattern containing a forward or backward slash will be tested against the whole pathname and not just the module. E.g. */foo/bar/*=2
would change the logging level for all code in the source files under a foo/bar
directory.
This switch only works when --enable-logging
is also passed.