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-api-filtering-logging

Habilita el caller stack logging para las siguientes APIs (eventos filtrados):

  • desktopCapturer.getSources() / desktop-capturer-get-sources

--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 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

Vea la Documentación de Node.js o ejecute node --help en su terminal para una lista de las opciones disponibles. Adicionalmente, ejecute node --v8-options para ver una lista de opciones que se refieren específicamente al motor Node.js's V8 JavaScript.

--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-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.