c5a72e9887
* feat: Set which browser to launch via PUPPETEER_PRODUCT This change introduces a PUPPETEER_PRODUCT environment variable as a first step toward using Puppeteer with many different browsers. Setting PUPPETEER_PRODUCT=firefox, for example, enables Firefox-specific Launcher settings. The state is also exposed as `puppeteer.product` in the API to support adding other product-specific behaviour as needed. The bulk of the change is a refactoring in Launcher to decouple generic browser start-up from product-specific configuration. Respecting the puppeteer-core restriction for PUPPETEER_ environment variables, lazily instantiate the Launcher based on a `product` Puppeteer.launch option, if available. * test: Distinguish Juggler unit tests from Firefox The funit script is renamed to fjunit (j for Juggler, which is used only by the experimental puppeteer-firefox package. In contrast, the funit script now refers to running Puppeteer unit tests against the main puppeteer package with Firefox. To do so with Firefox Nightly, run: `BINARY=path/to/firefox npm run funit` A number of changes in this patch make it easier to run Puppeteer unit tests in Mozilla's CI.
136 lines
4.6 KiB
JavaScript
136 lines
4.6 KiB
JavaScript
/**
|
|
* Copyright 2017 Google Inc. All rights reserved.
|
|
*
|
|
* Licensed under the Apache License, Version 2.0 (the "License");
|
|
* you may not use this file except in compliance with the License.
|
|
* You may obtain a copy of the License at
|
|
*
|
|
* http://www.apache.org/licenses/LICENSE-2.0
|
|
*
|
|
* Unless required by applicable law or agreed to in writing, software
|
|
* distributed under the License is distributed on an "AS IS" BASIS,
|
|
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
* See the License for the specific language governing permissions and
|
|
* limitations under the License.
|
|
*/
|
|
const path = require('path');
|
|
const {TestServer} = require('../utils/testserver/');
|
|
const {TestRunner, Reporter} = require('../utils/testrunner/');
|
|
const utils = require('./utils');
|
|
|
|
let parallel = 1;
|
|
if (process.env.PPTR_PARALLEL_TESTS)
|
|
parallel = parseInt(process.env.PPTR_PARALLEL_TESTS.trim(), 10);
|
|
const parallelArgIndex = process.argv.indexOf('-j');
|
|
if (parallelArgIndex !== -1)
|
|
parallel = parseInt(process.argv[parallelArgIndex + 1], 10);
|
|
require('events').defaultMaxListeners *= parallel;
|
|
|
|
// Timeout to 20 seconds on Appveyor instances.
|
|
let timeout = process.env.APPVEYOR ? 20 * 1000 : 10 * 1000;
|
|
if (!isNaN(process.env.TIMEOUT))
|
|
timeout = parseInt(process.env.TIMEOUT, 10);
|
|
const testRunner = new TestRunner({
|
|
timeout,
|
|
parallel,
|
|
breakOnFailure: process.argv.indexOf('--break-on-failure') !== -1,
|
|
});
|
|
const {describe, fdescribe, beforeAll, afterAll, beforeEach, afterEach} = testRunner;
|
|
|
|
console.log('Testing on Node', process.version);
|
|
|
|
beforeAll(async state => {
|
|
const assetsPath = path.join(__dirname, 'assets');
|
|
const cachedPath = path.join(__dirname, 'assets', 'cached');
|
|
|
|
const port = 8907 + state.parallelIndex * 2;
|
|
state.server = await TestServer.create(assetsPath, port);
|
|
state.server.enableHTTPCache(cachedPath);
|
|
state.server.PORT = port;
|
|
state.server.PREFIX = `http://localhost:${port}`;
|
|
state.server.CROSS_PROCESS_PREFIX = `http://127.0.0.1:${port}`;
|
|
state.server.EMPTY_PAGE = `http://localhost:${port}/empty.html`;
|
|
|
|
const httpsPort = port + 1;
|
|
state.httpsServer = await TestServer.createHTTPS(assetsPath, httpsPort);
|
|
state.httpsServer.enableHTTPCache(cachedPath);
|
|
state.httpsServer.PORT = httpsPort;
|
|
state.httpsServer.PREFIX = `https://localhost:${httpsPort}`;
|
|
state.httpsServer.CROSS_PROCESS_PREFIX = `https://127.0.0.1:${httpsPort}`;
|
|
state.httpsServer.EMPTY_PAGE = `https://localhost:${httpsPort}/empty.html`;
|
|
});
|
|
|
|
afterAll(async({server, httpsServer}) => {
|
|
await Promise.all([
|
|
server.stop(),
|
|
httpsServer.stop(),
|
|
]);
|
|
});
|
|
|
|
beforeEach(async({server, httpsServer}) => {
|
|
server.reset();
|
|
httpsServer.reset();
|
|
});
|
|
|
|
const CHROMIUM_NO_COVERAGE = new Set([
|
|
'page.emulateMedia', // Legacy alias for `page.emulateMediaType`.
|
|
]);
|
|
|
|
switch (process.env.PUPPETEER_PRODUCT) {
|
|
case 'firefox':
|
|
testRunner.addTestDSL('it_fails_ffox', 'skip');
|
|
testRunner.addSuiteDSL('describe_fails_ffox', 'skip');
|
|
describe('Firefox', () => {
|
|
require('./puppeteer.spec.js').addTests({
|
|
product: 'Firefox',
|
|
puppeteerPath: utils.projectRoot(),
|
|
testRunner,
|
|
});
|
|
if (process.env.COVERAGE)
|
|
utils.recordAPICoverage(testRunner, require('../lib/api'), require('../lib/Events').Events, CHROMIUM_NO_COVERAGE);
|
|
});
|
|
break;
|
|
case 'juggler':
|
|
testRunner.addTestDSL('it_fails_ffox', 'skip');
|
|
testRunner.addSuiteDSL('describe_fails_ffox', 'skip');
|
|
describe('Firefox (Juggler)', () => {
|
|
require('./puppeteer.spec.js').addTests({
|
|
product: 'Juggler',
|
|
puppeteerPath: path.resolve(__dirname, '../experimental/puppeteer-firefox/'),
|
|
testRunner,
|
|
});
|
|
});
|
|
break;
|
|
case 'chrome':
|
|
default:
|
|
testRunner.addTestDSL('it_fails_ffox', 'run');
|
|
testRunner.addSuiteDSL('describe_fails_ffox', 'run');
|
|
describe('Chromium', () => {
|
|
require('./puppeteer.spec.js').addTests({
|
|
product: 'Chromium',
|
|
puppeteerPath: utils.projectRoot(),
|
|
testRunner,
|
|
});
|
|
if (process.env.COVERAGE)
|
|
utils.recordAPICoverage(testRunner, require('../lib/api'), require('../lib/Events').Events, CHROMIUM_NO_COVERAGE);
|
|
});
|
|
}
|
|
|
|
if (process.env.CI && testRunner.hasFocusedTestsOrSuites()) {
|
|
console.error('ERROR: "focused" tests/suites are prohibitted on bots. Remove any "fit"/"fdescribe" declarations.');
|
|
process.exit(1);
|
|
}
|
|
|
|
new Reporter(testRunner, {
|
|
verbose: process.argv.includes('--verbose'),
|
|
summary: !process.argv.includes('--verbose'),
|
|
projectFolder: utils.projectRoot(),
|
|
showSlowTests: process.env.CI ? 5 : 0,
|
|
});
|
|
|
|
(async() => {
|
|
await utils.initializeFlakinessDashboardIfNeeded(testRunner);
|
|
testRunner.run();
|
|
})();
|
|
|