Disable view source for Developer Tools.
[chromium-blink-merge.git] / chrome / common / chrome_switches.cc
blob45dd79cc53a77e76fd3b0a3e27aed860f05a1013
1 // Copyright (c) 2012 The Chromium Authors. All rights reserved.
2 // Use of this source code is governed by a BSD-style license that can be
3 // found in the LICENSE file.
5 #include "chrome/common/chrome_switches.h"
7 #include "base/base_switches.h"
8 #include "base/command_line.h"
10 namespace switches {
12 // -----------------------------------------------------------------------------
13 // Can't find the switch you are looking for? Try looking in:
14 // ash/ash_switches.cc
15 // base/base_switches.cc
16 // chromeos/chromeos_switches.cc
17 // etc.
19 // When commenting your switch, please use the same voice as surrounding
20 // comments. Imagine "This switch..." at the beginning of the phrase, and it'll
21 // all work out.
22 // -----------------------------------------------------------------------------
24 // Allows choosing an existing managed user profile during the managed
25 // user creation flow.
26 const char kAllowCreateExistingManagedUsers[] =
27 "allow-create-existing-managed-users";
29 // Allows third-party content included on a page to prompt for a HTTP basic
30 // auth username/password pair.
31 const char kAllowCrossOriginAuthPrompt[] = "allow-cross-origin-auth-prompt";
33 // On ChromeOS, file:// access is disabled except for certain whitelisted
34 // directories. This switch re-enables file:// for testing.
35 const char kAllowFileAccess[] = "allow-file-access";
37 // Allow non-secure origins to use the screen capture API.
38 const char kAllowHttpScreenCapture[] = "allow-http-screen-capture";
40 // Specifies comma-separated list of extension ids or hosts to grant
41 // access to CRX file system APIs.
42 const char kAllowNaClCrxFsAPI[] = "allow-nacl-crxfs-api";
44 // Specifies comma-separated list of extension ids or hosts to grant
45 // access to file handle APIs.
46 const char kAllowNaClFileHandleAPI[] = "allow-nacl-file-handle-api";
48 // Specifies comma-separated list of extension ids or hosts to grant
49 // access to TCP/UDP socket APIs.
50 const char kAllowNaClSocketAPI[] = "allow-nacl-socket-api";
52 // Don't block outdated plugins.
53 const char kAllowOutdatedPlugins[] = "allow-outdated-plugins";
55 // By default, an https page cannot run JavaScript, CSS or plug-ins from http
56 // URLs. This provides an override to get the old insecure behavior.
57 const char kAllowRunningInsecureContent[] = "allow-running-insecure-content";
59 // Prevents Chrome from requiring authorization to run certain widely installed
60 // but less commonly used plug-ins.
61 const char kAlwaysAuthorizePlugins[] = "always-authorize-plugins";
63 // Specifies that the extension-app with the specified id should be launched
64 // according to its configuration.
65 const char kAppId[] = "app-id";
67 // Specifies that the associated value should be launched in "application"
68 // mode.
69 const char kApp[] = "app";
71 // Specifies an URL to use for app list start page.
72 const char kAppListStartPageURL[] = "app-list-start-page-url";
74 // Flag to enable apps_devtool app.
75 const char kAppsDevtool[] = "apps-devtool";
77 // Specifies the initial size for application windows launched with --app.
78 // --app-window-size=w,h
79 const char kAppWindowSize[] = "app-window-size";
81 // Overrides the apps checkout URL, which is used to determine when to expose
82 // some private APIs.
83 const char kAppsCheckoutURL[] = "apps-checkout-url";
85 // The URL that the webstore APIs download extensions from.
86 // Note: the URL must contain one '%s' for the extension ID.
87 const char kAppsGalleryDownloadURL[] = "apps-gallery-download-url";
89 // A setting to cause extension/app installs from the webstore skip the normal
90 // confirmation dialog. A value of 'accept' means to always act as if the dialog
91 // was accepted, and 'cancel' means to always act as if the dialog was
92 // cancelled.
93 const char kAppsGalleryInstallAutoConfirmForTests[] =
94 "apps-gallery-install-auto-confirm-for-tests";
96 // The URL to use for the gallery link in the app launcher.
97 const char kAppsGalleryURL[] = "apps-gallery-url";
99 // The update url used by gallery/webstore extensions.
100 const char kAppsGalleryUpdateURL[] = "apps-gallery-update-url";
102 // Value of GAIA auth code for --force-app-mode.
103 const char kAppModeAuthCode[] = "app-mode-auth-code";
105 // Value of OAuth2 refresh token for --force-app-mode.
106 const char kAppModeOAuth2Token[] = "app-mode-oauth-token";
108 // Whether to always use the new app install bubble when installing an app.
109 const char kAppsNewInstallBubble[] = "apps-new-install-bubble";
111 // Experimental native frame support for packaged apps.
112 const char kAppsUseNativeFrame[] = "apps-use-native-frame";
114 // Enables overriding the path for the default authentication extension.
115 const char kAuthExtensionPath[] = "auth-ext-path";
117 // Whitelist of servers that Negotiate will generate delegated Kerberos tickets
118 // for.
119 const char kAuthNegotiateDelegateWhitelist[] =
120 "auth-negotiate-delegate-whitelist";
122 // HTTP authentication schemes to enable. This is a comma-separated list of
123 // authentication schemes (basic, digest, ntlm, and negotiate). By default all
124 // schemes are enabled. The primary use of this command line flag is to help
125 // triage authentication-related issues reported by end-users.
126 const char kAuthSchemes[] = "auth-schemes";
128 // Whitelist of servers which NTLM and Negotiate can automatically authenticate
129 // with using the default credentials of the currently logged in user.
130 const char kAuthServerWhitelist[] = "auth-server-whitelist";
132 // A flag that is used to tell Chrome that it was launched automatically at
133 // computer startup and not by some user action.
134 const char kAutoLaunchAtStartup[] = "auto-launch-at-startup";
136 // The value of this switch tells the app to listen for and broadcast
137 // automation-related messages on IPC channel with the given ID.
138 const char kAutomationClientChannelID[] = "automation-channel";
140 // Causes the automation provider to reinitialize its IPC channel instead of
141 // shutting down when a client disconnects.
142 const char kAutomationReinitializeOnChannelError[] =
143 "automation-reinitialize-on-channel-error";
145 // Similar to kNoFirstRun, but also drops the First Run beacon so that first run
146 // will not occur in subsequent runs either.
147 const char kCancelFirstRun[] = "cancel-first-run";
149 // Certificate Transparency: Uses the provided log for checking Signed
150 // Certificate Timestamps provided with certificates.
151 // The switch's value is:
152 // log_description:log_key
153 // where:
154 // log_description is a textual description of the log
155 // log_key is a Base64'd DER-encoded SubjectPublicKeyInfo of the log's
156 // public key.
157 const char kCertificateTransparencyLog[] =
158 "certificate-transparency-log";
160 // How often (in seconds) to check for updates. Should only be used for testing
161 // purposes.
162 const char kCheckForUpdateIntervalSec[] = "check-for-update-interval";
164 // Checks the cloud print connector policy, informing the service process if
165 // the policy is set to disallow the connector, then quits.
166 const char kCheckCloudPrintConnectorPolicy[] =
167 "check-cloud-print-connector-policy";
169 // Comma-separated list of SSL cipher suites to disable.
170 const char kCipherSuiteBlacklist[] = "cipher-suite-blacklist";
172 // Clears the token service before using it. This allows simulating the
173 // expiration of credentials during testing.
174 const char kClearTokenService[] = "clear-token-service";
176 // Used with kCloudPrintFile. Tells Chrome to delete the file when finished
177 // displaying the print dialog.
178 const char kCloudPrintDeleteFile[] = "cloud-print-delete-file";
180 // Tells chrome to display the cloud print dialog and upload the specified file
181 // for printing.
182 const char kCloudPrintFile[] = "cloud-print-file";
184 // Specifies the mime type to be used when uploading data from the file
185 // referenced by cloud-print-file. Defaults to "application/pdf" if
186 // unspecified.
187 const char kCloudPrintFileType[] = "cloud-print-file-type";
189 // Used with kCloudPrintFile to specify a JSON print ticket for the resulting
190 // print job. Defaults to null if unspecified.
191 const char kCloudPrintPrintTicket[] = "cloud-print-print-ticket";
193 // Used with kCloudPrintFile to specify a title for the resulting print job.
194 const char kCloudPrintJobTitle[] = "cloud-print-job-title";
196 // Setup cloud print proxy for provided printers. This does not start
197 // service or register proxy for autostart.
198 const char kCloudPrintSetupProxy[] = "cloud-print-setup-proxy";
200 // The URL of the cloud print service to use, overrides any value stored in
201 // preferences, and the default. Only used if the cloud print service has been
202 // enabled (see enable-cloud-print).
203 const char kCloudPrintServiceURL[] = "cloud-print-service";
205 // Comma-separated options to troubleshoot the component updater. Only valid
206 // for the browser process.
207 const char kComponentUpdater[] = "component-updater";
209 // Causes the browser process to inspect loaded and registered DLLs for known
210 // conflicts and warn the user.
211 const char kConflictingModulesCheck[] = "conflicting-modules-check";
213 // Toggles a new version of the content settings dialog in options.
214 const char kContentSettings2[] = "new-content-settings";
216 // The Country we should use. This is normally obtained from the operating
217 // system during first run and cached in the preferences afterwards. This is a
218 // string value, the 2 letter code from ISO 3166-1.
219 const char kCountry[] = "country";
221 // Comma-separated list of BrowserThreads that cause browser process to crash
222 // if the given browser thread is not responsive. UI,IO,DB,FILE,CACHE are the
223 // list of BrowserThreads that are supported.
225 // For example:
226 // --crash-on-hang-threads=UI:3:18,IO:3:18 --> Crash the browser if UI or IO
227 // is not responsive for 18 seconds and the number of browser threads that
228 // are responding is less than or equal to 3.
229 const char kCrashOnHangThreads[] = "crash-on-hang-threads";
231 // Some platforms like ChromeOS default to empty desktop.
232 // Browser tests may need to add this switch so that at least one browser
233 // instance is created on startup.
234 // TODO(nkostylev): Investigate if this switch could be removed.
235 // (http://crbug.com/148675)
236 const char kCreateBrowserOnStartupForTests[] =
237 "create-browser-on-startup-for-tests";
239 #if defined(OS_ANDROID) || defined(OS_IOS)
240 // If set, the data reduction proxy will only be enabled if a request for this
241 // URL is successful.
242 const char kDataReductionProxyProbeURL[] = "data-reduction-proxy-probe-url";
243 #endif
245 // Enables a frame context menu item that toggles the frame in and out of glass
246 // mode (Windows Vista and up only).
247 const char kDebugEnableFrameToggle[] = "debug-enable-frame-toggle";
249 // Adds debugging entries such as Inspect Element to context menus of packed
250 // apps.
251 const char kDebugPackedApps[] = "debug-packed-apps";
253 // Enables support to debug printing subsystem.
254 const char kDebugPrint[] = "debug-print";
256 // Specifies the URL at which to fetch configuration policy from the device
257 // management backend. Specifying this switch turns on managed policy from the
258 // device management backend.
259 const char kDeviceManagementUrl[] = "device-management-url";
261 // Triggers a plethora of diagnostic modes.
262 const char kDiagnostics[] = "diagnostics";
264 // Sets the output format for diagnostic modes enabled by diagnostics flag.
265 const char kDiagnosticsFormat[] = "diagnostics-format";
267 // Tells the diagnostics mode to do the requested recovery step(s).
268 const char kDiagnosticsRecovery[] = "diagnostics-recovery";
270 // Disables the experimental asynchronous DNS client.
271 const char kDisableAsyncDns[] = "disable-async-dns";
273 // Disables CNAME lookup of the host when generating the Kerberos SPN for a
274 // Negotiate challenge. See HttpAuthHandlerNegotiate::CreateSPN for more
275 // background.
276 const char kDisableAuthNegotiateCnameLookup[] =
277 "disable-auth-negotiate-cname-lookup";
279 // Disables background mode (background apps will not keep chrome running in
280 // the background).
281 const char kDisableBackgroundMode[] = "disable-background-mode";
283 // Disable several subsystems which run network requests in the background.
284 // This is for use when doing network performance testing to avoid noise in the
285 // measurements.
286 const char kDisableBackgroundNetworking[] = "disable-background-networking";
288 // Disables the bundled PPAPI version of Flash.
289 const char kDisableBundledPpapiFlash[] = "disable-bundled-ppapi-flash";
291 // Disables the bookmark autocomplete provider (BookmarkProvider).
292 const char kDisableBookmarkAutocompleteProvider[] =
293 "disable-bookmark-autocomplete-provider";
295 // Disables the client-side phishing detection feature. Note that even if
296 // client-side phishing detection is enabled, it will only be active if the
297 // user has opted in to UMA stats and SafeBrowsing is enabled in the
298 // preferences.
299 const char kDisableClientSidePhishingDetection[] =
300 "disable-client-side-phishing-detection";
302 // Disable default component extensions with background pages - useful for
303 // performance tests where these pages may interfere with perf results.
304 const char kDisableComponentExtensionsWithBackgroundPages[] =
305 "disable-component-extensions-with-background-pages";
307 const char kDisableComponentUpdate[] = "disable-component-update";
309 // Disables establishing certificate revocation information by downloading a
310 // set of CRLs rather than performing on-line checks.
311 const char kDisableCRLSets[] = "disable-crl-sets";
313 // Disables the custom JumpList on Windows 7.
314 const char kDisableCustomJumpList[] = "disable-custom-jumplist";
316 // Disables installation of default apps on first run. This is used during
317 // automated testing.
318 const char kDisableDefaultApps[] = "disable-default-apps";
320 // Disables device discovery.
321 const char kDisableDeviceDiscovery[] = "disable-device-discovery";
323 // Disables device discovery notifications.
324 const char kDisableDeviceDiscoveryNotifications[] =
325 "disable-device-discovery-notifications";
327 // Disables retrieval of PAC URLs from DHCP as per the WPAD standard.
328 const char kDisableDhcpWpad[] = "disable-dhcp-wpad";
330 // Disable extensions.
331 const char kDisableExtensions[] = "disable-extensions";
333 // Disable checking for user opt-in for extensions that want to inject script
334 // into file URLs (ie, always allow it). This is used during automated testing.
335 const char kDisableExtensionsFileAccessCheck[] =
336 "disable-extensions-file-access-check";
338 // Disable the net::URLRequestThrottlerManager functionality for
339 // requests originating from extensions.
340 const char kDisableExtensionsHttpThrottling[] =
341 "disable-extensions-http-throttling";
343 // Disable mandatory enforcement of web_accessible_resources in extensions.
344 const char kDisableExtensionsResourceWhitelist[] =
345 "disable-extensions-resource-whitelist";
347 // Disables Google Now integration.
348 const char kDisableGoogleNowIntegration[] = "disable-google-now-integration";
350 // Disables improved SafeBrowsing download protection.
351 const char kDisableImprovedDownloadProtection[] =
352 "disable-improved-download-protection";
354 // Don't resolve hostnames to IPv6 addresses. This can be used when debugging
355 // issues relating to IPv6, but shouldn't otherwise be needed. Be sure to file
356 // bugs if something isn't working properly in the presence of IPv6. This flag
357 // can be overidden by the "enable-ipv6" flag.
358 const char kDisableIPv6[] = "disable-ipv6";
360 // Disables IP Pooling within the networks stack (SPDY only). When a connection
361 // is needed for a domain which shares an IP with an existing connection,
362 // attempt to use the existing connection.
363 const char kDisableIPPooling[] = "disable-ip-pooling";
365 // Disable the behavior that the second click on a launcher item (the click when
366 // the item is already active) minimizes the item.
367 const char kDisableMinimizeOnSecondLauncherItemClick[] =
368 "disable-minimize-on-second-launcher-item-click";
370 // Disables the menu on the NTP for accessing sessions from other devices.
371 const char kDisableNTPOtherSessionsMenu[] = "disable-ntp-other-sessions-menu";
373 // Disables omnibox auto-completion when IME is active.
374 const char kDisableOmniboxAutoCompletionForIme[] =
375 "disable-omnibox-auto-completion-for-ime";
377 // Disable the origin chip.
378 const char kDisableOriginChip[] = "disable-origin-chip";
380 // Disable using a public suffix based domain matching for autofill of
381 // passwords.
382 const char kDisablePasswordAutofillPublicSuffixDomainMatching[] =
383 "disable-password-autofill-public-suffix-domain-matching";
385 // Disable the setting to prompt the user for their OS account password before
386 // revealing plaintext passwords in the password manager.
387 const char kDisablePasswordManagerReauthentication[] =
388 "disable-password-manager-reauthentication";
390 // Enables searching for people from the apps list search box.
391 const char kDisablePeopleSearch[] = "disable-people-search";
393 // Disable pop-up blocking.
394 const char kDisablePopupBlocking[] = "disable-popup-blocking";
396 // Disables the usage of Portable Native Client.
397 const char kDisablePnacl[] = "disable-pnacl";
399 // Disable speculative TCP/IP preconnection.
400 const char kDisablePreconnect[] = "disable-preconnect";
402 // Disable prerendering based on local browsing history.
403 const char kDisablePrerenderLocalPredictor[] =
404 "disable-prerender-local-predictor";
406 // Disable Privet local printing.
407 const char kDisablePrivetLocalPrinting[] = "disable-privet-local-printing";
409 // Normally when the user attempts to navigate to a page that was the result of
410 // a post we prompt to make sure they want to. This switch may be used to
411 // disable that check. This switch is used during automated testing.
412 const char kDisablePromptOnRepost[] = "disable-prompt-on-repost";
414 // Disables support for the QUIC protocol.
415 const char kDisableQuic[] = "disable-quic";
417 // Disables support for the HTTPS over QUIC protocol. This is a temporary
418 // testing flag. This only has an effect if QUIC protocol is enabled.
419 const char kDisableQuicHttps[] = "disable-quic-https";
421 // Prevents the URLs of BackgroundContents from being remembered and
422 // re-launched when the browser restarts.
423 const char kDisableRestoreBackgroundContents[] =
424 "disable-restore-background-contents";
426 // Disables restoring session state (cookies, session storage, etc.) when
427 // restoring the browsing session.
428 const char kDisableRestoreSessionState[] = "disable-restore-session-state";
430 // Disables throttling prints initiated by scripts.
431 const char kDisableScriptedPrintThrottling[] =
432 "disable-scripted-print-throttling";
434 // Disables the "search button in omnibox" experiment.
435 const char kDisableSearchButtonInOmnibox[] =
436 "disable-search-button-in-omnibox";
438 // Disable SPDY/3.1. This is a temporary testing flag.
439 const char kDisableSpdy31[] = "disable-spdy31";
441 // Disables support of sticky keys.
442 const char kDisableStickyKeys[] = "disable-sticky-keys";
444 // Disables syncing browser data to a Google Account.
445 const char kDisableSync[] = "disable-sync";
447 // Disables syncing of app settings.
448 const char kDisableSyncAppSettings[] = "disable-sync-app-settings";
450 // Disables syncing of apps.
451 const char kDisableSyncApps[] = "disable-sync-apps";
453 // Disables syncing of autofill.
454 const char kDisableSyncAutofill[] = "disable-sync-autofill";
456 // Disables syncing of autofill Profile.
457 const char kDisableSyncAutofillProfile[] = "disable-sync-autofill-profile";
459 // Disables syncing of bookmarks.
460 const char kDisableSyncBookmarks[] = "disable-sync-bookmarks";
462 // Disables syncing of dictionary.
463 const char kDisableSyncDictionary[] = "disable-sync-dictionary";
465 // Disables syncing extension settings.
466 const char kDisableSyncExtensionSettings[] = "disable-sync-extension-settings";
468 // Disables syncing of extensions.
469 const char kDisableSyncExtensions[] = "disable-sync-extensions";
471 // Disables syncing of favicons.
472 const char kDisableSyncFavicons[] = "disable-sync-favicons";
474 // Disables syncing browser passwords.
475 const char kDisableSyncPasswords[] = "disable-sync-passwords";
477 // Disables syncing of preferences.
478 const char kDisableSyncPreferences[] = "disable-sync-preferences";
480 // Disables syncing of priority preferences.
481 const char kDisableSyncPriorityPreferences[] =
482 "disable-sync-priority-preferences";
484 // Disable syncing custom search engines.
485 const char kDisableSyncSearchEngines[] = "disable-sync-search-engines";
487 // Disable synced notifications.
488 const char kDisableSyncSyncedNotifications[] =
489 "disable-sync-synced-notifications";
491 // Disables syncing browser sessions. Will override kEnableSyncTabs.
492 const char kDisableSyncTabs[] = "disable-sync-tabs";
494 // Disables syncing of themes.
495 const char kDisableSyncThemes[] = "disable-sync-themes";
497 // Disables syncing browser typed urls.
498 const char kDisableSyncTypedUrls[] = "disable-sync-typed-urls";
500 // Allows disabling of translate from the command line to assist with automated
501 // browser testing (e.g. Selenium/WebDriver). Normal browser users should
502 // disable translate with the preference.
503 const char kDisableTranslate[] = "disable-translate";
505 // Disables TLS Channel ID extension.
506 const char kDisableTLSChannelID[] = "disable-tls-channel-id";
508 // Disables some security measures when accessing user media devices like
509 // webcams and microphones, especially on non-HTTPS pages.
510 const char kDisableUserMediaSecurity[] = "disable-user-media-security";
512 // Do not expose WebGL extension WEBGL_debug_renderer_info to unprivileged code
513 // in the browser.
514 const char kDisableWebGLDebugRendererInfo[] =
515 "disable-webgl-debug-renderer-info";
517 // Disables the backend service for web resources.
518 const char kDisableWebResources[] = "disable-web-resources";
520 // Some tests seem to require the application to close when the last
521 // browser window is closed. Thus, we need a switch to force this behavior
522 // for ChromeOS Aura, disable "zero window mode".
523 // TODO(pkotwicz): Investigate if this bug can be removed.
524 // (http://crbug.com/119175)
525 const char kDisableZeroBrowsersOpenForTests[] =
526 "disable-zero-browsers-open-for-tests";
528 // Use a specific disk cache location, rather than one derived from the
529 // UserDatadir.
530 const char kDiskCacheDir[] = "disk-cache-dir";
532 // Forces the maximum disk space to be used by the disk cache, in bytes.
533 const char kDiskCacheSize[] = "disk-cache-size";
535 const char kDnsLogDetails[] = "dns-log-details";
537 // Disables prefetching of DNS information.
538 const char kDnsPrefetchDisable[] = "dns-prefetch-disable";
540 // Requests that a running browser process dump its collected histograms to a
541 // given file. The file is overwritten if it exists.
542 const char kDumpBrowserHistograms[] = "dump-browser-histograms";
544 // If set, Flash fullscreen widgets are embedded within the browser window and
545 // with the same UX as HTML5 fullscreen.
547 // TODO(miu): This feature is a work in-progress. It should not be enabled by
548 // default until going through a formal UX review, and all comments/concerns on
549 // the crbug are addressed. http://crbug.com/290403
550 const char kEmbedFlashFullscreen[] = "embed-flash-fullscreen";
552 // Enables the <adview> tag in packaged apps.
553 const char kEnableAdview[] = "enable-adview";
555 // If set, the app list will be enabled as if enabled from CWS.
556 const char kEnableAppList[] = "enable-app-list";
558 // Enables specifying a "src" attribute on <adview> elements
559 // (for testing purposes, to skip the whitelist).
560 const char kEnableAdviewSrcAttribute[] = "enable-adview-src-attribute";
562 // Enables the <window-controls> tag in platform apps.
563 const char kEnableAppWindowControls[] = "enable-app-window-controls";
565 // Show apps windows after the first paint. Windows will be shown significantly
566 // later for heavy apps loading resources synchronously but it will be
567 // insignificant for apps that load most of their resources asynchronously.
568 const char kEnableAppsShowOnFirstPaint[] = "enable-apps-show-on-first-paint";
570 // Enables the experimental asynchronous DNS client.
571 const char kEnableAsyncDns[] = "enable-async-dns";
573 // Enables the inclusion of non-standard ports when generating the Kerberos SPN
574 // in response to a Negotiate challenge. See
575 // HttpAuthHandlerNegotiate::CreateSPN for more background.
576 const char kEnableAuthNegotiatePort[] = "enable-auth-negotiate-port";
578 // Enables the i18n address input widget for the requestAutocomplete() dialog.
579 const char kEnableAutofillAddressI18n[] = "enable-autofill-address-i18n";
581 // Enable using a public suffix based domain matching for autofill of passwords.
582 const char kEnablePasswordAutofillPublicSuffixDomainMatching[] =
583 "enable-password-autofill-public-suffix-domain-matching";
585 // Enables the pre- and auto-login features. When a user signs in to sync, the
586 // browser's cookie jar is pre-filled with GAIA cookies. When the user visits a
587 // GAIA login page, an info bar can help the user login.
588 const char kEnableAutologin[] = "enable-autologin";
590 // Enables the benchmarking extensions.
591 const char kEnableBenchmarking[] = "enable-benchmarking";
593 // Enables client hints, which adds hints about browser state to HTTP requests.
594 const char kEnableClientHints[] = "enable-client-hints";
596 // Enables the multi-level undo system for bookmarks.
597 const char kEnableBookmarkUndo[] = "enable-bookmark-undo";
599 // This applies only when the process type is "service". Enables the Cloud
600 // Print Proxy component within the service process.
601 const char kEnableCloudPrintProxy[] = "enable-cloud-print-proxy";
603 // Enables fetching the user's contacts from Google and showing them in the
604 // Chrome OS apps list.
605 const char kEnableContacts[] = "enable-contacts";
607 // If true devtools experimental settings are enabled.
608 const char kEnableDevToolsExperiments[] = "enable-devtools-experiments";
610 // Enable device discovery notifications.
611 const char kEnableDeviceDiscoveryNotifications[] =
612 "enable-device-discovery-notifications";
614 // Enables the DOM distiller.
615 const char kEnableDomDistiller[] = "enable-dom-distiller";
617 // Enable Enhanced Bookmarks.
618 const char kEnableEnhancedBookmarks[] = "enable-enhanced-bookmarks";
620 // Enables experimentation with ephemeral apps, which are launched without
621 // installing in Chrome.
622 const char kEnableEphemeralApps[] = "enable-ephemeral-apps";
624 // Enables logging for extension activity.
625 const char kEnableExtensionActivityLogging[] =
626 "enable-extension-activity-logging";
628 const char kEnableExtensionActivityLogTesting[] =
629 "enable-extension-activity-log-testing";
631 // Enable the fast unload controller, which speeds up tab/window close by
632 // running a tab's onunload js handler independently of the GUI -
633 // crbug.com/142458 .
634 const char kEnableFastUnload[] = "enable-fast-unload";
636 // Enables Google Now integration.
637 const char kEnableGoogleNowIntegration[] = "enable-google-now-integration";
639 // Enable HTTP/2 draft 04. This is a temporary testing flag.
640 const char kEnableHttp2Draft04[] = "enable-http2-draft-04";
642 // Enables the pure web-based flow for sign in on first run/NTP/wrench menu/
643 // settings page.
644 const char kEnableWebBasedSignin[] = "enable-web-based-signin";
646 // Enables IPv6 support, even if probes suggest that it may not be fully
647 // supported. Some probes may require internet connections, and this flag will
648 // allow support independent of application testing. This flag overrides
649 // "disable-ipv6" which appears elswhere in this file.
650 const char kEnableIPv6[] = "enable-ipv6";
652 // Enables IP Pooling within the networks stack (SPDY only). When a connection
653 // is needed for a domain which shares an IP with an existing connection,
654 // attempt to use the existing connection.
655 const char kEnableIPPooling[] = "enable-ip-pooling";
657 // Enables experimentation with launching ephemeral apps via hyperlinks.
658 const char kEnableLinkableEphemeralApps[] = "enable-linkable-ephemeral-apps";
660 // Enable always using the local NTP for the first NTP load of a new window.
661 const char kEnableLocalFirstLoadNTP[] = "enable-local-first-load-ntp";
663 // Make the values returned to window.performance.memory more granular and more
664 // up to date. Without this flag, the memory information is still available, but
665 // it is bucketized and updated less frequently.
666 const char kEnableMemoryInfo[] = "enable-memory-info";
668 // Enables metrics recording and reporting in the browser startup sequence, as
669 // if this was an official Chrome build where the user allowed metrics
670 // reporting. This is used for testing only.
671 const char kEnableMetricsReportingForTesting[] =
672 "enable-metrics-reporting-for-testing";
674 // Runs the Native Client inside the renderer process and enables GPU plugin
675 // (internally adds lEnableGpuPlugin to the command line).
676 const char kEnableNaCl[] = "enable-nacl";
678 // Enables the network-related benchmarking extensions.
679 const char kEnableNetBenchmarking[] = "enable-net-benchmarking";
681 // Enables |NetworkTimeService| to convert local time to network time.
682 const char kEnableNetworkTime[] = "enable-network-time";
684 // Enables NPN with HTTP. It means NPN is enabled but SPDY won't be used.
685 // HTTP is still used for all requests.
686 const char kEnableNpnHttpOnly[] = "enable-npn-http";
688 // Enable auto-reload of error pages if offline.
689 const char kEnableOfflineAutoReload[] = "enable-offline-auto-reload";
691 // Enables omnibox auto-completion when IME is active. The auto-completion for
692 // IME is shown in the same style as the normal(non-IME) auto-completion.
693 const char kEnableOmniboxAutoCompletionForIme[] =
694 "enable-omnibox-auto-completion-for-ime";
696 // Controls which branch of the origin chip experiment is enabled. The first
697 // flag (enable-origin-chip) is equivalent to the third
698 // (enable-origin-chip-trailing-location-bar) and exists for backwards
699 // compatability with an earlier version of the experiment.
701 // We're using independent flags here (as opposed to a common flag with
702 // different values) to be able to enable/disable the entire experience
703 // associated with this feature server-side from the FieldTrial (the complete
704 // experience includes other flag changes as well). It is not currently possible
705 // to do that with "flag=value" flags.
706 const char kEnableOriginChip[] = "enable-origin-chip";
707 const char kEnableOriginChipLeadingLocationBar[] =
708 "enable-origin-chip-leading-location-bar";
709 const char kEnableOriginChipTrailingLocationBar[] =
710 "enable-origin-chip-trailing-location-bar";
711 const char kEnableOriginChipLeadingMenuButton[] =
712 "enable-origin-chip-leading-menu-button";
714 // Enables panels (always on-top docked pop-up windows).
715 const char kEnablePanels[] = "enable-panels";
717 // Enable Privet storage.
718 const char kEnablePrivetStorage[] = "enable-privet-storage";
720 // Enables tracking of tasks in profiler for viewing via about:profiler.
721 // To predominantly disable tracking (profiling), use the command line switch:
722 // --enable-profiling=0
723 // Some tracking will still take place at startup, but it will be turned off
724 // during chrome_browser_main.
725 const char kEnableProfiling[] = "enable-profiling";
727 // Enables query in the omnibox.
728 const char kEnableQueryExtraction[] = "enable-query-extraction";
730 // Enables support for the QUIC protocol. This is a temporary testing flag.
731 const char kEnableQuic[] = "enable-quic";
733 // Enables support for the HTTPS over QUIC protocol. This is a temporary
734 // testing flag. This only has an effect if QUIC protocol is enabled.
735 const char kEnableQuicHttps[] = "enable-quic-https";
737 // Enables the Quickoffoce/Chrome document viewer rather than the editor.
738 const char kEnableQuickofficeViewing[] = "enable-quickoffice-viewing";
740 // Enables save password prompt bubble.
741 const char kEnableSavePasswordBubble[] = "enable-save-password-bubble";
743 // Controls the support for SDCH filtering (dictionary based expansion of
744 // content). By default SDCH filtering is enabled. To disable SDCH filtering,
745 // use "--enable-sdch=0" as command line argument. SDCH is currently only
746 // supported server-side for searches on google.com.
747 const char kEnableSdch[] = "enable-sdch";
749 // Controls which branch of the "search button in omnibox" experiment is
750 // enabled.
752 // We're using independent flags here (as opposed to a common flag with
753 // different values) to be able to enable/disable the entire experience
754 // associated with this feature server-side from the FieldTrial (the complete
755 // experience includes other flag changes as well). It is not currently possible
756 // to do that with "flag=value" flags.
757 const char kEnableSearchButtonInOmniboxAlways[] =
758 "enable-search-button-in-omnibox-always";
759 const char kEnableSearchButtonInOmniboxForStr[] =
760 "enable-search-button-in-omnibox-for-str";
761 const char kEnableSearchButtonInOmniboxForStrOrIip[] =
762 "enable-search-button-in-omnibox-for-str-or-iip";
764 // Enables support of sticky keys.
765 const char kEnableStickyKeys[] = "enable-sticky-keys";
767 // Enable SPDY/2. This is a temporary testing flag. See
768 // http://crbug.com/303957 .
769 const char kEnableSpdy2[] = "enable-spdy2";
771 // Enable SPDY/4 alpha 2. This is a temporary testing flag.
772 const char kEnableSpdy4a2[] = "enable-spdy4a2";
774 // Enables auto correction for misspelled words.
775 const char kEnableSpellingAutoCorrect[] = "enable-spelling-auto-correct";
777 // Enables participation in the field trial for user feedback to spelling
778 // service.
779 const char kEnableSpellingFeedbackFieldTrial[] =
780 "enable-spelling-feedback-field-trial";
782 // Enables the stacked tabstrip.
783 const char kEnableStackedTabStrip[] = "enable-stacked-tab-strip";
785 // Enables an experimental hosted app experience.
786 const char kEnableStreamlinedHostedApps[] = "enable-streamlined-hosted-apps";
788 // Enables experimental suggestions pane in New Tab page.
789 const char kEnableSuggestionsTabPage[] = "enable-suggestions-ntp";
791 // Enables synced notifications.
792 const char kEnableSyncSyncedNotifications[] =
793 "enable-sync-synced-notifications";
795 // Enables sync/API based session sync implementation (in favor of legacy).
796 const char kEnableSyncSessionsV2[] = "enable-sync-sessions-v2";
798 // Enables syncing of the app list.
799 const char kEnableSyncAppList[] = "enable-sync-app-list";
801 // Enables synced articles.
802 const char kEnableSyncArticles[] = "enable-sync-articles";
804 // Enables context menu for selecting groups of tabs.
805 const char kEnableTabGroupsContextMenu[] = "enable-tab-groups-context-menu";
807 // Enables fanciful thumbnail processing. Used with NTP for
808 // instant-extended-api, where thumbnails are generally smaller.
809 const char kEnableThumbnailRetargeting[] = "enable-thumbnail-retargeting";
811 // Enables Translate experimental new UX which replaces the infobar.
812 const char kEnableTranslateNewUX[] = "enable-translate-new-ux";
814 // Enables unrestricted SSL 3.0 fallback.
815 // With this switch, SSL 3.0 fallback will be enabled for all sites.
816 // Without this switch, SSL 3.0 fallback will be disabled for a site
817 // pinned to the Google pin list (indicating that it is a Google site).
818 const char kEnableUnrestrictedSSL3Fallback[] =
819 "enable-unrestricted-ssl3-fallback";
821 // Enables Alternate-Protocol when the port is user controlled (> 1024).
822 const char kEnableUserAlternateProtocolPorts[] =
823 "enable-user-controlled-alternate-protocol-ports";
825 // Spawns threads to watch for excessive delays in specified message loops.
826 // User should set breakpoints on Alarm() to examine problematic thread.
828 // Usage: -enable-watchdog=[ui][io]
830 // Order of the listed sub-arguments does not matter.
831 const char kEnableWatchdog[] = "enable-watchdog";
833 // Uses WebSocket over SPDY.
834 const char kEnableWebSocketOverSpdy[] = "enable-websocket-over-spdy";
836 // Explicitly allows additional ports using a comma-separated list of port
837 // numbers.
838 const char kExplicitlyAllowedPorts[] = "explicitly-allowed-ports";
840 // Turns on extension install verification if it would not otherwise have been
841 // turned on.
842 const char kExtensionsInstallVerification[] = "extensions-install-verification";
844 // Specifies a comma-separated list of extension ids that should be forced to
845 // be treated as not from the webstore when doing install verification.
846 const char kExtensionsNotWebstore[] = "extensions-not-webstore";
848 // Frequency in seconds for Extensions auto-update.
849 const char kExtensionsUpdateFrequency[] = "extensions-update-frequency";
851 // Additional query params to insert in the search and instant URLs. Useful for
852 // testing.
853 const char kExtraSearchQueryParams[] = "extra-search-query-params";
855 // Fakes the channel of the browser for purposes of Variations filtering. This
856 // is to be used for testing only. Possible values are "stable", "beta", "dev"
857 // and "canary". Note that this only applies if the browser's reported channel
858 // is UNKNOWN.
859 const char kFakeVariationsChannel[] = "fake-variations-channel";
861 // If this flag is present then this command line is being delegated to an
862 // already running chrome process via the fast path, ie: before chrome.dll is
863 // loaded. It is useful to tell the difference for tracking purposes.
864 const char kFastStart[] = "fast-start";
866 // These two flags are added around the switches about:flags adds to the
867 // command line. This is useful to see which switches were added by about:flags
868 // on about:version. They don't have any effect.
869 const char kFlagSwitchesBegin[] = "flag-switches-begin";
870 const char kFlagSwitchesEnd[] = "flag-switches-end";
872 // Alternative feedback server to use when submitting user feedback
873 const char kFeedbackServer[] = "feedback-server";
875 // The file descriptor limit is set to the value of this switch, subject to the
876 // OS hard limits. Useful for testing that file descriptor exhaustion is
877 // handled gracefully.
878 const char kFileDescriptorLimit[] = "file-descriptor-limit";
880 // Forces application mode. This hides certain system UI elements and forces
881 // the app to be installed if it hasn't been already.
882 const char kForceAppMode[] = "force-app-mode";
884 // Displays the First Run experience when the browser is started, regardless of
885 // whether or not it's actually the First Run (this overrides kNoFirstRun and
886 // kCancelFirstRun).
887 const char kForceFirstRun[] = "force-first-run";
889 // Forces additional Chrome Variation Ids that will be sent in
890 // X-Client-Data header, specified as a 64-bit encoded list of numeric
891 // experiment ids.
892 const char kForceVariationIds[] = "force-variation-ids";
894 // Tries to load cloud policy for every signed in user, regardless of whether
895 // they are a dasher user or not. Used to allow any GAIA account to be used for
896 // testing the cloud policy framework.
897 const char kForceLoadCloudPolicy[] = "force-load-cloud-policy";
899 // Specifies an alternate URL to use for speaking to Google. Useful for testing.
900 const char kGoogleBaseURL[] = "google-base-url";
902 // Enables using GAIA information to populate profile name and icon.
903 const char kGoogleProfileInfo[] = "google-profile-info";
905 // Specifies an alternate URL to use for retrieving the search domain for
906 // Google. Useful for testing.
907 const char kGoogleSearchDomainCheckURL[] = "google-search-domain-check-url";
909 // Specifies a custom name for the GSSAPI library to load.
910 const char kGSSAPILibraryName[] = "gssapi-library-name";
912 // These flags show the man page on Linux. They are equivalent to each
913 // other.
914 const char kHelp[] = "help";
915 const char kHelpShort[] = "h";
917 // Makes Windows happy by allowing it to show "Enable access to this program"
918 // checkbox in Add/Remove Programs->Set Program Access and Defaults. This only
919 // shows an error box because the only way to hide Chrome is by uninstalling
920 // it.
921 const char kHideIcons[] = "hide-icons";
923 // Disables full history sync.
924 const char kHistoryDisableFullHistorySync[] = "disable-full-history-sync";
926 // Enables grouping websites by domain and filtering them by period.
927 const char kHistoryEnableGroupByDomain[] = "enable-grouped-history";
929 // Specifies which page will be displayed in newly-opened tabs. We need this
930 // for testing purposes so that the UI tests don't depend on what comes up for
931 // http://google.com.
932 const char kHomePage[] = "homepage";
934 // Comma-separated list of rules that control how hostnames are mapped.
936 // For example:
937 // "MAP * 127.0.0.1" --> Forces all hostnames to be mapped to 127.0.0.1
938 // "MAP *.google.com proxy" --> Forces all google.com subdomains to be
939 // resolved to "proxy".
940 // "MAP test.com [::1]:77 --> Forces "test.com" to resolve to IPv6 loopback.
941 // Will also force the port of the resulting
942 // socket address to be 77.
943 // "MAP * baz, EXCLUDE www.google.com" --> Remaps everything to "baz",
944 // except for "www.google.com".
946 // These mappings apply to the endpoint host in a net::URLRequest (the TCP
947 // connect and host resolver in a direct connection, and the CONNECT in an http
948 // proxy connection, and the endpoint host in a SOCKS proxy connection).
949 const char kHostRules[] = "host-rules";
951 // The maximum number of concurrent host resolve requests (i.e. DNS) to allow
952 // (not counting backup attempts which would also consume threads).
953 // --host-resolver-retry-attempts must be set to zero for this to be exact.
954 const char kHostResolverParallelism[] = "host-resolver-parallelism";
956 // The maximum number of retry attempts to resolve the host. Set this to zero
957 // to disable host resolver retry attempts.
958 const char kHostResolverRetryAttempts[] = "host-resolver-retry-attempts";
960 // Causes net::URLFetchers to ignore requests for SSL client certificates,
961 // causing them to attempt an unauthenticated SSL/TLS session. This is intended
962 // for use when testing various service URLs (eg: kPromoServerURL, kSbURLPrefix,
963 // kSyncServiceURL, etc)
964 const char kIgnoreUrlFetcherCertRequests[] =
965 "ignore-urlfetcher-cert-requests";
967 // Causes the browser to launch directly in incognito mode.
968 const char kIncognito[] = "incognito";
970 // Causes Chrome to attempt to get metadata from the webstore for the
971 // app/extension ID given, and then prompt the user to download and install it.
972 const char kInstallFromWebstore[] = "install-from-webstore";
974 // Marks a renderer as an Instant process.
975 const char kInstantProcess[] = "instant-process";
977 // Specifies the testcase used by the IPC fuzzer.
978 const char kIpcFuzzerTestcase[] = "ipc-fuzzer-testcase";
980 // Used for testing - keeps browser alive after last browser window closes.
981 const char kKeepAliveForTest[] = "keep-alive-for-test";
983 // Enable Kiosk mode.
984 const char kKioskMode[] = "kiosk";
986 // Print automatically in kiosk mode. |kKioskMode| must be set as well.
987 // See http://crbug.com/31395.
988 const char kKioskModePrinting[] = "kiosk-printing";
990 // Causes Chrome to attempt to get metadata from the webstore for the
991 // given item, and then prompt the user to download and install it.
992 const char kLimitedInstallFromWebstore[] = "limited-install-from-webstore";
994 // Comma-separated list of directories with component extensions to load.
995 const char kLoadComponentExtension[] = "load-component-extension";
997 // Loads an extension from the specified directory.
998 const char kLoadExtension[] = "load-extension";
1000 // Makes Chrome default browser
1001 const char kMakeDefaultBrowser[] = "make-default-browser";
1003 // Sets the managed user ID for any loaded or newly created profile to the
1004 // given value. Pass an empty string to mark the profile as non-supervised.
1005 // Used for testing.
1006 const char kManagedUserId[] = "managed-user-id";
1008 // Used to authenticate requests to the Sync service for managed users. Setting
1009 // this switch also causes Sync to be set up for a managed user.
1010 const char kManagedUserSyncToken[] = "managed-user-sync-token";
1012 // Use to opt-in user into Finch experiment group.
1013 const char kManualEnhancedBookmarks[] = "manual-enhanced-bookmarks";
1015 // Forces the maximum disk space to be used by the media cache, in bytes.
1016 const char kMediaCacheSize[] = "media-cache-size";
1018 // Enables dynamic loading of the Memory Profiler DLL, which will trace all
1019 // memory allocations during the run.
1020 const char kMemoryProfiling[] = "memory-profile";
1022 // Enables histograming of tasks served by MessageLoop. See
1023 // about:histograms/Loop for results, which show frequency of messages on each
1024 // thread, including APC count, object signalling count, etc.
1025 const char kMessageLoopHistogrammer[] = "message-loop-histogrammer";
1027 // Enables the recording of metrics reports but disables reporting. In contrast
1028 // to kDisableMetrics, this executes all the code that a normal client would
1029 // use for reporting, except the report is dropped rather than sent to the
1030 // server. This is useful for finding issues in the metrics code during UI and
1031 // performance tests.
1032 const char kMetricsRecordingOnly[] = "metrics-recording-only";
1034 // Enables multiprofile Chrome.
1035 const char kMultiProfiles[] = "multi-profiles";
1037 // List of native messaging hosts outside of the default location. Used for
1038 // tests. The value must be comma-separate lists of key-value pairs separated
1039 // equal sign. E.g. "host1=/path/to/host1/manifest.json,host2=/path/host2.json".
1040 const char kNativeMessagingHosts[] = "native-messaging-hosts";
1042 // Sets the base logging level for the net log. Log 0 logs the most data.
1043 // Intended primarily for use with --log-net-log.
1044 const char kNetLogLevel[] = "net-log-level";
1046 // Use new profile management system, including profile sign-out and new
1047 // choosers.
1048 const char kNewProfileManagement[] = "new-profile-management";
1050 // Disables the default browser check. Useful for UI/browser tests where we
1051 // want to avoid having the default browser info-bar displayed.
1052 const char kNoDefaultBrowserCheck[] = "no-default-browser-check";
1054 // By default, an https page can load images, fonts or frames from an http
1055 // page. This switch overrides this to block this lesser mixed-content problem.
1056 const char kNoDisplayingInsecureContent[] = "no-displaying-insecure-content";
1058 // Don't record/playback events when using record & playback.
1059 const char kNoEvents[] = "no-events";
1061 // Disables all experiments set on about:flags. Does not disable about:flags
1062 // itself. Useful if an experiment makes chrome crash at startup: One can start
1063 // chrome with --no-experiments, disable the problematic lab at about:flags and
1064 // then restart chrome without this switch again.
1065 const char kNoExperiments[] = "no-experiments";
1067 // Skip First Run tasks, whether or not it's actually the First Run. Overridden
1068 // by kForceFirstRun. This does not drop the First Run sentinel and thus doesn't
1069 // prevent first run from occuring the next time chrome is launched without this
1070 // flag (see kCancelFirstRun for that).
1071 const char kNoFirstRun[] = "no-first-run";
1073 // Support a separate switch that enables the v8 playback extension.
1074 // The extension causes javascript calls to Date.now() and Math.random()
1075 // to return consistent values, such that subsequent loads of the same
1076 // page will result in consistent js-generated data and XHR requests.
1077 // Pages may still be able to generate inconsistent data from plugins.
1078 const char kNoJsRandomness[] = "no-js-randomness";
1080 // Whether or not the browser should warn if the profile is on a network share.
1081 // This flag is only relevant for Windows currently.
1082 const char kNoNetworkProfileWarning[] = "no-network-profile-warning";
1084 // Don't send hyperlink auditing pings
1085 const char kNoPings[] = "no-pings";
1087 // Don't use a proxy server, always make direct connections. Overrides any
1088 // other proxy server flags that are passed.
1089 const char kNoProxyServer[] = "no-proxy-server";
1091 // Disables the service process from adding itself as an autorun process. This
1092 // does not delete existing autorun registrations, it just prevents the service
1093 // from registering a new one.
1094 const char kNoServiceAutorun[] = "no-service-autorun";
1096 // Does not automatically open a browser window on startup (used when
1097 // launching Chrome for the purpose of hosting background apps).
1098 const char kNoStartupWindow[] = "no-startup-window";
1100 // Disables checking whether we received an acknowledgment when registering
1101 // a supervised user. Also disables the timeout during registration that waits
1102 // for the ack. Useful when debugging against a server that does not
1103 // support notifications.
1104 const char kNoManagedUserAcknowledgmentCheck[] =
1105 "no-managed-user-acknowledgment-check";
1107 // Specifies the maximum number of threads to use for running the Proxy
1108 // Autoconfig (PAC) script.
1109 const char kNumPacThreads[] = "num-pac-threads";
1111 // When the option to block third-party cookies is enabled, only block
1112 // third-party cookies from being set.
1113 const char kOnlyBlockSettingThirdPartyCookies[] =
1114 "only-block-setting-third-party-cookies";
1116 // Launches URL in new browser window.
1117 const char kOpenInNewWindow[] = "new-window";
1119 // Simulates an organic Chrome install.
1120 const char kOrganicInstall[] = "organic";
1122 // Force use of QUIC for requests to the specified origin.
1123 const char kOriginToForceQuicOn[] = "origin-to-force-quic-on";
1125 // The time that a new chrome process which is delegating to an already running
1126 // chrome process started. (See ProcessSingleton for more details.)
1127 const char kOriginalProcessStartTime[] = "original-process-start-time";
1129 // Enable the out of process PDF plugin.
1130 const char kOutOfProcessPdf[] = "out-of-process-pdf";
1132 // Packages an extension to a .crx installable file from a given directory.
1133 const char kPackExtension[] = "pack-extension";
1135 // Optional PEM private key to use in signing packaged .crx.
1136 const char kPackExtensionKey[] = "pack-extension-key";
1138 // Specifies the path to the user data folder for the parent profile.
1139 const char kParentProfile[] = "parent-profile";
1141 // Launches PerformanceMonitor at startup, which will gather statistics about
1142 // Chrome's CPU and memory usage, page load times, startup times, and network
1143 // usage, and will also store information about events which may be of interest,
1144 // such as extension-related occurrences and crashes. Optionally, this may be
1145 // run with an integer value representing the interval between the timed
1146 // metric gatherings, measured in seconds (if invalid or not provided, the
1147 // default interval is used).
1148 const char kPerformanceMonitorGathering[] = "performance-monitor-gathering";
1150 // Read previously recorded data from the cache. Only cached data is read.
1151 // See kRecordMode.
1152 const char kPlaybackMode[] = "playback-mode";
1154 // Overrides the path to the location that PNaCl is installed.
1155 const char kPnaclDir[] = "pnacl-dir";
1157 // Forces the PPAPI version of Flash (if it's being used) to run in the
1158 // renderer process rather than in a separate plugin process.
1159 const char kPpapiFlashInProcess[] = "ppapi-flash-in-process";
1161 // Use the PPAPI (Pepper) Flash found at the given path.
1162 const char kPpapiFlashPath[] = "ppapi-flash-path";
1164 // Report the given version for the PPAPI (Pepper) Flash. The version should be
1165 // numbers separated by '.'s (e.g., "12.3.456.78"). If not specified, it
1166 // defaults to "10.2.999.999".
1167 const char kPpapiFlashVersion[] = "ppapi-flash-version";
1169 // Triggers prerendering of pages from suggestions in the omnibox. Only has an
1170 // effect when Instant is either disabled or restricted to search, and when
1171 // prerender is enabled.
1172 const char kPrerenderFromOmnibox[] = "prerender-from-omnibox";
1173 // These are the values the kPrerenderFromOmnibox switch may have, as in
1174 // "--prerender-from-omnibox=auto". auto: Allow field trial selection.
1175 const char kPrerenderFromOmniboxSwitchValueAuto[] = "auto";
1176 // disabled: No prerendering.
1177 const char kPrerenderFromOmniboxSwitchValueDisabled[] = "disabled";
1178 // enabled: Guaranteed prerendering.
1179 const char kPrerenderFromOmniboxSwitchValueEnabled[] = "enabled";
1180 // Controls speculative prerendering of pages, and content prefetching. Both
1181 // are dispatched from <link rel=prefetch href=...> elements.
1182 const char kPrerenderMode[] = "prerender";
1183 // These are the values the kPrerenderMode switch may have, as in
1184 // "--prerender=auto".
1185 // auto: Allow field trial selection for prerender.
1186 const char kPrerenderModeSwitchValueAuto[] = "auto";
1187 // disabled: No prerendering.
1188 const char kPrerenderModeSwitchValueDisabled[] = "disabled";
1189 // enabled: Prerendering.
1190 const char kPrerenderModeSwitchValueEnabled[] = "enabled";
1192 #if defined(OS_WIN)
1193 // Enable conversion from vector to raster for any page.
1194 const char kPrintRaster[] = "print-raster";
1195 #endif
1197 // Use IPv6 only for privet HTTP.
1198 const char kPrivetIPv6Only[] = "privet-ipv6-only";
1200 // Outputs the product version information and quit. Used as an internal api to
1201 // detect the installed version of Chrome on Linux.
1202 const char kProductVersion[] = "product-version";
1204 // Selects directory of profile to associate with the first browser launched.
1205 const char kProfileDirectory[] = "profile-directory";
1207 // Starts the sampling based profiler for the browser process at startup. This
1208 // will only work if chrome has been built with the gyp variable profiling=1.
1209 // The output will go to the value of kProfilingFile.
1210 const char kProfilingAtStart[] = "profiling-at-start";
1212 // Specifies a location for profiling output. This will only work if chrome has
1213 // been built with the gyp variable profiling=1.
1215 // {pid} if present will be replaced by the pid of the process.
1216 // {count} if present will be incremented each time a profile is generated
1217 // for this process.
1218 // The default is chrome-profile-{pid}.
1219 const char kProfilingFile[] = "profiling-file";
1221 // Specifies a path for the output of task-level profiling which can be loaded
1222 // and viewed in about:profiler.
1223 const char kProfilingOutputFile[] = "profiling-output-file";
1225 // Controls whether profile data is periodically flushed to a file. Normally
1226 // the data gets written on exit but cases exist where chrome doesn't exit
1227 // cleanly (especially when using single-process). A time in seconds can be
1228 // specified.
1229 const char kProfilingFlush[] = "profiling-flush";
1231 // Specifies a custom URL for fetching NTP promo data.
1232 const char kPromoServerURL[] = "promo-server-url";
1234 // Forces proxy auto-detection.
1235 const char kProxyAutoDetect[] = "proxy-auto-detect";
1237 // Specifies a list of hosts for whom we bypass proxy settings and use direct
1238 // connections. Ignored if --proxy-auto-detect or --no-proxy-server are also
1239 // specified. This is a comma-separated list of bypass rules. See:
1240 // "net/proxy/proxy_bypass_rules.h" for the format of these rules.
1241 const char kProxyBypassList[] = "proxy-bypass-list";
1243 // Uses the pac script at the given URL
1244 const char kProxyPacUrl[] = "proxy-pac-url";
1246 // Uses a specified proxy server, overrides system settings. This switch only
1247 // affects HTTP and HTTPS requests.
1248 const char kProxyServer[] = "proxy-server";
1250 // Adds a "Purge memory" button to the Task Manager, which tries to dump as
1251 // much memory as possible. This is mostly useful for testing how well the
1252 // MemoryPurger functionality works.
1254 // NOTE: This is only implemented for Views.
1255 const char kPurgeMemoryButton[] = "purge-memory-button";
1257 // Specifies the maximum length for a QUIC packet.
1258 const char kQuicMaxPacketLength[] = "quic-max-packet-length";
1260 // Specifies the version of QUIC to use.
1261 const char kQuicVersion[] = "quic-version";
1263 // Chrome supports a playback and record mode. Record mode saves *everything*
1264 // to the cache. Playback mode reads data exclusively from the cache. This
1265 // allows us to record a session into the cache and then replay it at will.
1266 // See also kPlaybackMode.
1267 const char kRecordMode[] = "record-mode";
1269 // Uses custom front-end URL for the remote debugging.
1270 const char kRemoteDebuggingFrontend[] = "remote-debugging-frontend";
1272 // Enables print preview in the renderer. This flag is generated internally by
1273 // Chrome and does nothing when directly passed to the browser.
1274 const char kRendererPrintPreview[] = "renderer-print-preview";
1276 // If set, the app list will forget it has been installed on startup. Note this
1277 // doesn't prevent the app list from running, it just makes Chrome think the app
1278 // list hasn't been enabled (as in kEnableAppList) yet.
1279 const char kResetAppListInstallState[] = "reset-app-list-install-state";
1281 // Forces a reset of the one-time-randomized FieldTrials on this client, also
1282 // known as the Chrome Variations state.
1283 const char kResetVariationState[] = "reset-variation-state";
1285 // Indicates the last session should be restored on startup. This overrides the
1286 // preferences value and is primarily intended for testing. The value of this
1287 // switch is the number of tabs to wait until loaded before 'load completed' is
1288 // sent to the ui_test.
1289 const char kRestoreLastSession[] = "restore-last-session";
1291 // Disable saving pages as HTML-only, disable saving pages as HTML Complete
1292 // (with a directory of sub-resources). Enable only saving pages as MHTML.
1293 // See http://crbug.com/120416 for how to remove this switch.
1294 const char kSavePageAsMHTML[] = "save-page-as-mhtml";
1296 // URL prefix used by safebrowsing to fetch hash, download data and report
1297 // malware.
1298 const char kSbURLPrefix[] = "safebrowsing-url-prefix";
1300 // If present, safebrowsing only performs update when
1301 // SafeBrowsingProtocolManager::ForceScheduleNextUpdate() is explicitly called.
1302 // This is used for testing only.
1303 const char kSbDisableAutoUpdate[] = "safebrowsing-disable-auto-update";
1305 // TODO(lzheng): Remove this flag once the feature works fine
1306 // (http://crbug.com/74848).
1308 // Disables safebrowsing feature that checks download url and downloads
1309 // content's hash to make sure the content are not malicious.
1310 const char kSbDisableDownloadProtection[] =
1311 "safebrowsing-disable-download-protection";
1313 // Disables safebrowsing feature that checks for blacklisted extensions.
1314 const char kSbDisableExtensionBlacklist[] =
1315 "safebrowsing-disable-extension-blacklist";
1317 // Disables safebrowsing feature that provides a side-effect free whitelist.
1318 const char kSbDisableSideEffectFreeWhitelist[] =
1319 "safebrowsing-disable-side-effect-free-whitelist";
1321 // URL to send safebrowsing download feedback reports to.
1322 const char kSbDownloadFeedbackURL[] = "safebrowsing-download-feedback-url";
1324 // Causes the process to run as a service process.
1325 const char kServiceProcess[] = "service";
1327 // Sets a token in the token service, for testing.
1328 const char kSetToken[] = "set-token";
1330 // If true the app list will be shown.
1331 const char kShowAppList[] = "show-app-list";
1333 // If true the app list will show the start page webui.
1334 const char kShowAppListStartPage[] = "show-app-list-start-page";
1336 // See kHideIcons.
1337 const char kShowIcons[] = "show-icons";
1339 // Marks a renderer as the signin process.
1340 const char kSigninProcess[] = "signin-process";
1342 // Does not show an infobar when an extension attaches to a page using
1343 // chrome.debugger page. Required to attach to extension background pages.
1344 const char kSilentDebuggerExtensionAPI[] = "silent-debugger-extension-api";
1346 // Changes the DCHECKS to dump memory and continue instead of displaying error
1347 // dialog. This is valid only in Release mode when --enable-dcheck is
1348 // specified.
1349 const char kSilentDumpOnDCHECK[] = "silent-dump-on-dcheck";
1351 // Causes Chrome to launch without opening any windows by default. Useful if
1352 // one wishes to use Chrome as an ash server.
1353 const char kSilentLaunch[] = "silent-launch";
1355 // Simulates an update being available.
1356 const char kSimulateUpgrade[] = "simulate-upgrade";
1358 // Simulates a critical update being available.
1359 const char kSimulateCriticalUpdate[] = "simulate-critical-update";
1361 // Simulates that current version is outdated.
1362 const char kSimulateOutdated[] = "simulate-outdated";
1364 // Replaces the buffered data source for <audio> and <video> with a simplified
1365 // resource loader that downloads the entire resource into memory.
1367 // Second origin that can be used for the spdy proxy.
1368 const char kSpdyProxyAuthFallback[] = "spdy-proxy-auth-fallback";
1370 // Origin for which SpdyProxy authentication is supported.
1371 const char kSpdyProxyAuthOrigin[] = "spdy-proxy-auth-origin";
1373 // Authentication string for the data reduction proxy.
1374 const char kSpdyProxyAuthValue[] = "spdy-proxy-auth-value";
1376 // Origin for which dev version of SpdyProxy authentication is supported.
1377 const char kSpdyProxyDevAuthOrigin[] = "spdy-proxy-dev-auth-origin";
1379 // Specifies the URL where spelling service feedback data will be sent instead
1380 // of the default URL. This switch is for temporary testing only.
1381 // TODO(rouslan): Remove this flag when feedback testing is complete. Revisit by
1382 // August 2013.
1383 const char kSpellingServiceFeedbackUrl[] = "spelling-service-feedback-url";
1385 // Specifies the number of seconds between sending batches of feedback to
1386 // spelling service. The default is 30 minutes. The mininum is 5 seconds. This
1387 // switch is for temporary testing only.
1388 // TODO(rouslan): Remove this flag when feedback testing is complete. Revisit by
1389 // August 2013.
1390 const char kSpellingServiceFeedbackIntervalSeconds[] =
1391 "spelling-service-feedback-interval-seconds";
1393 // Specifies the maximum SSL/TLS version ("ssl3", "tls1", "tls1.1", or
1394 // "tls1.2").
1395 const char kSSLVersionMax[] = "ssl-version-max";
1397 // Specifies the minimum SSL/TLS version ("ssl3", "tls1", "tls1.1", or
1398 // "tls1.2").
1399 const char kSSLVersionMin[] = "ssl-version-min";
1401 // Starts the browser maximized, regardless of any previous settings.
1402 const char kStartMaximized[] = "start-maximized";
1404 // Controls the width of time-of-day filters on the 'suggested' ntp page, in
1405 // minutes.
1406 const char kSuggestionNtpFilterWidth[] = "suggestion-ntp-filter-width";
1408 // Enables a normal distribution dropoff to the relevancy of visits with respect
1409 // to the time of day.
1410 const char kSuggestionNtpGaussianFilter[] = "suggestion-ntp-gaussian-filter";
1412 // Enables a linear dropoff to the relevancy of visits with respect to the time
1413 // of day.
1414 const char kSuggestionNtpLinearFilter[] = "suggestion-ntp-linear-filter";
1416 // Allows insecure XMPP connections for sync (for testing).
1417 const char kSyncAllowInsecureXmppConnection[] =
1418 "sync-allow-insecure-xmpp-connection";
1420 // Invalidates any login info passed into sync's XMPP connection.
1421 const char kSyncInvalidateXmppLogin[] = "sync-invalidate-xmpp-login";
1423 // This flag causes sync to retry very quickly (see polling_constants.h) the
1424 // when it encounters an error, as the first step towards exponential backoff.
1425 const char kSyncShortInitialRetryOverride[] =
1426 "sync-short-initial-retry-override";
1428 // Overrides the default host:port used for sync notifications.
1429 const char kSyncNotificationHostPort[] = "sync-notification-host-port";
1431 // Overrides the default server used for profile sync.
1432 const char kSyncServiceURL[] = "sync-url";
1434 // Makes the sync code to throw an unrecoverable error after initialization.
1435 // Useful for testing unrecoverable error scenarios.
1436 const char kSyncThrowUnrecoverableError[] = "sync-throw-unrecoverable-error";
1439 // Tries to connect to XMPP using SSLTCP first (for testing).
1440 const char kSyncTrySsltcpFirstForXmpp[] = "sync-try-ssltcp-first-for-xmpp";
1442 // Enables deferring sync backend initialization until user initiated changes
1443 // occur.
1444 const char kSyncEnableDeferredStartup[] = "sync-enable-deferred-startup";
1446 // Enables feature to avoid unnecessary GetUpdate requests.
1447 const char kSyncEnableGetUpdateAvoidance[] =
1448 "sync-enable-get-update-avoidance";
1450 // Enables directory support for sync filesystem
1451 const char kSyncfsEnableDirectoryOperation[] =
1452 "enable-syncfs-directory-operation";
1454 // Passes the name of the current running automated test to Chrome.
1455 const char kTestName[] = "test-name";
1457 // Type of the current test harness ("browser" or "ui").
1458 const char kTestType[] = "test-type";
1460 // Tells the app to listen for and broadcast testing-related messages on IPC
1461 // channel with the given ID.
1462 const char kTestingChannelID[] = "testing-channel";
1464 // Overrides the default server used for Google Translate.
1465 const char kTranslateScriptURL[] = "translate-script-url";
1467 // Disables same-origin check on HTTP resources pushed via a SPDY proxy.
1468 // The value is the host:port of the trusted proxy.
1469 const char kTrustedSpdyProxy[] = "trusted-spdy-proxy";
1471 // Experimental. Shows a dialog asking the user to try chrome. This flag is to
1472 // be used only by the upgrade process.
1473 const char kTryChromeAgain[] = "try-chrome-again";
1475 // Uninstalls an extension with the specified extension id.
1476 const char kUninstallExtension[] = "uninstall-extension";
1478 // Runs un-installation steps that were done by chrome first-run.
1479 const char kUninstall[] = "uninstall";
1481 // Overrides per-origin quota settings to unlimited storage for any
1482 // apps/origins. This should be used only for testing purpose.
1483 const char kUnlimitedStorage[] = "unlimited-storage";
1485 // Uses Spdy for the transport protocol instead of HTTP. This is a temporary
1486 // testing flag.
1487 const char kUseSpdy[] = "use-spdy";
1489 // Disables use of the spelling web service and only provides suggestions.
1490 // This will only work if asynchronous spell checking is not disabled.
1491 const char kUseSpellingSuggestions[] = "use-spelling-suggestions";
1493 // Sets the maximum concurrent streams over a SPDY session.
1494 const char kMaxSpdyConcurrentStreams[] = "max-spdy-concurrent-streams";
1496 // Specifies the user data directory, which is where the browser will look for
1497 // all of its state.
1498 const char kUserDataDir[] = "user-data-dir";
1500 // Examines a .crx for validity and prints the result.
1501 const char kValidateCrx[] = "validate-crx";
1503 // Uses experimental simple cache backend if possible.
1504 const char kUseSimpleCacheBackend[] = "use-simple-cache-backend";
1506 // Specifies a custom URL for the server which reports variation data to the
1507 // client. Specifying this switch enables the Variations service on
1508 // unofficial builds. See variations_service.cc.
1509 const char kVariationsServerURL[] = "variations-server-url";
1511 // Prints version information and quits.
1512 const char kVersion[] = "version";
1514 // Adds the given extension ID to all the permission whitelists.
1515 const char kWhitelistedExtensionID[] = "whitelisted-extension-id";
1517 // Specify the initial window position: --window-position=x,y
1518 const char kWindowPosition[] = "window-position";
1520 // Specify the initial window size: --window-size=w,h
1521 const char kWindowSize[] = "window-size";
1523 // Uses WinHTTP to fetch and evaluate PAC scripts. Otherwise the default is to
1524 // use Chromium's network stack to fetch, and V8 to evaluate.
1525 const char kWinHttpProxyResolver[] = "winhttp-proxy-resolver";
1527 #if defined(ENABLE_PLUGIN_INSTALLATION)
1528 // Specifies a custom URL for fetching plug-ins metadata. Used for testing.
1529 const char kPluginsMetadataServerURL[] = "plugins-metadata-server-url";
1530 #endif
1532 #if defined(OS_ANDROID) || defined(OS_IOS)
1533 // Enable SPDY proxy.
1534 const char kEnableSpdyProxyAuth[] = "enable-spdy-proxy-auth";
1535 #endif // defined(OS_ANDROID) || defined(OS_IOS)
1537 #if defined(OS_ANDROID)
1538 // Makes the "Add to Homescreen" shortcut invisible.
1539 const char kDisableAddToHomescreen[] = "disable-add-to-homescreen";
1541 // Disables the new NTP.
1542 const char kDisableNewNTP[] = "disable-new-ntp";
1544 // Disables zero suggest experiment on Dev channel.
1545 const char kDisableZeroSuggest[] = "disable-zero-suggest";
1547 // Enable the accessibility tab switcher.
1548 const char kEnableAccessibilityTabSwitcher[] =
1549 "enable-accessibility-tab-switcher";
1551 // Makes the "Add to Homescreen" shortcut visible.
1552 const char kEnableAddToHomescreen[] = "enable-add-to-homescreen";
1554 // Enables the new NTP.
1555 const char kEnableNewNTP[] = "enable-new-ntp";
1557 // Pops the translate infobar if possible.
1558 const char kEnableTranslate[] = "enable-translate";
1560 // Enables support for playing videos on Chromecast devices.
1561 const char kEnableCast[] = "enable-cast";
1563 // Enables zero suggest functionality on Dev channel, showing contextual
1564 // suggestions (EtherSuggest) for http pages and google.com search queries.
1565 const char kEnableZeroSuggestEtherSerp[] =
1566 "enable-zero-suggest-ether-serp";
1568 // Enables zero suggest functionality on Dev channel, showing contextual
1569 // suggestions (EtherSuggest) for http pages.
1570 const char kEnableZeroSuggestEtherNoSerp[] =
1571 "enable-zero-suggest-ether-noserp";
1573 // Enables zero suggest functionality on Dev channel, showing most visited
1574 // sites as default suggestions.
1575 const char kEnableZeroSuggestMostVisited[] =
1576 "enable-zero-suggest-most-visited";
1578 #endif
1580 #if defined(USE_ASH)
1581 const char kOpenAsh[] = "open-ash";
1582 #endif
1584 #if defined(OS_POSIX) && !defined(OS_MACOSX) && !defined(OS_CHROMEOS)
1585 // Specifies which password store to use (detect, default, gnome, kwallet).
1586 const char kPasswordStore[] = "password-store";
1587 #endif
1589 #if defined(OS_LINUX) && !defined(OS_CHROMEOS)
1590 // Triggers migration of user data directory to another directory
1591 // specified as a parameter. The migration is done under singleton lock,
1592 // and sanity checks are made to avoid corrupting the profile.
1593 // The browser exits after migration is complete.
1594 const char kMigrateDataDirForSxS[] = "migrate-data-dir-for-sxs";
1595 #endif // defined(OS_LINUX) && !defined(OS_CHROMEOS)
1597 #if defined(OS_MACOSX)
1598 // Disables the creation and launch of app shims for platform apps.
1599 const char kDisableAppShims[] = "disable-app-shims";
1601 // Forcibly disables Lion-style on newer OSes, to allow developers to test the
1602 // older, SnowLeopard-style fullscreen.
1603 const char kDisableSystemFullscreenForTesting[] =
1604 "disable-system-fullscreen-for-testing";
1606 // Enables the tabs expose feature ( http://crbug.com/50307 ).
1607 const char kEnableExposeForTabs[] = "enable-expose-for-tabs";
1609 // Enables a simplified fullscreen UI on Mac.
1610 const char kEnableSimplifiedFullscreen[] = "enable-simplified-fullscreen";
1612 // Performs Keychain reauthorization from the command line on behalf of a
1613 // special Keychain reauthorization stub executable. Used during auto-update.
1614 const char kKeychainReauthorize[] = "keychain-reauthorize";
1616 // A process type (switches::kProcessType) that relaunches the browser. See
1617 // chrome/browser/mac/relauncher.h.
1618 const char kRelauncherProcess[] = "relauncher";
1620 // Uses mock keychain for testing purposes, which prevents blocking dialogs
1621 // from causing timeouts.
1622 const char kUseMockKeychain[] = "use-mock-keychain";
1623 #endif
1625 #if defined(OS_WIN)
1626 // Force-enables the profile shortcut manager. This is needed for tests since
1627 // they use a custom-user-data-dir which disables this.
1628 const char kEnableProfileShortcutManager[] = "enable-profile-shortcut-manager";
1630 // For the DelegateExecute verb handler to launch Chrome in metro mode on
1631 // Windows 8 and higher. Used when relaunching metro Chrome.
1632 const char kForceImmersive[] = "force-immersive";
1634 // For the DelegateExecute verb handler to launch Chrome in desktop mode on
1635 // Windows 8 and higher. Used when relaunching metro Chrome.
1636 const char kForceDesktop[] = "force-desktop";
1638 // Relaunches metro Chrome on Windows 8 and higher using a given shortcut.
1639 const char kRelaunchShortcut[] = "relaunch-shortcut";
1641 // Waits for the given handle to be signaled before relaunching metro Chrome on
1642 // Windows 8 and higher.
1643 const char kWaitForMutex[] = "wait-for-mutex";
1645 // Indicates that chrome was launched to service a search request in Windows 8.
1646 const char kWindows8Search[] = "windows8-search";
1648 #endif
1650 #if defined(OS_WIN) && defined(USE_AURA)
1651 // Requests that Chrome connect to the running Metro viewer process.
1652 const char kViewerConnect[] = "viewer-connect";
1654 // Requests that Chrome launch the Metro viewer process via the given appid
1655 // (which is assumed to be registered as default browser) and synchronously
1656 // connect to it.
1657 const char kViewerLaunchViaAppId[] = "viewer-launch-via-appid";
1658 #endif
1660 #ifndef NDEBUG
1661 // Enables overriding the path of file manager extension.
1662 const char kFileManagerExtensionPath[] = "filemgr-ext-path";
1664 // Enables overriding the path of image loader extension.
1665 const char kImageLoaderExtensionPath[] = "image-loader-ext-path";
1666 #endif // NDEBUG
1668 // Controls print preview in the browser process.
1669 #if defined(GOOGLE_CHROME_BUILD)
1670 // Disables print preview (For testing, and for users who don't like us. :[ )
1671 const char kDisablePrintPreview[] = "disable-print-preview";
1672 #else
1673 // Enables print preview (Force enable on Chromium, which normally does not
1674 // have the PDF viewer required for print preview.)
1675 const char kEnablePrintPreview[] = "enable-print-preview";
1676 #endif
1678 // -----------------------------------------------------------------------------
1679 // DO NOT ADD YOUR CRAP TO THE BOTTOM OF THIS FILE.
1681 // You were going to just dump your switches here, weren't you? Instead, please
1682 // put them in alphabetical order above, or in order inside the appropriate
1683 // ifdef at the bottom. The order should match the header.
1684 // -----------------------------------------------------------------------------
1686 } // namespace switches