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"
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
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
22 // -----------------------------------------------------------------------------
24 // Allows third-party content included on a page to prompt for a HTTP basic
25 // auth username/password pair.
26 const char kAllowCrossOriginAuthPrompt
[] = "allow-cross-origin-auth-prompt";
28 // On ChromeOS, file:// access is disabled except for certain whitelisted
29 // directories. This switch re-enables file:// for testing.
30 const char kAllowFileAccess
[] = "allow-file-access";
32 // Allow non-secure origins to use the screen capture API and the desktopCapture
34 const char kAllowHttpScreenCapture
[] = "allow-http-screen-capture";
36 // Enables TLS/SSL errors on localhost to be ignored (no interstitial,
37 // no blocking of requests).
38 const char kAllowInsecureLocalhost
[] = "allow-insecure-localhost";
40 #if defined(ENABLE_PLUGINS)
41 // Specifies comma-separated list of extension ids or hosts to grant
42 // access to CRX file system APIs.
43 const char kAllowNaClCrxFsAPI
[] = "allow-nacl-crxfs-api";
45 // Specifies comma-separated list of extension ids or hosts to grant
46 // access to file handle APIs.
47 const char kAllowNaClFileHandleAPI
[] = "allow-nacl-file-handle-api";
49 // Specifies comma-separated list of extension ids or hosts to grant
50 // access to TCP/UDP socket APIs.
51 const char kAllowNaClSocketAPI
[] = "allow-nacl-socket-api";
53 // Disables forcing on the experimental Plugin Power Saver feature.
54 const char kDisablePluginPowerSaver
[] = "disable-plugin-power-saver";
56 // Enables forcing on the experimental Plugin Power Saver feature.
57 const char kEnablePluginPowerSaver
[] = "enable-plugin-power-saver";
60 // Don't block outdated plugins.
61 const char kAllowOutdatedPlugins
[] = "allow-outdated-plugins";
63 // By default, an https page cannot run JavaScript, CSS or plugins from http
64 // URLs. This provides an override to get the old insecure behavior.
65 const char kAllowRunningInsecureContent
[] = "allow-running-insecure-content";
67 // Specifies the probability threshold for alternative services: an advertised
68 // alternative service will only be honored if the advertised probability is
69 // greater than or equal to this threshold.
70 const char kAlternativeServiceProbabilityThreshold
[] =
71 "alternative-service-probability-threshold";
73 // Prevents Chrome from requiring authorization to run certain widely installed
74 // but less commonly used plugins.
75 const char kAlwaysAuthorizePlugins
[] = "always-authorize-plugins";
77 // Specifies that the extension-app with the specified id should be launched
78 // according to its configuration.
79 const char kAppId
[] = "app-id";
81 // Specifies that the associated value should be launched in "application"
83 const char kApp
[] = "app";
85 // Overrides the apps checkout URL, which is used to determine when to expose
87 const char kAppsCheckoutURL
[] = "apps-checkout-url";
89 // The URL that the webstore APIs download extensions from.
90 // Note: the URL must contain one '%s' for the extension ID.
91 const char kAppsGalleryDownloadURL
[] = "apps-gallery-download-url";
93 // The URL to use for the gallery link in the app launcher.
94 const char kAppsGalleryURL
[] = "apps-gallery-url";
96 // The update url used by gallery/webstore extensions.
97 const char kAppsGalleryUpdateURL
[] = "apps-gallery-update-url";
99 // Value of GAIA auth code for --force-app-mode.
100 const char kAppModeAuthCode
[] = "app-mode-auth-code";
102 // Value of OAuth2 refresh token for --force-app-mode.
103 const char kAppModeOAuth2Token
[] = "app-mode-oauth-token";
105 // Enables overriding the path for the default authentication extension.
106 const char kAuthExtensionPath
[] = "auth-ext-path";
108 // A flag that is used to tell Chrome that it was launched automatically at
109 // computer startup and not by some user action.
110 const char kAutoLaunchAtStartup
[] = "auto-launch-at-startup";
112 // This flag makes Chrome auto-select the provided choice when an extension asks
113 // permission to start desktop capture. Should only be used for tests. For
114 // instance, --auto-select-desktop-capture-source="Entire screen" will
115 // automatically select to share the entire screen in English locales.
116 const char kAutoSelectDesktopCaptureSource
[] =
117 "auto-select-desktop-capture-source";
119 // This flag causes the user engagement checks for showing app banners to be
120 // bypassed. It is intended to be used by developers who wish to test that their
121 // sites otherwise meet the criteria needed to show app banners.
122 const char kBypassAppBannerEngagementChecks
[] =
123 "bypass-app-banner-engagement-checks";
125 // Certificate Transparency: Uses the provided log(s) for checking Signed
126 // Certificate Timestamps provided with certificates.
127 // The switch's value is:
128 // log_description:log_key:log_url,log_description:log_key:log_url,...
130 // log_description is a textual description of the log.
131 // log_key is a Base64'd DER-encoded SubjectPublicKeyInfo of the log's
133 // log_url is a URL for the log, excluding the schema (which is always
134 // assumed to be HTTPS as required by RFC6962).
135 // Multiple logs can be specified by repeating description:key pairs,
136 // separated by a comma.
137 const char kCertificateTransparencyLog
[] =
138 "certificate-transparency-log";
140 // How often (in seconds) to check for updates. Should only be used for testing
142 const char kCheckForUpdateIntervalSec
[] = "check-for-update-interval";
144 // Comma-separated list of SSL cipher suites to disable.
145 const char kCipherSuiteBlacklist
[] = "cipher-suite-blacklist";
147 // Tells chrome to display the cloud print dialog and upload the specified file
149 const char kCloudPrintFile
[] = "cloud-print-file";
151 // Specifies the mime type to be used when uploading data from the file
152 // referenced by cloud-print-file. Defaults to "application/pdf" if
154 const char kCloudPrintFileType
[] = "cloud-print-file-type";
156 // Used with kCloudPrintFile to specify a JSON print ticket for the resulting
157 // print job. Defaults to null if unspecified.
158 const char kCloudPrintPrintTicket
[] = "cloud-print-print-ticket";
160 // Used with kCloudPrintFile to specify a title for the resulting print job.
161 const char kCloudPrintJobTitle
[] = "cloud-print-job-title";
163 // Setup cloud print proxy for provided printers. This does not start
164 // service or register proxy for autostart.
165 const char kCloudPrintSetupProxy
[] = "cloud-print-setup-proxy";
167 // Comma-separated list of BrowserThreads that cause browser process to crash
168 // if the given browser thread is not responsive. UI,IO,DB,FILE,CACHE are the
169 // list of BrowserThreads that are supported.
172 // --crash-on-hang-threads=UI:3:18,IO:3:18 --> Crash the browser if UI or IO
173 // is not responsive for 18 seconds and the number of browser threads that
174 // are responding is less than or equal to 3.
175 const char kCrashOnHangThreads
[] = "crash-on-hang-threads";
177 // Some platforms like ChromeOS default to empty desktop.
178 // Browser tests may need to add this switch so that at least one browser
179 // instance is created on startup.
180 // TODO(nkostylev): Investigate if this switch could be removed.
181 // (http://crbug.com/148675)
182 const char kCreateBrowserOnStartupForTests
[] =
183 "create-browser-on-startup-for-tests";
185 // Enables a frame context menu item that toggles the frame in and out of glass
186 // mode (Windows Vista and up only).
187 const char kDebugEnableFrameToggle
[] = "debug-enable-frame-toggle";
189 // Adds debugging entries such as Inspect Element to context menus of packed
191 const char kDebugPackedApps
[] = "debug-packed-apps";
193 // Triggers a plethora of diagnostic modes.
194 const char kDiagnostics
[] = "diagnostics";
196 // Sets the output format for diagnostic modes enabled by diagnostics flag.
197 const char kDiagnosticsFormat
[] = "diagnostics-format";
199 // Tells the diagnostics mode to do the requested recovery step(s).
200 const char kDiagnosticsRecovery
[] = "diagnostics-recovery";
202 // When kEnableSettingsWindow is used, About is shown as an overlay in Settings
203 // instead of as a separate page, unless this flag is specified.
204 const char kDisableAboutInSettings
[] = "disable-about-in-settings";
206 // Disables the display of a banner allowing the user to add a web
207 // app to their shelf (or platform-specific equivalent)
208 const char kDisableAddToShelf
[] = "disable-add-to-shelf";
210 // Disables the experimental asynchronous DNS client.
211 const char kDisableAsyncDns
[] = "disable-async-dns";
213 // Disable several subsystems which run network requests in the background.
214 // This is for use when doing network performance testing to avoid noise in the
216 const char kDisableBackgroundNetworking
[] = "disable-background-networking";
218 // Disables the bundled PPAPI version of Flash.
219 const char kDisableBundledPpapiFlash
[] = "disable-bundled-ppapi-flash";
221 // Disable hardware encoding support for Cast Streaming.
222 const char kDisableCastStreamingHWEncoding
[] =
223 "disable-cast-streaming-hw-encoding";
225 // Disables detection of child accounts.
226 const char kDisableChildAccountDetection
[] =
227 "disable-child-account-detection";
229 // Disables the client-side phishing detection feature. Note that even if
230 // client-side phishing detection is enabled, it will only be active if the
231 // user has opted in to UMA stats and SafeBrowsing is enabled in the
233 const char kDisableClientSidePhishingDetection
[] =
234 "disable-client-side-phishing-detection";
236 // Disable default component extensions with background pages - useful for
237 // performance tests where these pages may interfere with perf results.
238 const char kDisableComponentExtensionsWithBackgroundPages
[] =
239 "disable-component-extensions-with-background-pages";
241 const char kDisableComponentUpdate
[] = "disable-component-update";
243 // Disables installation of default apps on first run. This is used during
244 // automated testing.
245 const char kDisableDefaultApps
[] = "disable-default-apps";
247 // Disables device discovery notifications.
248 const char kDisableDeviceDiscoveryNotifications
[] =
249 "disable-device-discovery-notifications";
251 // Disables the dinosaur easter egg on the offline interstitial.
252 const char kDisableDinosaurEasterEgg
[] = "disable-dinosaur-easter-egg";
254 // Disables Domain Reliability Monitoring.
255 const char kDisableDomainReliability
[] = "disable-domain-reliability";
257 // Disable extensions.
258 const char kDisableExtensions
[] = "disable-extensions";
260 // Disable checking for user opt-in for extensions that want to inject script
261 // into file URLs (ie, always allow it). This is used during automated testing.
262 const char kDisableExtensionsFileAccessCheck
[] =
263 "disable-extensions-file-access-check";
265 // Disable the net::URLRequestThrottlerManager functionality for
266 // requests originating from extensions.
267 const char kDisableExtensionsHttpThrottling
[] =
268 "disable-extensions-http-throttling";
270 // Disable the behavior that the second click on a launcher item (the click when
271 // the item is already active) minimizes the item.
272 const char kDisableMinimizeOnSecondLauncherItemClick
[] =
273 "disable-minimize-on-second-launcher-item-click";
275 // Disables the new bookmark app system.
276 const char kDisableNewBookmarkApps
[] = "disable-new-bookmark-apps";
278 // Disables the new offline error page generated by NetErrorHelper for ChromeOS
279 // and instead uses the old error page generated by OfflineResourceThrottle.
280 const char kDisableNewOfflineErrorPage
[] = "disable-new-offline-error-page";
282 // Disable auto-reload of error pages if offline.
283 const char kDisableOfflineAutoReload
[] = "disable-offline-auto-reload";
285 // Disable only auto-reloading error pages when the tab is visible.
286 const char kDisableOfflineAutoReloadVisibleOnly
[] =
287 "disable-offline-auto-reload-visible-only";
289 // Disable out-of-process V8 proxy resolver.
290 const char kDisableOutOfProcessPac
[] = "disable-out-of-process-pac";
292 // Disable the setting to prompt the user for their OS account password before
293 // revealing plaintext passwords in the password manager.
294 const char kDisablePasswordManagerReauthentication
[] =
295 "disable-password-manager-reauthentication";
297 // Disable the new material UI - requires out of process PDF plugin.
298 const char kDisablePdfMaterialUI
[] = "disable-pdf-material-ui";
300 // Don't use bubbles for content permissions requests instead of infobars.
301 const char kDisablePermissionsBubbles
[] = "disable-permissions-bubbles";
303 // Disable pop-up blocking.
304 const char kDisablePopupBlocking
[] = "disable-popup-blocking";
306 // Disable speculative TCP/IP preconnection.
307 const char kDisablePreconnect
[] = "disable-preconnect";
309 // Disables print preview (For testing, and for users who don't like us. :[ )
310 const char kDisablePrintPreview
[] = "disable-print-preview";
312 // Normally when the user attempts to navigate to a page that was the result of
313 // a post we prompt to make sure they want to. This switch may be used to
314 // disable that check. This switch is used during automated testing.
315 const char kDisablePromptOnRepost
[] = "disable-prompt-on-repost";
317 // Disables support for the QUIC protocol.
318 const char kDisableQuic
[] = "disable-quic";
320 // Disable use of Chromium's port selection for the ephemeral port via bind().
321 // This only has an effect if QUIC protocol is enabled.
322 const char kDisableQuicPortSelection
[] = "disable-quic-port-selection";
324 // Prevents the save password bubble from being enabled.
325 const char kDisableSavePasswordBubble
[] = "disable-save-password-bubble";
327 // Prevents SDCH persistence from being used.
328 const char kDisableSdchPersistence
[] = "disable-sdch-persistence";
330 // Disables using bubbles for session restore request.
331 const char kDisableSessionCrashedBubble
[] = "disable-session-crashed-bubble";
333 // Disables the Site Engagement service, which records interaction with sites
334 // and allocates certain resources accordingly.
335 const char kDisableSiteEngagementService
[] = "disable-site-engagement-service";
337 // Disables the suggestions service.
338 const char kDisableSuggestionsService
[] = "disable-suggestions-service";
340 // Disables syncing browser data to a Google Account.
341 const char kDisableSync
[] = "disable-sync";
343 // Disables syncing one or more sync data types that are on by default.
344 // See sync/internal_api/public/base/model_type.h for possible types. Types
345 // should be comma separated, and follow the naming convention for string
346 // representation of model types, e.g.:
347 // --disable-synctypes='Typed URLs, Bookmarks, Autofill Profiles'
348 const char kDisableSyncTypes
[] = "disable-sync-types";
350 // Disables the backend service for web resources.
351 const char kDisableWebResources
[] = "disable-web-resources";
353 // Some tests seem to require the application to close when the last
354 // browser window is closed. Thus, we need a switch to force this behavior
355 // for ChromeOS Aura, disable "zero window mode".
356 // TODO(pkotwicz): Investigate if this bug can be removed.
357 // (http://crbug.com/119175)
358 const char kDisableZeroBrowsersOpenForTests
[] =
359 "disable-zero-browsers-open-for-tests";
361 // Use a specific disk cache location, rather than one derived from the
363 const char kDiskCacheDir
[] = "disk-cache-dir";
365 // Forces the maximum disk space to be used by the disk cache, in bytes.
366 const char kDiskCacheSize
[] = "disk-cache-size";
368 const char kDnsLogDetails
[] = "dns-log-details";
370 // Disables prefetching of DNS information.
371 const char kDnsPrefetchDisable
[] = "dns-prefetch-disable";
373 // Requests that a running browser process dump its collected histograms to a
374 // given file. The file is overwritten if it exists.
375 const char kDumpBrowserHistograms
[] = "dump-browser-histograms";
377 // Overrides the path of Easy Unlock component app.
378 const char kEasyUnlockAppPath
[] = "easy-unlock-app-path";
380 // Enables the display of a banner allowing the user to add a web
381 // app to their shelf (or platform-specific equivalent)
382 const char kEnableAddToShelf
[] = "enable-add-to-shelf";
384 // If set, the app list will be enabled as if enabled from CWS.
385 const char kEnableAppList
[] = "enable-app-list";
387 // Enable OS integration for Chrome app file associations.
388 const char kEnableAppsFileAssociations
[] = "enable-apps-file-associations";
390 // Enables the benchmarking extensions.
391 const char kEnableBenchmarking
[] = "enable-benchmarking";
393 // Enables the multi-level undo system for bookmarks.
394 const char kEnableBookmarkUndo
[] = "enable-bookmark-undo";
396 // Enables detection of child accounts.
397 const char kEnableChildAccountDetection
[] =
398 "enable-child-account-detection";
400 // This applies only when the process type is "service". Enables the Cloud
401 // Print Proxy component within the service process.
402 const char kEnableCloudPrintProxy
[] = "enable-cloud-print-proxy";
404 // If true devtools experimental settings are enabled.
405 const char kEnableDevToolsExperiments
[] = "enable-devtools-experiments";
407 // Enable device discovery notifications.
408 const char kEnableDeviceDiscoveryNotifications
[] =
409 "enable-device-discovery-notifications";
411 // Enables the DOM distiller.
412 const char kEnableDomDistiller
[] = "enable-dom-distiller";
414 // Enables Domain Reliability Monitoring.
415 const char kEnableDomainReliability
[] = "enable-domain-reliability";
417 // Enables Download Notification.
418 const char kEnableDownloadNotification
[] = "enable-download-notification";
420 // Enable Enhanced Bookmarks.
421 const char kEnhancedBookmarksExperiment
[] = "enhanced-bookmarks-experiment";
423 // Enables experimentation with ephemeral apps to be launched from the webstore.
424 const char kEnableEphemeralAppsInWebstore
[] =
425 "enable-ephemeral-apps-in-webstore";
427 // Enables experimental hotword features specific to always-on.
428 const char kEnableExperimentalHotwordHardware
[] = "enable-hotword-hardware";
430 // Enables logging for extension activity.
431 const char kEnableExtensionActivityLogging
[] =
432 "enable-extension-activity-logging";
434 const char kEnableExtensionActivityLogTesting
[] =
435 "enable-extension-activity-log-testing";
437 // Enable the fast unload controller, which speeds up tab/window close by
438 // running a tab's onunload js handler independently of the GUI -
439 // crbug.com/142458 .
440 const char kEnableFastUnload
[] = "enable-fast-unload";
442 // Enables experimentation with launching ephemeral apps via hyperlinks.
443 const char kEnableLinkableEphemeralApps
[] = "enable-linkable-ephemeral-apps";
445 // Enables the material design Settings feature.
446 const char kEnableMaterialDesignSettings
[] = "enable-md-settings";
448 // Enables Media Router.
449 const char kEnableMediaRouter
[] = "enable-media-router";
451 // Runs the Native Client inside the renderer process and enables GPU plugin
452 // (internally adds lEnableGpuPlugin to the command line).
453 const char kEnableNaCl
[] = "enable-nacl";
455 // Enables the network-related benchmarking extensions.
456 const char kEnableNetBenchmarking
[] = "enable-net-benchmarking";
458 // Enables the new bookmark app system.
459 const char kEnableNewBookmarkApps
[] = "enable-new-bookmark-apps";
461 // Enable auto-reload of error pages if offline.
462 const char kEnableOfflineAutoReload
[] = "enable-offline-auto-reload";
464 // Only auto-reload error pages when the tab is visible.
465 const char kEnableOfflineAutoReloadVisibleOnly
[] =
466 "enable-offline-auto-reload-visible-only";
468 // Enables panels (always on-top docked pop-up windows).
469 const char kEnablePanels
[] = "enable-panels";
471 // Enable the new material UI - requires out of process PDF plugin.
472 const char kEnablePdfMaterialUI
[] = "enable-pdf-material-ui";
474 // Enables presenting plugin placeholder content as shadow DOM.
475 const char kEnablePluginPlaceholderShadowDom
[] =
476 "enable-plugin-placeholder-shadow-dom";
478 // Enables a number of potentially annoying security features (strict mixed
479 // content mode, powerful feature restrictions, etc.)
480 const char kEnablePotentiallyAnnoyingSecurityFeatures
[] =
481 "enable-potentially-annoying-security-features";
483 // Enables the Power overlay in Settings.
484 const char kEnablePowerOverlay
[] = "enable-power-overlay";
486 // Enables showing unregistered printers in print preview
487 const char kEnablePrintPreviewRegisterPromos
[] =
488 "enable-print-preview-register-promos";
490 // Enables tracking of tasks in profiler for viewing via about:profiler.
491 // To predominantly disable tracking (profiling), use the command line switch:
492 // --enable-profiling=0
493 // Some tracking will still take place at startup, but it will be turned off
494 // during chrome_browser_main.
495 const char kEnableProfiling
[] = "enable-profiling";
497 // Enables query in the omnibox.
498 const char kEnableQueryExtraction
[] = "enable-query-extraction";
500 // Enables support for the QUIC protocol. This is a temporary testing flag.
501 const char kEnableQuic
[] = "enable-quic";
503 // Enable use of Chromium's port selection for the ephemeral port via bind().
504 // This only has an effect if QUIC protocol is enabled.
505 const char kEnableQuicPortSelection
[] = "enable-quic-port-selection";
507 // Enables save password prompt bubble.
508 const char kEnableSavePasswordBubble
[] = "enable-save-password-bubble";
510 // Enables SDCH persistence.
511 const char kEnableSdchPersistence
[] = "enable-sdch-persistence";
513 // Enables using bubbles for session restore request instead of infobars.
514 const char kEnableSessionCrashedBubble
[] = "enable-session-crashed-bubble";
516 // Enable or disable settings in a separate browser window per profile
517 // (see SettingsWindowEnabled() below).
518 const char kEnableSettingsWindow
[] = "enable-settings-window";
519 const char kDisableSettingsWindow
[] = "disable-settings-window";
521 // Enable the Site Engagement service, which records interaction with sites and
522 // allocates certain resources accordingly.
523 const char kEnableSiteEngagementService
[] = "enable-site-engagement-service";
525 // Enables the suggestions service.
526 const char kEnableSuggestionsService
[] = "enable-suggestions-service";
528 // Enables the supervised user managed bookmarks folder.
529 const char kEnableSupervisedUserManagedBookmarksFolder
[] =
530 "enable-supervised-user-managed-bookmarks-folder";
532 // Enables synced articles.
533 const char kEnableSyncArticles
[] = "enable-sync-articles";
535 // Enables user control over muting tab audio from the tab strip.
536 const char kEnableTabAudioMuting
[] = "enable-tab-audio-muting";
538 // Enables fanciful thumbnail processing. Used with NTP for
539 // instant-extended-api, where thumbnails are generally smaller.
540 const char kEnableThumbnailRetargeting
[] = "enable-thumbnail-retargeting";
542 // Enables Alternate-Protocol when the port is user controlled (> 1024).
543 const char kEnableUserAlternateProtocolPorts
[] =
544 "enable-user-controlled-alternate-protocol-ports";
546 // Enables a new "web app" style frame for hosted apps (including bookmark
548 extern const char kEnableWebAppFrame
[] = "enable-web-app-frame";
550 // Enables synchronizing WiFi credentials across devices, using Chrome Sync.
551 const char kEnableWifiCredentialSync
[] = "enable-wifi-credential-sync";
553 // Values for the kExtensionContentVerification flag.
554 // See ContentVerifierDelegate::Mode for more explanation.
555 const char kExtensionContentVerificationBootstrap
[] = "bootstrap";
556 const char kExtensionContentVerificationEnforceStrict
[] = "enforce_strict";
557 const char kExtensionContentVerificationEnforce
[] = "enforce";
559 // Name of the command line flag to force content verification to be on in one
561 const char kExtensionContentVerification
[] = "extension-content-verification";
563 // Turns on extension install verification if it would not otherwise have been
565 const char kExtensionsInstallVerification
[] = "extensions-install-verification";
567 // Specifies a comma-separated list of extension ids that should be forced to
568 // be treated as not from the webstore when doing install verification.
569 const char kExtensionsNotWebstore
[] = "extensions-not-webstore";
571 // Frequency in seconds for Extensions auto-update.
572 const char kExtensionsUpdateFrequency
[] = "extensions-update-frequency";
574 // Fakes the channel of the browser for purposes of Variations filtering. This
575 // is to be used for testing only. Possible values are "stable", "beta", "dev"
576 // and "canary". Note that this only applies if the browser's reported channel
578 const char kFakeVariationsChannel
[] = "fake-variations-channel";
580 // If this flag is present then this command line is being delegated to an
581 // already running chrome process via the fast path, ie: before chrome.dll is
582 // loaded. It is useful to tell the difference for tracking purposes.
583 const char kFastStart
[] = "fast-start";
585 // These two flags are added around the switches about:flags adds to the
586 // command line. This is useful to see which switches were added by about:flags
587 // on about:version. They don't have any effect.
588 const char kFlagSwitchesBegin
[] = "flag-switches-begin";
589 const char kFlagSwitchesEnd
[] = "flag-switches-end";
591 // Forces application mode. This hides certain system UI elements and forces
592 // the app to be installed if it hasn't been already.
593 const char kForceAppMode
[] = "force-app-mode";
595 // This option can be used to force parameters of field trials when testing
596 // changes locally. The argument is a list of key/value pairs prefixed by
597 // Trial/Group pair. The following shows setting parameters to 2 experiments
598 // where in the first, it forces "id" to be "foo" for the "Enabled" group of
599 // the "EnhancedBookmarks" trial:
600 // "EnhancedBookmarks.Enabled:id/foo,Experiment2.Group1:key1/value1"
601 // Trial names, groups names, parameter names, and value should all be URL
602 // escaped for all non-alphanumeric characters.
603 const char kForceFieldTrialParams
[] = "force-fieldtrial-params";
605 // Displays the First Run experience when the browser is started, regardless of
606 // whether or not it's actually the First Run (this overrides kNoFirstRun).
607 const char kForceFirstRun
[] = "force-first-run";
609 // Forces additional Chrome Variation Ids that will be sent in X-Client-Data
610 // header, specified as a 64-bit encoded list of numeric experiment ids. Ids
611 // prefixed with the character "t" will be treated as Trigger Variation Ids.
612 const char kForceVariationIds
[] = "force-variation-ids";
614 // Enables grouping websites by domain and filtering them by period.
615 const char kHistoryEnableGroupByDomain
[] = "enable-grouped-history";
617 // Specifies which page will be displayed in newly-opened tabs. We need this
618 // for testing purposes so that the UI tests don't depend on what comes up for
619 // http://google.com.
620 const char kHomePage
[] = "homepage";
622 // Comma-separated list of rules that control how hostnames are mapped.
625 // "MAP * 127.0.0.1" --> Forces all hostnames to be mapped to 127.0.0.1
626 // "MAP *.google.com proxy" --> Forces all google.com subdomains to be
627 // resolved to "proxy".
628 // "MAP test.com [::1]:77 --> Forces "test.com" to resolve to IPv6 loopback.
629 // Will also force the port of the resulting
630 // socket address to be 77.
631 // "MAP * baz, EXCLUDE www.google.com" --> Remaps everything to "baz",
632 // except for "www.google.com".
634 // These mappings apply to the endpoint host in a net::URLRequest (the TCP
635 // connect and host resolver in a direct connection, and the CONNECT in an http
636 // proxy connection, and the endpoint host in a SOCKS proxy connection).
637 const char kHostRules
[] = "host-rules";
639 // The maximum number of retry attempts to resolve the host. Set this to zero
640 // to disable host resolver retry attempts.
641 const char kHostResolverRetryAttempts
[] = "host-resolver-retry-attempts";
643 // Causes net::URLFetchers to ignore requests for SSL client certificates,
644 // causing them to attempt an unauthenticated SSL/TLS session. This is intended
645 // for use when testing various service URLs (eg: kPromoServerURL, kSbURLPrefix,
646 // kSyncServiceURL, etc)
647 const char kIgnoreUrlFetcherCertRequests
[] =
648 "ignore-urlfetcher-cert-requests";
650 // Causes the browser to launch directly in incognito mode.
651 const char kIncognito
[] = "incognito";
653 // Causes Chrome to initiate an installation flow for the given app.
654 const char kInstallChromeApp
[] = "install-chrome-app";
656 // Causes Chrome to attempt to get metadata from the webstore for the
657 // app/extension ID given, and then prompt the user to download and install it.
658 // This is allowed *only* for ephemeral apps. All other ids will be ignored.
659 const char kInstallEphemeralAppFromWebstore
[] =
660 "install-ephemeral-app-from-webstore";
662 // A list of whitelists to install for a supervised user, for testing.
663 // The list is of the following form: <id>[:<name>],[<id>[:<name>],...]
664 const char kInstallSupervisedUserWhitelists
[] =
665 "install-supervised-user-whitelists";
667 // Marks a renderer as an Instant process.
668 const char kInstantProcess
[] = "instant-process";
670 // Invalidation service should use GCM network channel even if experiment is not
672 const char kInvalidationUseGCMChannel
[] = "invalidation-use-gcm-channel";
674 // Disable latest shipping ECMAScript 6 features.
675 const char kDisableJavaScriptHarmonyShipping
[] =
676 "disable-javascript-harmony-shipping";
678 // Enables experimental Harmony (ECMAScript 6) features.
679 const char kJavaScriptHarmony
[] = "javascript-harmony";
681 // Dumps IPC messages sent from renderer processes to the browser process to
682 // the given directory. Used primarily to gather samples for IPC fuzzing.
683 const char kIpcDumpDirectory
[] = "ipc-dump-directory";
685 // Used for testing - keeps browser alive after last browser window closes.
686 const char kKeepAliveForTest
[] = "keep-alive-for-test";
688 // Enable Kiosk mode.
689 const char kKioskMode
[] = "kiosk";
691 // Print automatically in kiosk mode. |kKioskMode| must be set as well.
692 // See http://crbug.com/31395.
693 const char kKioskModePrinting
[] = "kiosk-printing";
695 // Comma-separated list of directories with component extensions to load.
696 const char kLoadComponentExtension
[] = "load-component-extension";
698 // Loads an extension from the specified directory.
699 const char kLoadExtension
[] = "load-extension";
701 // Makes Chrome default browser
702 const char kMakeDefaultBrowser
[] = "make-default-browser";
704 // Use to opt-in to marking HTTP as non-secure.
705 const char kMarkNonSecureAs
[] = "mark-non-secure-as";
706 const char kMarkNonSecureAsNeutral
[] = "neutral";
707 const char kMarkNonSecureAsDubious
[] = "dubious";
708 const char kMarkNonSecureAsNonSecure
[] = "non-secure";
710 // Forces the maximum disk space to be used by the media cache, in bytes.
711 const char kMediaCacheSize
[] = "media-cache-size";
713 // Enables histograming of tasks served by MessageLoop. See
714 // about:histograms/Loop for results, which show frequency of messages on each
715 // thread, including APC count, object signalling count, etc.
716 const char kMessageLoopHistogrammer
[] = "message-loop-histogrammer";
718 // Enables the recording of metrics reports but disables reporting. In contrast
719 // to kDisableMetrics, this executes all the code that a normal client would
720 // use for reporting, except the report is dropped rather than sent to the
721 // server. This is useful for finding issues in the metrics code during UI and
722 // performance tests.
723 const char kMetricsRecordingOnly
[] = "metrics-recording-only";
725 // Allows setting a different destination ID for connection-monitoring GCM
726 // messages. Useful when running against a non-prod management server.
727 const char kMonitoringDestinationID
[] = "monitoring-destination-id";
729 // Sets the granularity of events to capture in the network log. The mode can be
730 // set to one of the following values:
732 // "IncludeCookiesAndCredentials"
733 // "IncludeSocketBytes"
735 // See the functions of the corresponding name in net_log_capture_mode.h for a
736 // description of their meaning.
737 const char kNetLogCaptureMode
[] = "net-log-capture-mode";
739 // Disables the default browser check. Useful for UI/browser tests where we
740 // want to avoid having the default browser info-bar displayed.
741 const char kNoDefaultBrowserCheck
[] = "no-default-browser-check";
743 // By default, an https page can load images, fonts or frames from an http
744 // page. This switch overrides this to block this lesser mixed-content problem.
745 const char kNoDisplayingInsecureContent
[] = "no-displaying-insecure-content";
747 // Disables all experiments set on about:flags. Does not disable about:flags
748 // itself. Useful if an experiment makes chrome crash at startup: One can start
749 // chrome with --no-experiments, disable the problematic lab at about:flags and
750 // then restart chrome without this switch again.
751 const char kNoExperiments
[] = "no-experiments";
753 // Skip First Run tasks, whether or not it's actually the First Run. Overridden
754 // by kForceFirstRun. This does not drop the First Run sentinel and thus doesn't
755 // prevent first run from occuring the next time chrome is launched without this
757 const char kNoFirstRun
[] = "no-first-run";
759 // Don't send hyperlink auditing pings
760 const char kNoPings
[] = "no-pings";
762 // Don't use a proxy server, always make direct connections. Overrides any
763 // other proxy server flags that are passed.
764 const char kNoProxyServer
[] = "no-proxy-server";
766 // Disables the service process from adding itself as an autorun process. This
767 // does not delete existing autorun registrations, it just prevents the service
768 // from registering a new one.
769 const char kNoServiceAutorun
[] = "no-service-autorun";
771 // Does not automatically open a browser window on startup (used when
772 // launching Chrome for the purpose of hosting background apps).
773 const char kNoStartupWindow
[] = "no-startup-window";
775 // Disables checking whether we received an acknowledgment when registering
776 // a supervised user. Also disables the timeout during registration that waits
777 // for the ack. Useful when debugging against a server that does not
778 // support notifications.
779 const char kNoSupervisedUserAcknowledgmentCheck
[] =
780 "no-managed-user-acknowledgment-check";
782 // Specifies the maximum number of threads to use for running the Proxy
783 // Autoconfig (PAC) script.
784 const char kNumPacThreads
[] = "num-pac-threads";
786 // Launches URL in new browser window.
787 const char kOpenInNewWindow
[] = "new-window";
789 // Force use of QUIC for requests to the specified origin.
790 const char kOriginToForceQuicOn
[] = "origin-to-force-quic-on";
792 // The time that a new chrome process which is delegating to an already running
793 // chrome process started. (See ProcessSingleton for more details.)
794 const char kOriginalProcessStartTime
[] = "original-process-start-time";
796 // Packages an extension to a .crx installable file from a given directory.
797 const char kPackExtension
[] = "pack-extension";
799 // Optional PEM private key to use in signing packaged .crx.
800 const char kPackExtensionKey
[] = "pack-extension-key";
802 // Specifies the path to the user data folder for the parent profile.
803 const char kParentProfile
[] = "parent-profile";
805 // Development flag for permission request API. This flag is needed until
806 // the API is finalized.
807 // TODO(bauerb): Remove when this flag is not needed anymore.
808 const char kPermissionRequestApiScope
[] = "permission-request-api-scope";
810 // Development flag for permission request API. This flag is needed until
811 // the API is finalized.
812 // TODO(bauerb): Remove when this flag is not needed anymore.
813 const char kPermissionRequestApiUrl
[] = "permission-request-api-url";
815 // Use the PPAPI (Pepper) Flash found at the given path.
816 const char kPpapiFlashPath
[] = "ppapi-flash-path";
818 // Report the given version for the PPAPI (Pepper) Flash. The version should be
819 // numbers separated by '.'s (e.g., "12.3.456.78"). If not specified, it
820 // defaults to "10.2.999.999".
821 const char kPpapiFlashVersion
[] = "ppapi-flash-version";
823 // Triggers prerendering of pages from suggestions in the omnibox. Only has an
824 // effect when Instant is either disabled or restricted to search, and when
825 // prerender is enabled.
826 const char kPrerenderFromOmnibox
[] = "prerender-from-omnibox";
827 // These are the values the kPrerenderFromOmnibox switch may have, as in
828 // "--prerender-from-omnibox=auto". auto: Allow field trial selection.
829 const char kPrerenderFromOmniboxSwitchValueAuto
[] = "auto";
830 // disabled: No prerendering.
831 const char kPrerenderFromOmniboxSwitchValueDisabled
[] = "disabled";
832 // enabled: Guaranteed prerendering.
833 const char kPrerenderFromOmniboxSwitchValueEnabled
[] = "enabled";
834 // Controls speculative prerendering of pages, and content prefetching. Both
835 // are dispatched from <link rel=prefetch href=...> elements.
836 const char kPrerenderMode
[] = "prerender";
837 // These are the values the kPrerenderMode switch may have, as in
838 // "--prerender=disabled".
839 // disabled: No prerendering.
840 const char kPrerenderModeSwitchValueDisabled
[] = "disabled";
841 // enabled: Prerendering.
842 const char kPrerenderModeSwitchValueEnabled
[] = "enabled";
844 // Use IPv6 only for privet HTTP.
845 const char kPrivetIPv6Only
[] = "privet-ipv6-only";
847 // Outputs the product version information and quit. Used as an internal api to
848 // detect the installed version of Chrome on Linux.
849 const char kProductVersion
[] = "product-version";
851 // Selects directory of profile to associate with the first browser launched.
852 const char kProfileDirectory
[] = "profile-directory";
854 // Starts the sampling based profiler for the browser process at startup. This
855 // will only work if chrome has been built with the gyp variable profiling=1.
856 // The output will go to the value of kProfilingFile.
857 const char kProfilingAtStart
[] = "profiling-at-start";
859 // Specifies a location for profiling output. This will only work if chrome has
860 // been built with the gyp variable profiling=1.
862 // {pid} if present will be replaced by the pid of the process.
863 // {count} if present will be incremented each time a profile is generated
865 // The default is chrome-profile-{pid}.
866 const char kProfilingFile
[] = "profiling-file";
868 // Controls whether profile data is periodically flushed to a file. Normally
869 // the data gets written on exit but cases exist where chrome doesn't exit
870 // cleanly (especially when using single-process). A time in seconds can be
872 const char kProfilingFlush
[] = "profiling-flush";
874 // Forces proxy auto-detection.
875 const char kProxyAutoDetect
[] = "proxy-auto-detect";
877 // Specifies a list of hosts for whom we bypass proxy settings and use direct
878 // connections. Ignored if --proxy-auto-detect or --no-proxy-server are also
879 // specified. This is a comma-separated list of bypass rules. See:
880 // "net/proxy/proxy_bypass_rules.h" for the format of these rules.
881 const char kProxyBypassList
[] = "proxy-bypass-list";
883 // Uses the pac script at the given URL
884 const char kProxyPacUrl
[] = "proxy-pac-url";
886 // Uses a specified proxy server, overrides system settings. This switch only
887 // affects HTTP and HTTPS requests.
888 const char kProxyServer
[] = "proxy-server";
890 // Specifies a comma separated list of QUIC connection options to send to
892 const char kQuicConnectionOptions
[] = "quic-connection-options";
894 // Specifies the maximum length for a QUIC packet.
895 const char kQuicMaxPacketLength
[] = "quic-max-packet-length";
897 // Specifies the version of QUIC to use.
898 const char kQuicVersion
[] = "quic-version";
900 // If set, the app list will forget it has been installed on startup. Note this
901 // doesn't prevent the app list from running, it just makes Chrome think the app
902 // list hasn't been enabled (as in kEnableAppList) yet.
903 const char kResetAppListInstallState
[] = "reset-app-list-install-state";
905 // Indicates the last session should be restored on startup. This overrides the
906 // preferences value and is primarily intended for testing. The value of this
907 // switch is the number of tabs to wait until loaded before 'load completed' is
908 // sent to the ui_test.
909 const char kRestoreLastSession
[] = "restore-last-session";
911 // Disable saving pages as HTML-only, disable saving pages as HTML Complete
912 // (with a directory of sub-resources). Enable only saving pages as MHTML.
913 // See http://crbug.com/120416 for how to remove this switch.
914 const char kSavePageAsMHTML
[] = "save-page-as-mhtml";
916 // If present, safebrowsing only performs update when
917 // SafeBrowsingProtocolManager::ForceScheduleNextUpdate() is explicitly called.
918 // This is used for testing only.
919 const char kSbDisableAutoUpdate
[] = "safebrowsing-disable-auto-update";
921 // TODO(lzheng): Remove this flag once the feature works fine
922 // (http://crbug.com/74848).
924 // Disables safebrowsing feature that checks download url and downloads
925 // content's hash to make sure the content are not malicious.
926 const char kSbDisableDownloadProtection
[] =
927 "safebrowsing-disable-download-protection";
929 // Disables safebrowsing feature that checks for blacklisted extensions.
930 const char kSbDisableExtensionBlacklist
[] =
931 "safebrowsing-disable-extension-blacklist";
933 // Causes the process to run as a service process.
934 const char kServiceProcess
[] = "service";
936 // If true the app list will be shown.
937 const char kShowAppList
[] = "show-app-list";
939 // Command line flag offering a "Show saved copy" option to the user if offline.
940 // The various modes are disabled, primary, or secondary. Primary/secondary
941 // refers to button placement (for experiment).
942 const char kShowSavedCopy
[] = "show-saved-copy";
944 // Values for the kShowSavedCopy flag.
945 const char kEnableShowSavedCopyPrimary
[] = "primary";
946 const char kEnableShowSavedCopySecondary
[] = "secondary";
947 const char kDisableShowSavedCopy
[] = "disable";
949 // Does not show an infobar when an extension attaches to a page using
950 // chrome.debugger page. Required to attach to extension background pages.
951 const char kSilentDebuggerExtensionAPI
[] = "silent-debugger-extension-api";
953 // Causes Chrome to launch without opening any windows by default. Useful if
954 // one wishes to use Chrome as an ash server.
955 const char kSilentLaunch
[] = "silent-launch";
957 // Simulates that elevation is needed to recover upgrade channel.
958 const char kSimulateElevatedRecovery
[] = "simulate-elevated-recovery";
960 // Simulates a critical update being available.
961 const char kSimulateCriticalUpdate
[] = "simulate-critical-update";
963 // Simulates that current version is outdated.
964 const char kSimulateOutdated
[] = "simulate-outdated";
966 // Simulates that current version is outdated and auto-update is off.
967 const char kSimulateOutdatedNoAU
[] = "simulate-outdated-no-au";
969 // Simulates an update being available.
970 const char kSimulateUpgrade
[] = "simulate-upgrade";
972 // Speculative resource prefetching.
973 const char kSpeculativeResourcePrefetching
[] =
974 "speculative-resource-prefetching";
976 // Speculative resource prefetching is disabled.
977 const char kSpeculativeResourcePrefetchingDisabled
[] = "disabled";
979 // Speculative resource prefetching will only learn about resources that need to
980 // be prefetched but will not prefetch them.
981 const char kSpeculativeResourcePrefetchingLearning
[] = "learning";
983 // Speculative resource prefetching is enabled.
984 const char kSpeculativeResourcePrefetchingEnabled
[] = "enabled";
986 #if defined(ENABLE_SPELLCHECK)
987 // Enables auto correction for misspelled words.
988 const char kEnableSpellingAutoCorrect
[] = "enable-spelling-auto-correct";
990 // Enables participation in the field trial for user feedback to spelling
992 const char kEnableSpellingFeedbackFieldTrial
[] =
993 "enable-spelling-feedback-field-trial";
995 // Specifies the URL where spelling service feedback data will be sent instead
996 // of the default URL. This switch is for temporary testing only.
997 // TODO(rouslan): Remove this flag when feedback testing is complete. Revisit by
999 const char kSpellingServiceFeedbackUrl
[] = "spelling-service-feedback-url";
1001 // Specifies the number of seconds between sending batches of feedback to
1002 // spelling service. The default is 30 minutes. The minimum is 5 seconds. This
1003 // switch is for temporary testing only.
1004 // TODO(rouslan): Remove this flag when feedback testing is complete. Revisit by
1006 const char kSpellingServiceFeedbackIntervalSeconds
[] =
1007 "spelling-service-feedback-interval-seconds";
1010 // Specifies the maximum SSL/TLS version ("tls1", "tls1.1", or "tls1.2").
1011 const char kSSLVersionMax
[] = "ssl-version-max";
1013 // Specifies the minimum SSL/TLS version ("tls1", "tls1.1", or "tls1.2").
1014 const char kSSLVersionMin
[] = "ssl-version-min";
1016 // Specifies the minimum SSL/TLS version ("tls1", "tls1.1", or "tls1.2") that
1017 // TLS fallback will accept.
1018 const char kSSLVersionFallbackMin
[] = "ssl-version-fallback-min";
1020 // These values aren't switches, but rather the values that kSSLVersionMax,
1021 // kSSLVersionMin and kSSLVersionFallbackMin can have.
1022 const char kSSLVersionTLSv1
[] = "tls1";
1023 const char kSSLVersionTLSv11
[] = "tls1.1";
1024 const char kSSLVersionTLSv12
[] = "tls1.2";
1026 // Starts the browser maximized, regardless of any previous settings.
1027 const char kStartMaximized
[] = "start-maximized";
1029 // Sets the supervised user ID for any loaded or newly created profile to the
1030 // given value. Pass an empty string to mark the profile as non-supervised.
1031 // Used for testing.
1032 const char kSupervisedUserId
[] = "managed-user-id";
1034 // Enables/disables SafeSites filtering for supervised users. Possible values
1035 // are "enabled", "disabled", "blacklist-only", and "online-check-only".
1036 const char kSupervisedUserSafeSites
[] = "supervised-user-safesites";
1038 // Used to authenticate requests to the Sync service for supervised users.
1039 // Setting this switch also causes Sync to be set up for a supervised user.
1040 const char kSupervisedUserSyncToken
[] = "managed-user-sync-token";
1042 // This flag causes sync to retry very quickly (see polling_constants.h) the
1043 // when it encounters an error, as the first step towards exponential backoff.
1044 const char kSyncShortInitialRetryOverride
[] =
1045 "sync-short-initial-retry-override";
1047 // Overrides the default server used for profile sync.
1048 const char kSyncServiceURL
[] = "sync-url";
1050 // Enables deferring sync backend initialization until user initiated changes
1052 const char kSyncDisableDeferredStartup
[] = "sync-disable-deferred-startup";
1054 // Allows overriding the deferred init fallback timeout.
1055 const char kSyncDeferredStartupTimeoutSeconds
[] =
1056 "sync-deferred-startup-timeout-seconds";
1058 // Enables feature to avoid unnecessary GetUpdate requests.
1059 const char kSyncEnableGetUpdateAvoidance
[] =
1060 "sync-enable-get-update-avoidance";
1062 // Disable data backup when user's not signed in.
1063 const char kSyncDisableBackup
[] = "disable-sync-backup";
1065 // Disable sync rollback.
1066 const char kSyncDisableRollback
[] = "disable-sync-rollback";
1068 // Passes the name of the current running automated test to Chrome.
1069 const char kTestName
[] = "test-name";
1071 #ifdef ENABLE_TOPCHROME_MD
1072 const char kTopChromeMD
[] = "topchrome-md";
1073 const char kTopChromeMDEnabled
[] = "enable-topchrome-md";
1074 const char kTopChromeMDDisabled
[] = "disable-topchrome-md";
1077 // Disables same-origin check on HTTP resources pushed via a SPDY proxy.
1078 // The value is the host:port of the trusted proxy.
1079 const char kTrustedSpdyProxy
[] = "trusted-spdy-proxy";
1081 // Experimental. Shows a dialog asking the user to try chrome. This flag is to
1082 // be used only by the upgrade process.
1083 const char kTryChromeAgain
[] = "try-chrome-again";
1085 // Overrides per-origin quota settings to unlimited storage for any
1086 // apps/origins. This should be used only for testing purpose.
1087 const char kUnlimitedStorage
[] = "unlimited-storage";
1089 // Treat given (insecure) origins as secure origins. Multiple origins can be
1090 // supplied. Has no effect unless --user-data-dir is also supplied.
1092 // --unsafely-treat-insecure-origin-as-secure=http://a.test,http://b.test
1093 // --user-data-dir=/test/only/profile/dir
1094 const char kUnsafelyTreatInsecureOriginAsSecure
[] =
1095 "unsafely-treat-insecure-origin-as-secure";
1097 // Uses Spdy for the transport protocol instead of HTTP. This is a temporary
1099 const char kUseSpdy
[] = "use-spdy";
1101 // A string used to override the default user agent with a custom one.
1102 const char kUserAgent
[] = "user-agent";
1104 // Specifies the user data directory, which is where the browser will look for
1105 // all of its state.
1106 const char kUserDataDir
[] = "user-data-dir";
1108 // Examines a .crx for validity and prints the result.
1109 const char kValidateCrx
[] = "validate-crx";
1111 // Uses experimental simple cache backend if possible.
1112 const char kUseSimpleCacheBackend
[] = "use-simple-cache-backend";
1114 // Enables using an in-process Mojo service for the v8 proxy resolver.
1115 const char kV8PacMojoInProcess
[] = "v8-pac-mojo-in-process";
1117 // Enables using an out-of-process Mojo service for the v8 proxy resolver.
1118 const char kV8PacMojoOutOfProcess
[] = "v8-pac-mojo-out-of-process";
1120 // Specifies a custom URL for the server which reports variation data to the
1121 // client. Specifying this switch enables the Variations service on
1122 // unofficial builds. See variations_service.cc.
1123 const char kVariationsServerURL
[] = "variations-server-url";
1125 // Prints version information and quits.
1126 const char kVersion
[] = "version";
1128 // Specify the initial window position: --window-position=x,y
1129 const char kWindowPosition
[] = "window-position";
1131 // Specify the initial window size: --window-size=w,h
1132 const char kWindowSize
[] = "window-size";
1134 // Uses WinHTTP to fetch and evaluate PAC scripts. Otherwise the default is to
1135 // use Chromium's network stack to fetch, and V8 to evaluate.
1136 const char kWinHttpProxyResolver
[] = "winhttp-proxy-resolver";
1138 // Specifies which category option was clicked in the Windows Jumplist that
1139 // resulted in a browser startup.
1140 const char kWinJumplistAction
[] = "win-jumplist-action";
1142 #if defined(OS_ANDROID)
1143 // Disables support for playing videos on Chromecast devices.
1144 const char kDisableCast
[] = "disable-cast";
1146 // Disables Contextual Search.
1147 const char kDisableContextualSearch
[] = "disable-contextual-search";
1149 // Disables zero suggest experiment on Dev channel.
1150 const char kDisableZeroSuggest
[] = "disable-zero-suggest";
1152 // Enable the accessibility tab switcher.
1153 const char kEnableAccessibilityTabSwitcher
[] =
1154 "enable-accessibility-tab-switcher";
1156 // Enables Contextual Search.
1157 const char kEnableContextualSearch
[] = "enable-contextual-search";
1159 // Enables the DOM distiller animated button UI for Android.
1160 const char kEnableDomDistillerButtonAnimation
[] =
1161 "enable-dom-distiller-button-animation";
1163 // Enables chrome hosted mode for Android.
1164 const char kEnableHostedMode
[] = "enable-hosted-mode";
1166 // Enables instant search clicks feature.
1167 const char kEnableInstantSearchClicks
[] = "enable-instant-search-clicks";
1169 // Enables context-sensitive reader mode button in the toolbar.
1170 const char kEnableReaderModeToolbarIcon
[] =
1171 "enable-reader-mode-toolbar-icon";
1173 // Enables zero suggest functionality on Dev channel, showing most visited
1174 // sites as default suggestions.
1175 const char kEnableZeroSuggestMostVisited
[] =
1176 "enable-zero-suggest-most-visited";
1178 // Enable zero suggest functionality on Dev channel, showing most visited
1179 // sites on non-search-result pages as default suggestions.
1180 const char kEnableZeroSuggestMostVisitedWithoutSerp
[] =
1181 "enable-zero-suggest-most-visited-without-serp";
1183 // Triggers prerendering of search base page to prefetch results for the typed
1184 // omnibox query. Only has an effect when prerender is enabled.
1185 const char kPrefetchSearchResults
[] = "prefetch-search-results";
1186 #endif // defined(OS_ANDROID)
1188 #if defined(USE_ASH)
1189 const char kOpenAsh
[] = "open-ash";
1192 #if defined(OS_POSIX) && !defined(OS_MACOSX) && !defined(OS_CHROMEOS)
1193 // These flags show the man page on Linux. They are equivalent to each
1195 const char kHelp
[] = "help";
1196 const char kHelpShort
[] = "h";
1198 // Specifies which password store to use (detect, default, gnome, kwallet).
1199 const char kPasswordStore
[] = "password-store";
1202 #if defined(OS_LINUX) && !defined(OS_CHROMEOS)
1203 // Triggers migration of user data directory to another directory
1204 // specified as a parameter. The migration is done under singleton lock,
1205 // and sanity checks are made to avoid corrupting the profile.
1206 // The browser exits after migration is complete.
1207 const char kMigrateDataDirForSxS
[] = "migrate-data-dir-for-sxs";
1208 #endif // defined(OS_LINUX) && !defined(OS_CHROMEOS)
1210 #if defined(OS_MACOSX)
1211 // Prevents Chrome from quitting when Chrome Apps are open.
1212 const char kAppsKeepChromeAliveInTests
[] = "apps-keep-chrome-alive-in-tests";
1214 // Shows a notification when quitting Chrome with hosted apps running. Default
1215 // behavior is to also quit all hosted apps.
1216 const char kHostedAppQuitNotification
[] = "enable-hosted-app-quit-notification";
1218 // Disable the toolkit-views App Info dialog for Mac.
1219 const char kDisableAppInfoDialogMac
[] = "disable-app-info-dialog-mac";
1221 // Disables app shim creation for hosted apps on Mac.
1222 const char kDisableHostedAppShimCreation
[] = "disable-hosted-app-shim-creation";
1224 // Disables use of toolkit-views based native app windows.
1225 const char kDisableMacViewsNativeAppWindows
[] =
1226 "disable-mac-views-native-app-windows";
1228 // Forcibly disables Lion-style on newer OSes, to allow developers to test the
1229 // older, SnowLeopard-style fullscreen.
1230 const char kDisableSystemFullscreenForTesting
[] =
1231 "disable-system-fullscreen-for-testing";
1233 // Enable the toolkit-views App Info dialog for Mac. This is accessible from
1234 // chrome://apps and chrome://extensions and is already enabled on non-mac.
1235 const char kEnableAppInfoDialogMac
[] = "enable-app-info-dialog-mac";
1237 // Enables use of toolkit-views based native app windows.
1238 const char kEnableMacViewsNativeAppWindows
[] =
1239 "enable-mac-views-native-app-windows";
1241 // Enables Translate experimental new UX which replaces the infobar.
1242 const char kEnableTranslateNewUX
[] = "enable-translate-new-ux";
1244 // This is how the metrics client ID is passed from the browser process to its
1245 // children. With Crashpad, the metrics client ID is distinct from the crash
1247 const char kMetricsClientID
[] = "metrics-client-id";
1249 // A process type (switches::kProcessType) that relaunches the browser. See
1250 // chrome/browser/mac/relauncher.h.
1251 const char kRelauncherProcess
[] = "relauncher";
1252 #endif // defined(OS_MACOSX)
1254 // Use bubbles for content permissions requests instead of infobars.
1255 const char kEnablePermissionsBubbles
[] = "enable-permissions-bubbles";
1258 // Fallback to XPS. By default connector uses CDD.
1259 const char kEnableCloudPrintXps
[] = "enable-cloud-print-xps";
1261 // Force-enables the profile shortcut manager. This is needed for tests since
1262 // they use a custom-user-data-dir which disables this.
1263 const char kEnableProfileShortcutManager
[] = "enable-profile-shortcut-manager";
1265 // For the DelegateExecute verb handler to launch Chrome in metro mode on
1266 // Windows 8 and higher. Used when relaunching metro Chrome.
1267 const char kForceImmersive
[] = "force-immersive";
1269 // Whether or not the browser should warn if the profile is on a network share.
1270 // This flag is only relevant for Windows currently.
1271 const char kNoNetworkProfileWarning
[] = "no-network-profile-warning";
1273 // For the DelegateExecute verb handler to launch Chrome in desktop mode on
1274 // Windows 8 and higher. Used when relaunching metro Chrome.
1275 const char kForceDesktop
[] = "force-desktop";
1277 // Makes Windows happy by allowing it to show "Enable access to this program"
1278 // checkbox in Add/Remove Programs->Set Program Access and Defaults. This only
1279 // shows an error box because the only way to hide Chrome is by uninstalling
1281 const char kHideIcons
[] = "hide-icons";
1283 // Relaunches metro Chrome on Windows 8 and higher using a given shortcut.
1284 const char kRelaunchShortcut
[] = "relaunch-shortcut";
1287 const char kShowIcons
[] = "show-icons";
1289 // Runs un-installation steps that were done by chrome first-run.
1290 const char kUninstall
[] = "uninstall";
1292 // Requests that Chrome launch the Metro viewer process via the given appid
1293 // (which is assumed to be registered as default browser) and synchronously
1295 const char kViewerLaunchViaAppId
[] = "viewer-launch-via-appid";
1297 // Waits for the given handle to be signaled before relaunching metro Chrome on
1298 // Windows 8 and higher.
1299 const char kWaitForMutex
[] = "wait-for-mutex";
1301 // Indicates that chrome was launched to service a search request in Windows 8.
1302 const char kWindows8Search
[] = "windows8-search";
1303 #endif // defined(OS_WIN)
1305 #if defined(ENABLE_IPC_FUZZER)
1306 // Specifies the testcase used by the IPC fuzzer.
1307 const char kIpcFuzzerTestcase
[] = "ipc-fuzzer-testcase";
1310 #if defined(ENABLE_PRINT_PREVIEW) && !defined(OFFICIAL_BUILD)
1311 // Enables support to debug printing subsystem.
1312 const char kDebugPrint
[] = "debug-print";
1315 bool AboutInSettingsEnabled() {
1316 return SettingsWindowEnabled() &&
1317 !base::CommandLine::ForCurrentProcess()->HasSwitch(
1318 ::switches::kDisableAboutInSettings
);
1321 bool MdSettingsEnabled() {
1322 return base::CommandLine::ForCurrentProcess()->HasSwitch(
1323 ::switches::kEnableMaterialDesignSettings
);
1326 bool MediaRouterEnabled() {
1327 return base::CommandLine::ForCurrentProcess()->HasSwitch(
1328 ::switches::kEnableMediaRouter
);
1331 // Will return true as a default value if the "disable-new-offline-error-page"
1332 // command-line switch is not available.
1333 bool NewOfflineErrorPageEnabled() {
1334 return !base::CommandLine::ForCurrentProcess()->HasSwitch(
1335 ::switches::kDisableNewOfflineErrorPage
);
1338 bool PdfMaterialUIEnabled() {
1339 if (base::CommandLine::ForCurrentProcess()->HasSwitch(kEnablePdfMaterialUI
))
1342 if (base::CommandLine::ForCurrentProcess()->HasSwitch(kDisablePdfMaterialUI
))
1349 bool SettingsWindowEnabled() {
1350 #if defined(OS_CHROMEOS)
1351 return !base::CommandLine::ForCurrentProcess()->HasSwitch(
1352 ::switches::kDisableSettingsWindow
);
1354 return base::CommandLine::ForCurrentProcess()->HasSwitch(
1355 ::switches::kEnableSettingsWindow
);
1359 #if defined(OS_CHROMEOS)
1360 bool PowerOverlayEnabled() {
1361 return base::CommandLine::ForCurrentProcess()->HasSwitch(
1362 ::switches::kEnablePowerOverlay
);
1366 // -----------------------------------------------------------------------------
1367 // DO NOT ADD YOUR CRAP TO THE BOTTOM OF THIS FILE.
1369 // You were going to just dump your switches here, weren't you? Instead, please
1370 // put them in alphabetical order above, or in order inside the appropriate
1371 // ifdef at the bottom. The order should match the header.
1372 // -----------------------------------------------------------------------------
1374 } // namespace switches