Saltar al contenido principal

Cambios de línea de comandos soportados

Opciones de la linea de comandos soportados por Electron.

Puedes usar app.commandLine.appendSwitch para añadirlas en el código principal de tu app antes de que el evento ready del modulo app es emitido:

const { app } = require('electron')
app.commandLine.appendSwitch('remote-debugging-port', '8315')
app.commandLine.appendSwitch('host-rules', 'MAP * 127.0.0.1')

app.whenReady().then(() => {
  // Your code here
})

Banderas de la CLI de Electron​

--auth-server-whitelist=url​

Una lista de servidores separadas por comas por los que la autentificación integrada esta habilitada.

Por ejemplo:

--auth-server-whitelist='*example.com, *foobar.com, *baz'

entonces cualquier url acabando con example.com, foobar.com, baz será considerada por la autentificación integrada. Sin el prefijo * la URL ha de coincidir exactamente.

--auth-negotiate-delegate-whitelist=url​

A comma-separated list of servers for which delegation of user credentials is required. Sin el prefijo * la URL ha de coincidir exactamente.

--disable-ntlm-v2​

Disables NTLM v2 for posix platforms, no effect elsewhere.

--disable-http-cache​

Desactiva la cache de disco para las peticiones HTTP.

--disable-http2​

Desactiva los protocolos HTTP/2 y SPDY/3.

--disable-renderer-backgrounding​

Previene Chromium disminuir la prioridad de los procesos render de páginas invisibles.

Esta opción es global a todos los procesos de render, si solamente quieres deshabilitar el ajuste en una ventana, puedes usar el truco de pasar playing silent audio.

--disk-cache-size=size​

Fuerza el espacio máximo de disco a utilizar por la caché de disco, en bytes.

--enable-logging[=file]​

Prints Chromium's logging to stderr (or a log file).

The ELECTRON_ENABLE_LOGGING environment variable has the same effect as passing --enable-logging.

Passing --enable-logging will result in logs being printed on stderr. Passing --enable-logging=file will result in logs being saved to the file specified by --log-file=..., or to electron_debug.log in the user-data directory if --log-file is not specified.

Note: On Windows, logs from child processes cannot be sent to stderr. Logging to a file is the most reliable way to collect logs on Windows.

See also --log-file, --log-level, --v, and --vmodule.

--force-fieldtrials=trials​

Las pruebas de campo se habilitan o deshabilitan por la fuerza.

Por ejemplo: WebRTC-Audio-Red-For-Opus/Enabled/

--host-rules=rules​

Lista de rules separadas por coma que controlan como los nombres de host son mapeados.

Por ejemplo:

  • MAP * 127.0.0.1 Fuerza todos los nombres de host a ser mapeados a 127.0.0.1
  • MAP *.google.com proxy Fuerza todos los subdominios google.com a ser resueltos como "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 Mapeara todo a "baz", excepto para "www.google.com".

Estos mapeados aplican al host punto final en una petición de red (la conexión TCP y el host se solventan en una conexión directa, CONNECT en una conexión HTTP proxy, y el host punto fila en una conexión proxy SOCKS).

--host-resolver-rules=rules​

Como --host-rules pero estas rules solamente aplican a el host resolutor.

--ignore-certificate-errors​

Ignora los errores relacionados con el certificado.

--ignore-connections-limit=domains​

Ignore el limite de conexión para la lista de domains separados por ,.

--js-flags=flags​

Specifies the flags passed to the V8 engine. In order to enable the flags in the main process, this switch must be passed on startup.

$ electron --js-flags="--harmony_proxies --harmony_collections" your-app

Run node --v8-options or electron --js-flags="--help" in your terminal for the list of available flags. These can be used to enable early-stage JavaScript features, or log and manipulate garbage collection, among other things.

For example, to trace V8 optimization and deoptimization:

$ electron --js-flags="--trace-opt --trace-deopt" your-app

--lang​

Establecer una configuración regional personalizada.

--log-file=path​

If --enable-logging is specified, logs will be written to the given path. The parent directory must exist.

Setting the ELECTRON_LOG_FILE environment variable is equivalent to passing this flag. If both are present, the command-line switch takes precedence.

--log-net-log=path​

Habilita el registro de los eventos de red para ser salvados y escritos en la ruta path.

--log-level=N​

Sets the verbosity of logging when used together with --enable-logging. N should be one of Chrome's LogSeverities.

Note that two complimentary logging mechanisms in Chromium -- LOG() and VLOG() -- are controlled by different switches. --log-level controls LOG() messages, while --v and --vmodule control VLOG() messages. So you may want to use a combination of these three switches depending on the granularity you want and what logging calls are made by the code you're trying to watch.

