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 en ajouter au script principal de votre application avant que l'événement ready du module app ne 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(() => {
// insérez votre code ici
})

Paramètres de la CLI d'Electron

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

Une liste de serveurs séparés par des virgules pour lesquels la délégation des identifiants des utilisateurs est requise. Sans le préfixe * l'URL doit correspondre exactement.

--disable-ntlm-v2

Désactive NTLM v2 pour les plates-formes posix, n'a aucun effet sur les autres.

--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-logging[=file]

Affiche les logs de Chromium sur stderr (ou un fichier log).

La variable d'environnement ELECTRON_ENABLE_LOGGING a le même effet que --enable-logging.

L'usage de --enable-logging entraînera l'affichage des logs sur stderr. --enable-logging=file entraînera l'enregistrement des logs dans le fichier spécifié par --log-file=..., ou à electron_debug.log dans le répertoire des données utilisateur si --log-file n'est pas spécifié.

Remarque : Sur Windows, les logs concernant les processus enfants ne peuvent pas être envoyés à stderr. L'enregistrement dans un fichier est le moyen le plus fiable de collecter les logs sous Windows.

Voir aussi --log-file, --log-level, --v, et --vmodule.

--force-fieldtrials=trials

Les essais sur le terrain seront forcés comme actifs ou inactifs.

Par exemple : 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 Force "test.com" à résoudre la boucle IPv6. Et forcera également le port de l'adresse du socket résultant à 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

Spécifie les drapeaux passés au moteur V8. Afin d'activer l' flags dans le processus principal, ce commutateur doit être passé au démarrage.

$ electron --js-flags="--harmony_proxies --harmony_collections" votre-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

Permet de mettre une locale personnalisée.

--log-file=path

Si --enable-logging est spécifié, les Logs seront écrits dans le chemin donné. Le répertoire parent doit exister.

L'utilisation de la variable d'environnement ELECTRON_LOG_FILE, équivaut à passer ce drapeau. Si les deux sont présents, la priorité est donnée à la ligne de commande.

--log-net-log=path

Permet que les événements réseau net log soient sauvés et les écrit dans path.

--log-level=N

Définit le niveau de verbosité de la journalisation lorsqu'il est utilisée avec --enable-logging. N doit être l'une des Chrome's LogSeverities.

Notez que dans Chromium, il y a deux mécanismes de journalisation-- LOG() et VLOG()-- contrôlés par des commutateurs différents. --log-level contrôle les messages de type LOG() tandis que --v et --vmodule contrôlent ceux de type VLOG() . Vous pouvez utiliser une combinaison de ces trois commutateurs selon la granularité souhaitée et quels appels à la journalisation sont effectués par le code que vous analyser.

Voir Chromium Logging source pour plus d'informations sur les interactions entre LOG() et VLOG(). En gros, VLOG() peut être considéré comme des branches de sous-niveau/ ou par module de LOG(INFO) pour gérer les données de LOG(INFO).

Voir aussi --enable-logging, --log-level, --v, et --vmodule.

--no-proxy-server

Ne pas utiliser de serveur proxy et toujours établir des connexions directes. Ecrase tout autre drapeau de serveur proxy passé.

--no-sandbox

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

--proxy-bypass-list=hosts

Demande à Electron de contourner le serveur proxy pour la liste d'hôtes séparée par des points-virgules fournie . N'a d'effet que s'il est utilisé conjointement avec --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

Configure le niveau maximum actif de V-logging level; 0 étant la valeur par défaut. Normalement des valeurs positives sont utilisées pour les niveaux de V-logging.

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

Voir également --enable-logging, --log-levelet --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 changera le niveau de logging pour tout le code source des fichiers my_module.* et 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 changera le niveau de journalisation pour tout le code dans les fichiers sources du répertoire foo/bar.

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

Voir également --enable-logging, --log-levelet --v.

--force_high_performance_gpu

Force l'utilisation d'un GPU particulier lorsque plusieurs sont disponibles.

--force_low_power_gpu

Force l'utilisation d'un GPU particulier lorsque plusieurs sont disponibles.

Paramètres de Node.js

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]

Active l'inspecteur sur host:port et l'arrête au démarrage du script utilisateur. La Configuration par défaut de host:port est 127.0.0.1:9229.

A l'aide de l'alias --debug-brk=[host:]port.

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

Active l’inspecteur sur host:port et marque un point d'arrêt au début du premier script JavaScript exécuté lorsque l’inspecteur est disponible. Par défaut host:port est à 127.0.0.1:9229.

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

Indique le host:port à utiliser lorsque l'inspecteur est activé. Utile lors de l’activation de l’inspecteur par l'envoi du signal SIGUSR1. L'hôte par défaut est 127.0.0.1.

A l'aide de l'alias --debug-port=[host:]port.

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

Active l'inspecteur sur host:port. La valeur par défaut étant 127.0.0.1:9229.

L'intégration d'inspecteurs V8 permet aux outils tels que Chrome DevTools et les IDEs de déboguer et de profiler des instances d'Electron. Les outils se connectent à ces instances via un port TCP et communiquent à l'aide du protocole Chrome DevTools.

Consultez le guide Débogage du processus principal pour plus de détails.

A l'aide de l'alias --debug[=[host:]port.

--inspect-publish-uid=stderr,http

Spécifie les moyens d'exposer l'url du web socket de l'inspecteur.

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

--no-deprecation

Réduire au silence les avertissements de dépréciation.

--throw-deprecation

Déclenche des erreurs dans le cas de dépréciation.

--trace-deprecation

Affiche les traces de piles pour les dépréciations.

--trace-warnings

Affiche la trace de la pile pour les avertissements de processus (y compris les dépréciations).

--dns-result-order=order

Définissez la valeur par défaut du paramètre verbatim dans les fonctions dns.lookup() et dnsPromises.lookup() de node.js. Cette valeur peut prendre une des valeurs suivantes:

  • ipv4first: mettant par défaut t verbatim à false.
  • verbatim: mettant par défaut t verbatim à true.

La valeur par défaut est verbatim et dns.setDefaultResultOrder() a une priorité plus élevée que --dns-result-order.