ABCDEFGHIJKLMNOPQRSTUVWXYZAA
1
FlagWebPageTestPuppeteerPlaywright
Chrome launcher
Chromedriver
karma-c-lCatapultSumFlag description from chrome-flags-for-tools.md or peter.sh
Note: '👍' (indicating usage) means it's in the impl, but could be behind a conditional.
'😨' means a flag thats removed
2
--disable-default-apps👍👍👍👍👍👍👍7Disable installation of default apps
3
--no-first-run👍👍👍👍👍👍👍7Skip first run wizards
4
--disable-background-networking👍👍👍👍👍👍6
Disable various background network services, including extension updating,safe browsing service, upgrade detector, translate, UMA
5
--password-store👍👍👍👍👍👍6
Avoid potential instability of using Gnome Keyring or KDE wallet. [chromium/linux/password_storage.md](https://chromium.googlesource.com/chromium/src/+/main/docs/linux/password_storage.md) https://crbug.com/571003
6
--user-data-dir👍👍👍👍👍👍6Directory where the browser stores the user profile.
7
--disable-background-timer-throttling👍👍👍👍👍5Disable timers being throttled in background pages/tabs
8
--disable-backgrounding-occluded-windows👍👍👍👍👍5
Normally, Chrome will treat a 'foreground' tab instead as _backgrounded_ if the surrounding window is occluded (aka visually covered) by another window. This flag disables that.
9
--disable-client-side-phishing-detection👍👍👍👍👍5Disables client-side phishing detection
10
--disable-component-update👍👍👍👍👍5Don't update the browser 'components' listed at chrome://components/
11
--disable-renderer-backgrounding👍👍👍👍👍5
This disables non-foreground tabs from getting a lower process priority This doesn't (on its own) affect timers or painting behavior. [karma-chrome-launcher#123](https://github.com/karma-runner/karma-chrome-launcher/issues/123)
12
--disable-sync👍👍👍👍👍5Disable syncing to a Google account
13
--metrics-recording-only👍👍👍👍👍5Disable reporting to UMA, but allows for collection
14
--no-default-browser-check👍👍👍👍👍5Disable the default browser check, do not prompt to set it as such
15
--remote-debugging-port👍👍👍👍👍5
With a value of 0, Chrome will automatically select a useable port _and_ will set `navigator.webdriver` to `true`.
16
--use-mock-keychain👍👍👍👍👍5
Use mock keychain on Mac to prevent the blocking permissions dialog asking: _Do you want the application “Chromium.app” to accept incoming network connections?_
17
--disable-component-extensions-with-background-pages
👍👍👍👍4Disable some built-in extensions that aren't affected by `--disable-extensions
18
--disable-dev-shm-usage👍👍👍👍4
Often used in Lambda, Cloud Functions scenarios. ([pptr issue](https://github.com/GoogleChrome/puppeteer/issues/1834), [crbug](https://bugs.chromium.org/p/chromium/issues/detail?id=736452))
19
--disable-features=MediaRouter👍👍👍👍4
Disable the [Chrome Media Router](https://chromium.googlesource.com/chromium/src/+/HEAD/docs/media/media_router.md) which creates some background network activity to discover castable targets.
20
--disable-features=Translate👍👍👍👍4
Disables Chrome translation, both the manual option and the popup prompt when a page with differing language is detected.
21
--disable-hang-monitor👍👍👍👍4
Suppresses hang monitor dialogs in renderer processes. This flag may allow slow unload handlers on a page to prevent the tab from closing.
22
--disable-ipc-flooding-protection👍👍👍👍4
Some javascript functions can be used to flood the browser process with IPC. By default, protection is on to limit the number of IPC sent to 10 per second per frame. This flag disables it. https://crrev.com/604305
23
--disable-popup-blocking👍👍👍👍4Disable popup blocking. `--block-new-web-contents` is the strict version of this.
24
--disable-prompt-on-repost👍👍👍👍4Reloading a page that came from a POST normally prompts the user.
25
--enable-automation👍👍👍👍4
Disable a few things considered not appropriate for automation. ([Original design doc](https://docs.google.com/a/google.com/document/d/1JYj9K61UyxIYavR8_HATYIglR9T_rDwAtLLsD3fbDQg/preview), though renamed [here](https://codereview.chromium.org/2564973002#msg24)) [codesearch](https://cs.chromium.org/search/?q=kEnableAutomation&type=cs). Note that some projects have chosen to **avoid** using this flag: [web-platform-tests/wpt/#6348](https://github.com/web-platform-tests/wpt/pull/6348), [crbug.com/1277272](https://crbug.com/1277272). It... sets `window.navigator.webdriver` to `true` within all JS contexts. This is also set [when using](https://source.chromium.org/chromium/chromium/src/+/main:content/child/runtime_features.cc;l=374-376;drc=4a843634b8b3006e431add55968f6f45ee54d35e) `--headless`, `--remote-debugging-pipe` and `--remote-debugging-port=0` (yes, [_specifically_ 0](https://source.chromium.org/chromium/chromium/src/+/main:content/child/runtime_features.cc;l=412-427;drc=4a843634b8b3006e431add55968f6f45ee54d35e)).. disables bubble notification about running development/unpacked extensions ([source](https://source.chromium.org/chromium/chromium/src/+/main:chrome/browser/ui/extensions/extension_message_bubble_factory.cc;l=71-76;drc=1e6c1a39cbbc1dcad6e7828661d74d76463465ed)). disables the password saving UI (which [covers](https://source.chromium.org/chromium/chromium/src/+/main:chrome/browser/password_manager/chrome_password_manager_client.cc;l=301-308;drc=1e6c1a39cbbc1dcad6e7828661d74d76463465ed) the usecase of the [defunct](https://bugs.chromium.org/p/chromedriver/issues/detail?id=1015) `--disable-save-password-bubble` flag). disables infobar animations ([source](https://source.chromium.org/chromium/chromium/src/+/main:components/infobars/content/content_infobar_manager.cc;l=48-52;drc=1e6c1a39cbbc1dcad6e7828661d74d76463465ed)). disables auto-reloading on network errors ([source](https://source.chromium.org/chromium/chromium/src/+/main:chrome/browser/chrome_content_browser_client.cc;l=1328-1331;drc=1e6c1a39cbbc1dcad6e7828661d74d76463465ed)). enables the CDP method [`Browser.getBrowserCommandLine`](https://chromedevtools.github.io/devtools-protocol/tot/Browser/#method-getBrowserCommandLine).. avoids showing these 4 infobars: ShowBadFlagsPrompt, GoogleApiKeysInfoBarDelegate, ObsoleteSystemInfoBarDelegate, LacrosButterBar. adds this infobar: ![image](https://user-images.githubusercontent.com/39191/30349667-92a7a086-97c8-11e7-86b2-1365e3d407e3.png) ... which is known to [adversely affect screenshots](https://bugs.chromium.org/p/chromium/issues/detail?id=1277272)..
26
--headless👍👍👍👍4Run in headless mode, i.e., without a UI or display server dependencies.
27
--mute-audio👍👍👍👍4Mute any audio
28
--allow-pre-commit-input👍👍👍3
Allows processing of input before a frame has been committed. Used by headless. https://crbug.com/987626
29
--disable-breakpad👍👍👍3Disable crashdump collection (reporting is already disabled in Chromium)
30
--disable-extensions👍👍👍3Disable all chrome extensions
31
--disable-features=OptimizationHints👍👍👍3
Disable the [Chrome Optimization Guide](https://chromium.googlesource.com/chromium/src/+/HEAD/components/optimization_guide/) and networking with its service API
32
--ignore-certificate-errors👍👍👍3
33
--auto-open-devtools-for-tabs👍👍2
This flag makes Chrome auto-open DevTools window for each tab. It is intended to be used by developers and automation to not require user interaction for opening DevTools.
34
--disable-back-forward-cache👍👍2Disables the BackForwardCache feature.
35
--disable-device-discovery-notifications😨😨2
Removed. Avoided messages like "New printer on your network". [Replaced](https://crbug.com/1020447#c1) with `--disable-features=MediaRouter`.
36
--disable-features=AcceptCHFrame👍👍2
Disable accepting h2/h3 [ACCEPT_CH](https://datatracker.ietf.org/doc/html/draft-davidben-http-client-hint-reliability-02#section-4.3) Client Hints frames.
37
--disable-features=BackForwardCache👍👍2Disable the bfcache.
38
--disable-gpu👍👍2
Was often [used](https://bugs.chromium.org/p/chromium/issues/detail?id=737678) along with `--headless`, but as of 2021, isn't needed.
39
--disable-setuid-sandbox👍👍2Disable the setuid sandbox (Linux only).
40
--enable-logging👍👍2Logging behavior slightly more appropriate for a server-type process.
41
--export-tagged-pdf👍👍2
42
--force-color-profile👍👍2Force all monitors to be treated as though they have the specified color profile.
43
--hide-scrollbars👍👍2Hide scrollbars from screenshots.
44
--host-resolver-rules👍👍2These mappings only apply to the host resolver.
45
--load-extension👍👍2Comma-separated list of paths to extensions to load at startup.
46
--no-sandbox👍👍2
[Sometimes used](https://github.com/puppeteer/puppeteer/blob/main/docs/troubleshooting.md#setting-up-chrome-linux-sandbox) with headless, though not recommended.
47
--no-service-autorun👍👍2
Disables the service process from adding itself as an autorun process. This does not delete existing autorun registrations, it just prevents the service from registering a new one.
48
--proxy-bypass-list👍👍2
Specifies a list of hosts for whom we bypass proxy settings and use direct connections. Ignored unless --proxy-server is also specified. This is a comma-separated list of bypass rules. See: "net/proxy_resolution/proxy_bypass_rules.h" for the format of these rules.
49
--proxy-server👍👍2
Uses a specified proxy server, overrides system settings. This switch only affects HTTP and HTTPS requests.
50
--remote-debugging-pipe👍👍2more secure than using protocol over a websocket
51
--window-size👍👍2Sets the initial window size. Provided as string in the format "800,600".
52
--allow-running-insecure-content👍1
53
--allow-software-compositing👍1
54
--autoplay-policy👍1
Value of `user-gesture-required` to not autoplay video. Value of `no-user-gesture-required` to always autoplay video.
55
--blink-settings👍1
Set blink settings. Format is <name>[=<value],<name>[=<value>],... The names are declared in Settings.json5. For boolean type, use "true", "false", or omit '=<value>' part to set to true. For enum type, use the int value of the enum value. Applied after other command line flags and prefs.
56
--data-path👍1
Makes Content Shell use the given path for its data directory. NOTE: If changing this value, change the corresponding Java-side value in ContentShellBrowserTestActivity.java#getUserDataDirectoryCommandLineSwitch() to match.
57
--deny-permission-prompts👍1Suppress all permission prompts by automatically denying them.
58
--disable-domain-reliability👍1
Disables Domain Reliability Monitoring, which tracks whether the browser has difficulty contacting Google-owned sites and uploads reports to Google.
59
--disable-features=AutoExpandDetailsElement😨1
Removed in [Sept 2022](https://bugs.chromium.org/p/chromium/issues/detail?id=1185950#c62).
60
--disable-features=AutofillServerCommunication
👍1
Disables (mostly for hermetic testing) autofill server communication. The URL of the autofill server can further be controlled via the autofill-server-url param. The given URL should specify the complete autofill server API url up to the parent "directory" of the "query" and "upload" resources. i.e., https://other.autofill.server:port/tbproxy/af/
61
--disable-features=AvoidUnnecessaryBeforeUnloadCheckSync
👍1
If enabled, this feature results in the browser process only asking the renderer process to run beforeunload handlers if it knows such handlers are registered. With `kAvoidUnnecessaryBeforeUnloadCheckSync`, content does not report a beforeunload handler is present. A ramification of this is navigations that would normally check beforeunload handlers before continuing will not, and navigation will synchronously continue.
62
--disable-features=CalculateNativeWinOcclusion
👍1
Disable the feature of: Calculate window occlusion on Windows will be used in the future to throttle and potentially unload foreground tabs in occluded windows.
63
--disable-features=CertificateTransparencyComponentUpdater
👍1
64
--disable-features=DestroyProfileOnBrowserClose
👍1
Disable the feature of: Destroy profiles when their last browser window is closed, instead of when the browser exits.
65
--disable-features=DialMediaRouteProvider👍1
Avoid the startup dialog for _Do you want the application “Chromium.app” to accept incoming network connections?_. This is a sub-component of the MediaRouter.
66
--disable-features=GlobalMediaControls👍1Hide toolbar button that opens dialog for controlling media sessions.
67
--disable-features=HeavyAdPrivacyMitigations👍1
Disables the privacy mitigations for the heavy ad intervention. This throttles the amount of interventions that can occur on a given host in a time period. It also adds noise to the thresholds used. This is separate from the intervention feature so it does not interfere with field trial activation, as this blocklist is created for every user, and noise is decided prior to seeing a heavy ad.
68
--disable-features=ImprovedCookieControls👍1Disables an improved UI for third-party cookie blocking in incognito mode.
69
--disable-features=InterestFeedContentSuggestions
👍1Disables the Discover feed on NTP
70
--disable-features=IsolateOrigins👍1
71
--disable-features=LazyFrameLoading👍1
72
--disable-features=OfflinePagesPrefetching👍1
73
--disable-features=PrivacySandboxSettings4👍1Disables "Enhanced ad privacy in Chrome" dialog. (If it wasn't disabled through other means)
74
--disable-features=site-per-process👍1Disables OOPIF. https://www.chromium.org/Home/chromium-security/site-isolation
75
--disable-features=TranslateUI😨1
Removed as `TranslateUI` changed to `Translate` in [Sept 2020](https://chromium-review.googlesource.com/c/chromium/src/+/2404484).
76
--disable-field-trial-config👍1Disable field trial tests configured in fieldtrial_testing_config.json.
77
--disable-search-geolocation-disclosure👍1
78
--disable-site-isolation-trials👍1
Disables site isolation. Note that the opt-in (to site-per-process, isolate-origins, etc.) via enterprise policy and/or cmdline takes precedence over the kDisableSiteIsolation switch (i.e. the opt-in takes effect despite potential presence of kDisableSiteIsolation switch). Note that for historic reasons the name of the switch misleadingly mentions "trials", but the switch also disables the default site isolation that ships on desktop since M67. The name of the switch is preserved for backcompatibility of chrome://flags.
79
--disable-translate😨1
[Removed April 2017](https://codereview.chromium.org/2819813002/) Used to disable built-in Google Translate service.
80
--enable-blink-features=IdleDetection👍1
81
--enable-blink-features=ShadowDOMV0👍1
82
--enable-crash-reporter-for-testing👍1
Used for turning on Breakpad crash reporting in a debug environment where crash reporting is typically compiled but disabled.
83
--enable-features=NetworkService👍1
84
--enable-features=NetworkServiceInProcess👍1
85
--enable-features=NetworkServiceInProcess2👍1
86
--enable-features=SecMetadata👍1
87
--enable-gpu-benchmarking👍1Enables the GPU benchmarking extension
88
--enable-net-benchmarking👍1Enables the network-related benchmarking extensions.
89
--enable-use-zoom-for-dsf👍1
90
--force-fieldtrials👍1
This option can be used to force field trials when testing changes locally. The argument is a list of name and value pairs, separated by slashes. If a trial name is prefixed with an asterisk, that trial will start activated. For example, the following argument defines two trials, with the second one activated: "GoogleNow/Enable/*MaterialDesignNTP/Default/" This option can also be used by the browser process to send the list of trials to a non-browser process, using the same format. See FieldTrialList::CreateTrialsFromString() in field_trial.h for details.
91
--ignore-background-tasks👍1
92
--ignore-certificate-errors-spki-list👍1
A set of public key hashes for which to ignore certificate-related errors. If the certificate chain presented by the server does not validate, and one or more certificates have public key hashes that match a key from this list, the error is ignored. The switch value must be a comma-separated list of Base64-encoded SHA-256 SPKI Fingerprints (RFC 7469, Section 2.4). This switch has no effect unless --user-data-dir (as defined by the content embedder) is also present.
93
--js-flags👍1Initialize V8's RNG with a fixed seed.
94
--log-level👍1
0 means INFO and higher. `2` is the most verbose. Protip: Use `--enable-logging=stderr --v=2` and you may spot additional components active that you may want to disable.
95
--log-net-log👍1
Enables saving net log events to a file. If a value is given, it used as the path the the file, otherwise the file is named netlog.json and placed in the user data directory.
96
--net-log-capture-mode👍1
Sets the granularity of events to capture in the network log. The mode can be set to one of the following values: "Default" "IncludeSensitive" "Everything" See the enums of the corresponding name in net_log_capture_mode.h for a description of their meanings.
97
--new-window👍1Launches URL in new browser window.
98
--no-proxy-server👍1
Don't use a proxy server, always make direct connections. Overrides any other proxy server flags that are passed.
99
--no-startup-window👍1
Does not automatically open a browser window on startup (used when launching Chrome for the purpose of hosting background apps).
100
--ozone-platform👍1Specify ozone platform implementation to use.