See Chromium Logging source for more information on how LOG() and VLOG() interact. Loosely speaking, VLOG() can be thought of as sub-levels / per-module levels inside LOG(INFO) to control the firehose of LOG(INFO) data.

See also --enable-logging, --log-level, --v, and --vmodule.

--no-proxy-server​

Don't use a proxy server and always make direct connections. Overrides any other proxy server flags that are passed.

--no-sandbox​

Disables the Chromium sandbox. Forces renderer process and Chromium helper processes to run un-sandboxed. Solo debe usarse para pruebas.

--proxy-bypass-list=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.

Por ejemplo:

const { app } = require('electron')
app.commandLine.appendSwitch('proxy-bypass-list', '<local>;*.google.com;*foo.com;1.2.3.4:5678')

Utilizará el servidor proxy para todos los host excepto para las direcciones locales (localhost, 127.0.0.1 etc.), subdominios google.com, hosts que contienen el sufijo foo.com y cualquiera en 1.2.3.4:5678.

--proxy-pac-url=url​

Usa el programa PAC en la url especificada.

--proxy-server=address:port​

Usa un servidor proxy especifico, el cual sobrescribe la configuración del sistema. Esta opción solo afecta peticiones con protocolo HTTP, incluyendo peticiones HTTPS y WebSocket. También cabe destacar que no todos los servidores proxy aceptan peticiones HTTPS y WebSocket. La URL del proxy no soporta la autenticacón usuario y clave per Chromium issue.

--remote-debugging-port=port​

Habilita depuración remota sobre HTTP en el port especificado.

--v=log_level​

Gives the default maximal active V-logging level; 0 is the default. Normally positive values are used for V-logging levels.

Esta opción solo funciona cuando --enable-logging es también pasada.

See also --enable-logging, --log-level, and --vmodule.

--vmodule=pattern​

Permite que el nivel máximo por module de V-logging sobrepase el valor dado por --v. P.e. my_module=2,foo*=3 would change the logging level for all code in source files my_module.* and foo*.*.

Cualquier patrón que contenga una barra hacia adelante o una barra hacia atras será probado contra el nombre de la ruta completa y no solo contra el módulo. P.e. */foo/bar/*=2 would change the logging level for all code in the source files under a foo/bar directory.

Esta opción solo funciona cuando --enable-logging es también pasada.

See also --enable-logging, --log-level, and --v.

--force_high_performance_gpu​

Force using discrete GPU when there are multiple GPUs available.

--force_low_power_gpu​

Force using integrated GPU when there are multiple GPUs available.

Banderas Node.js​

Electron soporta algunas de las CLI flags soportadas por Node.js.

Note: Passing unsupported command line switches to Electron when it is not running in ELECTRON_RUN_AS_NODE will have no effect.

--inspect-brk\[=\[host:]port]​

Activate inspector on host:port and break at start of user script. Default host:port is 127.0.0.1:9229.

Aliased to --debug-brk=[host:]port.

--inspect-brk-node[=[host:]port]​

Activate inspector on host:port and break at start of the first internal JavaScript script executed when the inspector is available. Default host:port is 127.0.0.1:9229.

--inspect-port=\[host:]port​

Set the host:port to be used when the inspector is activated. Useful when activating the inspector by sending the SIGUSR1 signal. Default host is 127.0.0.1.

Aliased to --debug-port=[host:]port.

--inspect\[=\[host:]port]​

Activate inspector on host:port. Por defecto es 127.0.0.1:9229.

V8 inspector integration allows tools such as Chrome DevTools and IDEs to debug and profile Electron instances. The tools attach to Electron instances via a TCP port and communicate using the Chrome DevTools Protocol.

Vea la guía de Debugging the Main Process para más detalles.

Aliased to --debug[=[host:]port.

--inspect-publish-uid=stderr,http​

Specify ways of the inspector web socket url exposure.

By default inspector websocket url is available in stderr and under /json/list endpoint on http://host:port/json/list.

--no-deprecation​

Silence deprecation warnings.

--throw-deprecation​

Throw errors for deprecations.

--trace-deprecation​

Print stack traces for deprecations.

--trace-warnings​

Print stack traces for process warnings (including deprecations).

--dns-result-order=order​

Set the default value of the verbatim parameter in the Node.js dns.lookup() and dnsPromises.lookup() functions. The value could be:

  • ipv4first: sets default verbatim false.
  • verbatim: sets default verbatim true.

The default is verbatim and dns.setDefaultResultOrder() have higher priority than --dns-result-order.