// Copyright 2013 The Flutter Authors. All rights reserved. // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. // @dart = 2.6 import 'dart:async'; import 'dart:io'; import 'package:pedantic/pedantic.dart'; import 'package:test_core/src/util/io.dart'; // ignore: implementation_imports import 'browser.dart'; import 'chrome_installer.dart'; import 'common.dart'; /// A class for running an instance of Chrome. /// /// Most of the communication with the browser is expected to happen via HTTP, /// so this exposes a bare-bones API. The browser starts as soon as the class is /// constructed, and is killed when [close] is called. /// /// Any errors starting or running the process are reported through [onExit]. class Chrome extends Browser { @override final name = 'Chrome'; @override final Future remoteDebuggerUrl; static String version; /// Starts a new instance of Chrome open to the given [url], which may be a /// [Uri] or a [String]. factory Chrome(Uri url, {bool debug = false}) { version = ChromeArgParser.instance.version; assert(version != null); var remoteDebuggerCompleter = Completer.sync(); return Chrome._(() async { final BrowserInstallation installation = await getOrInstallChrome( version, infoLog: isCirrus ? stdout : DevNull(), ); // A good source of various Chrome CLI options: // https://peter.sh/experiments/chromium-command-line-switches/ // // Things to try: // --font-render-hinting // --enable-font-antialiasing // --gpu-rasterization-msaa-sample-count // --disable-gpu // --disallow-non-exact-resource-reuse // --disable-font-subpixel-positioning final bool isChromeNoSandbox = Platform.environment['CHROME_NO_SANDBOX'] == 'true'; var dir = createTempDir(); var args = [ '--user-data-dir=$dir', url.toString(), if (!debug) '--headless', if (isChromeNoSandbox) '--no-sandbox', '--window-size=$kMaxScreenshotWidth,$kMaxScreenshotHeight', // When headless, this is the actual size of the viewport '--disable-extensions', '--disable-popup-blocking', // Indicates that the browser is in "browse without sign-in" (Guest session) mode. '--bwsi', '--no-first-run', '--no-default-browser-check', '--disable-default-apps', '--disable-translate', '--remote-debugging-port=$kDevtoolsPort', ]; final Process process = await Process.start(installation.executable, args); remoteDebuggerCompleter.complete( getRemoteDebuggerUrl(Uri.parse('http://localhost:${kDevtoolsPort}'))); unawaited(process.exitCode .then((_) => Directory(dir).deleteSync(recursive: true))); return process; }, remoteDebuggerCompleter.future); } Chrome._(Future startBrowser(), this.remoteDebuggerUrl) : super(startBrowser); }