123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337 |
- /**
- * @license
- * Copyright 2023 Google Inc.
- * SPDX-License-Identifier: Apache-2.0
- */
- import fs from 'fs';
- import path from 'path';
- import { getJSON } from '../httpUtil.js';
- import { BrowserPlatform } from './types.js';
- function archiveNightly(platform, buildId) {
- switch (platform) {
- case BrowserPlatform.LINUX:
- return `firefox-${buildId}.en-US.${platform}-x86_64.tar.bz2`;
- case BrowserPlatform.MAC_ARM:
- case BrowserPlatform.MAC:
- return `firefox-${buildId}.en-US.mac.dmg`;
- case BrowserPlatform.WIN32:
- case BrowserPlatform.WIN64:
- return `firefox-${buildId}.en-US.${platform}.zip`;
- }
- }
- function archive(platform, buildId) {
- switch (platform) {
- case BrowserPlatform.LINUX:
- return `firefox-${buildId}.tar.bz2`;
- case BrowserPlatform.MAC_ARM:
- case BrowserPlatform.MAC:
- return `Firefox ${buildId}.dmg`;
- case BrowserPlatform.WIN32:
- case BrowserPlatform.WIN64:
- return `Firefox Setup ${buildId}.exe`;
- }
- }
- function platformName(platform) {
- switch (platform) {
- case BrowserPlatform.LINUX:
- return `linux-x86_64`;
- case BrowserPlatform.MAC_ARM:
- case BrowserPlatform.MAC:
- return `mac`;
- case BrowserPlatform.WIN32:
- case BrowserPlatform.WIN64:
- return platform;
- }
- }
- function parseBuildId(buildId) {
- for (const value of Object.values(FirefoxChannel)) {
- if (buildId.startsWith(value + '_')) {
- buildId = buildId.substring(value.length + 1);
- return [value, buildId];
- }
- }
- // Older versions do not have channel as the prefix.«
- return [FirefoxChannel.NIGHTLY, buildId];
- }
- export function resolveDownloadUrl(platform, buildId, baseUrl) {
- const [channel, resolvedBuildId] = parseBuildId(buildId);
- switch (channel) {
- case FirefoxChannel.NIGHTLY:
- baseUrl ??=
- 'https://archive.mozilla.org/pub/firefox/nightly/latest-mozilla-central';
- break;
- case FirefoxChannel.DEVEDITION:
- baseUrl ??= 'https://archive.mozilla.org/pub/devedition/releases';
- break;
- case FirefoxChannel.BETA:
- case FirefoxChannel.STABLE:
- case FirefoxChannel.ESR:
- baseUrl ??= 'https://archive.mozilla.org/pub/firefox/releases';
- break;
- }
- switch (channel) {
- case FirefoxChannel.NIGHTLY:
- return `${baseUrl}/${resolveDownloadPath(platform, resolvedBuildId).join('/')}`;
- case FirefoxChannel.DEVEDITION:
- case FirefoxChannel.BETA:
- case FirefoxChannel.STABLE:
- case FirefoxChannel.ESR:
- return `${baseUrl}/${resolvedBuildId}/${platformName(platform)}/en-US/${archive(platform, resolvedBuildId)}`;
- }
- }
- export function resolveDownloadPath(platform, buildId) {
- return [archiveNightly(platform, buildId)];
- }
- export function relativeExecutablePath(platform, buildId) {
- const [channel] = parseBuildId(buildId);
- switch (channel) {
- case FirefoxChannel.NIGHTLY:
- switch (platform) {
- case BrowserPlatform.MAC_ARM:
- case BrowserPlatform.MAC:
- return path.join('Firefox Nightly.app', 'Contents', 'MacOS', 'firefox');
- case BrowserPlatform.LINUX:
- return path.join('firefox', 'firefox');
- case BrowserPlatform.WIN32:
- case BrowserPlatform.WIN64:
- return path.join('firefox', 'firefox.exe');
- }
- case FirefoxChannel.BETA:
- case FirefoxChannel.DEVEDITION:
- case FirefoxChannel.ESR:
- case FirefoxChannel.STABLE:
- switch (platform) {
- case BrowserPlatform.MAC_ARM:
- case BrowserPlatform.MAC:
- return path.join('Firefox.app', 'Contents', 'MacOS', 'firefox');
- case BrowserPlatform.LINUX:
- return path.join('firefox', 'firefox');
- case BrowserPlatform.WIN32:
- case BrowserPlatform.WIN64:
- return path.join('core', 'firefox.exe');
- }
- }
- }
- export var FirefoxChannel;
- (function (FirefoxChannel) {
- FirefoxChannel["STABLE"] = "stable";
- FirefoxChannel["ESR"] = "esr";
- FirefoxChannel["DEVEDITION"] = "devedition";
- FirefoxChannel["BETA"] = "beta";
- FirefoxChannel["NIGHTLY"] = "nightly";
- })(FirefoxChannel || (FirefoxChannel = {}));
- export async function resolveBuildId(channel = FirefoxChannel.NIGHTLY) {
- const channelToVersionKey = {
- [FirefoxChannel.ESR]: 'FIREFOX_ESR',
- [FirefoxChannel.STABLE]: 'LATEST_FIREFOX_VERSION',
- [FirefoxChannel.DEVEDITION]: 'FIREFOX_DEVEDITION',
- [FirefoxChannel.BETA]: 'FIREFOX_DEVEDITION',
- [FirefoxChannel.NIGHTLY]: 'FIREFOX_NIGHTLY',
- };
- const versions = (await getJSON(new URL('https://product-details.mozilla.org/1.0/firefox_versions.json')));
- const version = versions[channelToVersionKey[channel]];
- if (!version) {
- throw new Error(`Channel ${channel} is not found.`);
- }
- return channel + '_' + version;
- }
- export async function createProfile(options) {
- if (!fs.existsSync(options.path)) {
- await fs.promises.mkdir(options.path, {
- recursive: true,
- });
- }
- await writePreferences({
- preferences: {
- ...defaultProfilePreferences(options.preferences),
- ...options.preferences,
- },
- path: options.path,
- });
- }
- function defaultProfilePreferences(extraPrefs) {
- const server = 'dummy.test';
- const defaultPrefs = {
- // Make sure Shield doesn't hit the network.
- 'app.normandy.api_url': '',
- // Disable Firefox old build background check
- 'app.update.checkInstallTime': false,
- // Disable automatically upgrading Firefox
- 'app.update.disabledForTesting': true,
- // Increase the APZ content response timeout to 1 minute
- 'apz.content_response_timeout': 60000,
- // Prevent various error message on the console
- // jest-puppeteer asserts that no error message is emitted by the console
- 'browser.contentblocking.features.standard': '-tp,tpPrivate,cookieBehavior0,-cm,-fp',
- // Enable the dump function: which sends messages to the system
- // console
- // https://bugzilla.mozilla.org/show_bug.cgi?id=1543115
- 'browser.dom.window.dump.enabled': true,
- // Disable topstories
- 'browser.newtabpage.activity-stream.feeds.system.topstories': false,
- // Always display a blank page
- 'browser.newtabpage.enabled': false,
- // Background thumbnails in particular cause grief: and disabling
- // thumbnails in general cannot hurt
- 'browser.pagethumbnails.capturing_disabled': true,
- // Disable safebrowsing components.
- 'browser.safebrowsing.blockedURIs.enabled': false,
- 'browser.safebrowsing.downloads.enabled': false,
- 'browser.safebrowsing.malware.enabled': false,
- 'browser.safebrowsing.phishing.enabled': false,
- // Disable updates to search engines.
- 'browser.search.update': false,
- // Do not restore the last open set of tabs if the browser has crashed
- 'browser.sessionstore.resume_from_crash': false,
- // Skip check for default browser on startup
- 'browser.shell.checkDefaultBrowser': false,
- // Disable newtabpage
- 'browser.startup.homepage': 'about:blank',
- // Do not redirect user when a milstone upgrade of Firefox is detected
- 'browser.startup.homepage_override.mstone': 'ignore',
- // Start with a blank page about:blank
- 'browser.startup.page': 0,
- // Do not allow background tabs to be zombified on Android: otherwise for
- // tests that open additional tabs: the test harness tab itself might get
- // unloaded
- 'browser.tabs.disableBackgroundZombification': false,
- // Do not warn when closing all other open tabs
- 'browser.tabs.warnOnCloseOtherTabs': false,
- // Do not warn when multiple tabs will be opened
- 'browser.tabs.warnOnOpen': false,
- // Do not automatically offer translations, as tests do not expect this.
- 'browser.translations.automaticallyPopup': false,
- // Disable the UI tour.
- 'browser.uitour.enabled': false,
- // Turn off search suggestions in the location bar so as not to trigger
- // network connections.
- 'browser.urlbar.suggest.searches': false,
- // Disable first run splash page on Windows 10
- 'browser.usedOnWindows10.introURL': '',
- // Do not warn on quitting Firefox
- 'browser.warnOnQuit': false,
- // Defensively disable data reporting systems
- 'datareporting.healthreport.documentServerURI': `http://${server}/dummy/healthreport/`,
- 'datareporting.healthreport.logging.consoleEnabled': false,
- 'datareporting.healthreport.service.enabled': false,
- 'datareporting.healthreport.service.firstRun': false,
- 'datareporting.healthreport.uploadEnabled': false,
- // Do not show datareporting policy notifications which can interfere with tests
- 'datareporting.policy.dataSubmissionEnabled': false,
- 'datareporting.policy.dataSubmissionPolicyBypassNotification': true,
- // DevTools JSONViewer sometimes fails to load dependencies with its require.js.
- // This doesn't affect Puppeteer but spams console (Bug 1424372)
- 'devtools.jsonview.enabled': false,
- // Disable popup-blocker
- 'dom.disable_open_during_load': false,
- // Enable the support for File object creation in the content process
- // Required for |Page.setFileInputFiles| protocol method.
- 'dom.file.createInChild': true,
- // Disable the ProcessHangMonitor
- 'dom.ipc.reportProcessHangs': false,
- // Disable slow script dialogues
- 'dom.max_chrome_script_run_time': 0,
- 'dom.max_script_run_time': 0,
- // Only load extensions from the application and user profile
- // AddonManager.SCOPE_PROFILE + AddonManager.SCOPE_APPLICATION
- 'extensions.autoDisableScopes': 0,
- 'extensions.enabledScopes': 5,
- // Disable metadata caching for installed add-ons by default
- 'extensions.getAddons.cache.enabled': false,
- // Disable installing any distribution extensions or add-ons.
- 'extensions.installDistroAddons': false,
- // Disabled screenshots extension
- 'extensions.screenshots.disabled': true,
- // Turn off extension updates so they do not bother tests
- 'extensions.update.enabled': false,
- // Turn off extension updates so they do not bother tests
- 'extensions.update.notifyUser': false,
- // Make sure opening about:addons will not hit the network
- 'extensions.webservice.discoverURL': `http://${server}/dummy/discoveryURL`,
- // Allow the application to have focus even it runs in the background
- 'focusmanager.testmode': true,
- // Disable useragent updates
- 'general.useragent.updates.enabled': false,
- // Always use network provider for geolocation tests so we bypass the
- // macOS dialog raised by the corelocation provider
- 'geo.provider.testing': true,
- // Do not scan Wifi
- 'geo.wifi.scan': false,
- // No hang monitor
- 'hangmonitor.timeout': 0,
- // Show chrome errors and warnings in the error console
- 'javascript.options.showInConsole': true,
- // Disable download and usage of OpenH264: and Widevine plugins
- 'media.gmp-manager.updateEnabled': false,
- // Disable the GFX sanity window
- 'media.sanity-test.disabled': true,
- // Disable experimental feature that is only available in Nightly
- 'network.cookie.sameSite.laxByDefault': false,
- // Do not prompt for temporary redirects
- 'network.http.prompt-temp-redirect': false,
- // Disable speculative connections so they are not reported as leaking
- // when they are hanging around
- 'network.http.speculative-parallel-limit': 0,
- // Do not automatically switch between offline and online
- 'network.manage-offline-status': false,
- // Make sure SNTP requests do not hit the network
- 'network.sntp.pools': server,
- // Disable Flash.
- 'plugin.state.flash': 0,
- 'privacy.trackingprotection.enabled': false,
- // Can be removed once Firefox 89 is no longer supported
- // https://bugzilla.mozilla.org/show_bug.cgi?id=1710839
- 'remote.enabled': true,
- // Don't do network connections for mitm priming
- 'security.certerrors.mitm.priming.enabled': false,
- // Local documents have access to all other local documents,
- // including directory listings
- 'security.fileuri.strict_origin_policy': false,
- // Do not wait for the notification button security delay
- 'security.notification_enable_delay': 0,
- // Ensure blocklist updates do not hit the network
- 'services.settings.server': `http://${server}/dummy/blocklist/`,
- // Do not automatically fill sign-in forms with known usernames and
- // passwords
- 'signon.autofillForms': false,
- // Disable password capture, so that tests that include forms are not
- // influenced by the presence of the persistent doorhanger notification
- 'signon.rememberSignons': false,
- // Disable first-run welcome page
- 'startup.homepage_welcome_url': 'about:blank',
- // Disable first-run welcome page
- 'startup.homepage_welcome_url.additional': '',
- // Disable browser animations (tabs, fullscreen, sliding alerts)
- 'toolkit.cosmeticAnimations.enabled': false,
- // Prevent starting into safe mode after application crashes
- 'toolkit.startup.max_resumed_crashes': -1,
- };
- return Object.assign(defaultPrefs, extraPrefs);
- }
- /**
- * Populates the user.js file with custom preferences as needed to allow
- * Firefox's CDP support to properly function. These preferences will be
- * automatically copied over to prefs.js during startup of Firefox. To be
- * able to restore the original values of preferences a backup of prefs.js
- * will be created.
- *
- * @param prefs - List of preferences to add.
- * @param profilePath - Firefox profile to write the preferences to.
- */
- async function writePreferences(options) {
- const lines = Object.entries(options.preferences).map(([key, value]) => {
- return `user_pref(${JSON.stringify(key)}, ${JSON.stringify(value)});`;
- });
- await fs.promises.writeFile(path.join(options.path, 'user.js'), lines.join('\n'));
- // Create a backup of the preferences file if it already exitsts.
- const prefsPath = path.join(options.path, 'prefs.js');
- if (fs.existsSync(prefsPath)) {
- const prefsBackupPath = path.join(options.path, 'prefs.js.puppeteer');
- await fs.promises.copyFile(prefsPath, prefsBackupPath);
- }
- }
- export function compareVersions(a, b) {
- // TODO: this is a not very reliable check.
- return parseInt(a.replace('.', ''), 16) - parseInt(b.replace('.', ''), 16);
- }
- //# sourceMappingURL=firefox.js.map
|