Aller au contenu principal

Paramètres de Commande en ligne Supportés

Paramètres de ligne de commande pris en charge par Electron.

Vous pouvez utiliser app.commandLine.appendSwitch pour l'ajouter au script principal de votre application avant que l'événement ready du module app soit émis :

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

Une liste de serveurs séparés par des virgules pour lesquels l'authentification intégrée est activée.

Par exemple :

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

puis toute url finissant par example.com, foobar.com, baz se verra appliquer une authentification intégrée. Sans le préfixe * l'URL doit correspondre exactement.

--auth-negotiate-delegate-whitelist=url

A comma-separated list of servers for which delegation of user credentials is required. Sans le préfixe * l'URL doit correspondre exactement.

--disable-ntlm-v2

Disables NTLM v2 for posix platforms, no effect elsewhere.

--disable-http-cache

Désactive le cache disque pour les requêtes HTTP.

--disable-http2

Désactive les protocoles HTTP/2 et SPDY/3.1.

--disable-renderer-backgrounding

Empêche Chromium d'abaisser la priorité des processus de rendu des pages invisibles.

Ce commutateur est global à tous les processus de rendu, si vous voulez seulement désactiver l'ajustement d'une fenêtre, vous pouvez passer par la modification de playing silent audio.

--disk-cache-size=size

Force l'espace disque maximum à utiliser par le cache disque, en octets.

--enable-api-filtering-logging

Enables caller stack logging for the following APIs (filtering events):

  • 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

Les essais sur le terrain doivent être activés ou désactivés de force.

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

--host-rules=rules

Une liste séparée par des virgules de rules qui contrôle comment les noms d'hôtes sont mappés.

Par exemple :

  • MAP * 127.0.0.1 Force tous les noms d'hôtes à être mappés à 127.0.0.1
  • MAP *.google.com proxy Force tous les sous-domaines google.com à être résolus en "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 Remappe tout à "baz", sauf pour "www.google.com".

Ces mappages s'appliquent à l'hôte ciblé dans une requête réseau (le résolveur de connexion et d'hôte TCP dans une connexion directe, et l'hôte CONNECT dans une connexion avec proxy HTTP, et l'hôte du point terminal dans une connexion proxy SOCKS).

--host-resolver-rules=rules

Comme --host-rules mais ces rules ne s'appliquent qu'au résolveur hôte.

--ignore-certificate-errors

Ignore les erreurs relatives au certificat.

--ignore-connections-limit=domains

Ignore la limite de connexion pour la liste de domains séparés par ,.

--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" votre-app

Consultez la documentation Node.js ou exécutez node --help dans votre terminal pour une liste des drapeaux disponibles. De plus, exécutez node --v8-options pour voir une liste de drapeaux qui se réfèrent spécifiquement au moteur JavaScript V8 de Node.js.

--lang

Permet de mettre une langue personnalisée.

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

Permet que les événements réseau net log soient sauvés et les écrit dans 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

N'utilisez pas de serveur proxy et établissez toujours des connexions directes. Overrides any other proxy server flags that are passed.

--no-sandbox

Désactive le bac à sable Chromium. Force le processus de rendu et les processus d'assistance Chromium à s'exécuter sans bac à sable. Ne doit être utilisé que pour les tests.

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

Par exemple :

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

Utilise le serveur proxy pour tous les hôtes sauf les adresses locales (localhost, 127.0.0.1, etc.), les sous-domaines google.com, les hôtes qui contiennent le suffixe foo. com et tout ce qui est à 1.2.3.4:5678.

--proxy-pac-url=url

Utilise le script PAC à l'url spécifiée.

--proxy-server=address:port

Utilise le serveur proxy spécifié, qui remplace le paramètre système. Cet indicateur n'affecte que les requêtes avec le protocole HTTP, y compris les requêtes HTTPS et WebSocket. Il est également intéressant de noter que tous les serveurs proxy ne supportent pas les requêtes HTTPS et WebSocket. L'url du proxy ne supporte pas l'authentification par nom d'utilisateur et mot de passe selon un bug Chronium.

--remote-debugging-port=port

Active le débogage distant via HTTP sur le port spécifié.

--v=log_level

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

Ce commutateur ne fonctionne que si --enable-logging est également fourni.

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

--vmodule=pattern

Permet que les niveaux maximum par module de V-logging puisse dépasser la valeur donnée par --v. Exemple : my_module=2,foo*=3 would change the logging level for all code in source files my_module.* and foo*.*.

Tout pattern contenant un slash ou un anti-slash sera testé pour tout le chemin et pas seulement le module. Exemple : */foo/bar/*=2 would change the logging level for all code in the source files under a foo/bar directory.

Ce commutateur ne fonctionne que si --enable-logging est également fourni.

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 prend en charge certains des drapeaux CLI pris en charge par Node.js.

Remarque : Le passage d'options de ligne de commande non supportées n'aura aucun effet lorsque Electron ne s'exécute pas en mode ELECTRON_RUN_AS_NODE.

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

Activate inspector on host:port and break at start of user script. Configuration par défaut pour host:port 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. Utile lors de l’activation de l’inspecteur en envoyant le signal SIGUSR1. L'hôte par défaut est 127.0.0.1.

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

--inspect[=[host:]port]

Activate inspector on host:port. Par défaut la valeur est 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.

Par défaut, l'url du websocket de l'inspecteur est disponible dans stderr et dans /json/list endpoint sur http://host:port/json/list.