Перейти к основному содержанию

Поддерживаемые параметры командной строки

Параметры командной строки поддерживаемые 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.whenReady().then(() => {
  // Your code here
})

Electron CLI Flags​

--auth-server-whitelist=ссылка​

Список серверов (разделенные запятой), для которых разрешена интегрированная аутентификация.

Например:

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

тогда любая ссылка заканчивающаяся на example.com, foobar.com и baz будут рассматриваться для интегрированной аутентификации. Без префикса *, ссылка будет полностью соответствовать.

--auth-negotiate-delegate-whitelist=ссылка​

A comma-separated list of servers for which delegation of user credentials is required. Без префикса *, ссылка будет полностью соответствовать.

--disable-ntlm-v2​

Disables NTLM v2 for POSIX platforms, no effect elsewhere.

--disable-http-cache​

Отключить кэширование на жёсткий диск для HTTP запросов.

--disable-http2​

Отключить HTTP/2 и SPDY/3.1 протоколы.

--disable-renderer-backgrounding​

Предотвращает Chromium от понижения приоритета для невидимых страниц графических процессов.

Этот параметр глобален для всех графических процессов, если Вы хотите отключить троттлинг в одном окне, Вы может использовать трюк с проигрыванием беззвучных звуков.

--disk-cache-size=размер​

Максимальный размер кеша на жёстком диске в байтах.

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

Field trials to be forcefully enabled or disabled.

For example: WebRTC-Audio-Red-For-Opus/Enabled/

--host-rules=правила​

Список правил, разделённых точкой с запятой, которые контролируют как сопоставляются имена хостов.

Например:

  • MAP * 127.0.0.1 Все имена хостов будут перенаправлены на 127.0.0.1
  • MAP *.google.com proxy Заставляет все поддомены google.com обращаться к "proxy".
  • MAP test.com [::1]:77 Forces "test.com" to resolve to IPv6 loopback. Также принудительно выставит порт получаемого адреса сокета, равный 77.
  • MAP * baz, EXCLUDE www.google.com Перенаправляет всё на "baz", за исключением "www.google.com".

Эти перенаправления применяются к хосту конечной точки в сетевом запросе (TCP соединения и резолвер хоста в прямых соединениях, CONNECT в HTTP прокси-соединениях и хост конечной точки в SOCKS прокси-соединений).

--host-resolver-rules=правила​

Как --host-rules, но эти правила применяются только к резолверу хоста.

--ignore-certificate-errors​

Игнорирует ошибки, связанные с сертификатами.

--ignore-connections-limit=домены​

Игнорировать лимит подключения для списка доменов, разделённых ,.

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

Установить пользовательский язык.

--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=путь​

Включает логи сетевых событий для сохранения и записывает их в путь.

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

Не использовать прокси сервер и всегда делать прямые соединения. Переопределяет все остальные флаги прокси-сервера, которые были указаны.

--no-sandbox​

Disables the Chromium sandbox. Forces renderer process and Chromium helper processes to run un-sandboxed. Should only be used for testing.

--proxy-bypass-list=хосты​

Указывает Electron обходить прокси-сервер для списка хостов, разделённых точкой с запятой. Этот флаг действует только в том случае, если он используется вместе с --proxy-server.

Например:

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

Будет использовать прокси сервер для всех хостов, за исключением локальных адресов (localhost, 127.0.0.1 и т. д.), google.com поддоменов, хостов которые содержат foo.com и 1.2.3.4:5678.

--proxy-pac-url=ссылка​

Использовать PAC скрипт для указанного url.

--proxy-server=адрес:порт​

Использует указанный proxy сервер, который перезаписывает системные настройки. Этот параметр влияет только на запросы HTTP протокола, включая HTTPS и WebSocket. Примечательно также, что не все proxy серверы поддерживают HTTPS и WebSocket протоколы. В URL для прокси не поддерживается указание имени пользователя и пароля для аутентификации, из-за проблемы в Chromium.

--remote-debugging-port=порт​

Включает удалённую отладку через HTTP для указанного порта.

--v=уровень_логирования​

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

Этот параметр работает только когда --enable-logging также указан.

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

--vmodule=шаблон​

Дает на каждый модуль максимальный уровень V-логирования, чтобы переопределить значения, заданное --v. Например, my_module=2,foo*=3 would change the logging level for all code in source files my_module.* and foo*.*.

Любой шаблон, содержащий переднюю или обратную косую черту, будет протестирован против всего пути, а не только модуля. Например, */foo/bar/*=2 would change the logging level for all code in the source files under a foo/bar directory.

Этот параметр работает только когда --enable-logging также указан.

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.

Node.js Flags​

Electron поддерживает некоторые из флагов CLI, поддерживаемых 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. По умолчанию 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.

See the Debugging the Main Process guide for more details.

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.