/** * Copyright (c) Microsoft Corporation. * * 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. */ import path from 'path'; import net from 'net'; import { colors, debug } from 'playwright-core/lib/utilsBundle'; import { raceAgainstDeadline, launchProcess, httpRequest, monotonicTime } from 'playwright-core/lib/utils'; import type { FullConfig } from '../../types/testReporter'; import type { TestRunnerPlugin } from '.'; import type { FullConfigInternal } from '../common/config'; import type { ReporterV2 } from '../reporters/reporterV2'; export type WebServerPluginOptions = { command: string; url?: string; ignoreHTTPSErrors?: boolean; timeout?: number; reuseExistingServer?: boolean; cwd?: string; env?: { [key: string]: string; }; stdout?: 'pipe' | 'ignore'; stderr?: 'pipe' | 'ignore'; }; const DEFAULT_ENVIRONMENT_VARIABLES = { 'BROWSER': 'none', // Disable that create-react-app will open the page in the browser 'FORCE_COLOR': '1', 'DEBUG_COLORS': '1', }; const debugWebServer = debug('pw:webserver'); export class WebServerPlugin implements TestRunnerPlugin { private _isAvailableCallback?: () => Promise; private _killProcess?: () => Promise; private _processExitedPromise!: Promise; private _options: WebServerPluginOptions; private _checkPortOnly: boolean; private _reporter?: ReporterV2; name = 'playwright:webserver'; constructor(options: WebServerPluginOptions, checkPortOnly: boolean) { this._options = options; this._checkPortOnly = checkPortOnly; } public async setup(config: FullConfig, configDir: string, reporter: ReporterV2) { this._reporter = reporter; this._isAvailableCallback = this._options.url ? getIsAvailableFunction(this._options.url, this._checkPortOnly, !!this._options.ignoreHTTPSErrors, this._reporter.onStdErr?.bind(this._reporter)) : undefined; this._options.cwd = this._options.cwd ? path.resolve(configDir, this._options.cwd) : configDir; try { await this._startProcess(); await this._waitForProcess(); } catch (error) { await this.teardown(); throw error; } } public async teardown() { await this._killProcess?.(); } private async _startProcess(): Promise { let processExitedReject = (error: Error) => { }; this._processExitedPromise = new Promise((_, reject) => processExitedReject = reject); const isAlreadyAvailable = await this._isAvailableCallback?.(); if (isAlreadyAvailable) { debugWebServer(`WebServer is already available`); if (this._options.reuseExistingServer) return; const port = new URL(this._options.url!).port; throw new Error(`${this._options.url ?? `http://localhost${port ? ':' + port : ''}`} is already used, make sure that nothing is running on the port/url or set reuseExistingServer:true in config.webServer.`); } debugWebServer(`Starting WebServer process ${this._options.command}...`); const { launchedProcess, kill } = await launchProcess({ command: this._options.command, env: { ...DEFAULT_ENVIRONMENT_VARIABLES, ...process.env, ...this._options.env, }, cwd: this._options.cwd, stdio: 'stdin', shell: true, // Reject to indicate that we cannot close the web server gracefully // and should fallback to non-graceful shutdown. attemptToGracefullyClose: () => Promise.reject(), log: () => {}, onExit: code => processExitedReject(new Error(code ? `Process from config.webServer was not able to start. Exit code: ${code}` : 'Process from config.webServer exited early.')), tempDirectories: [], }); this._killProcess = kill; debugWebServer(`Process started`); launchedProcess.stderr!.on('data', line => { if (debugWebServer.enabled || (this._options.stderr === 'pipe' || !this._options.stderr)) this._reporter!.onStdErr?.(colors.dim('[WebServer] ') + line.toString()); }); launchedProcess.stdout!.on('data', line => { if (debugWebServer.enabled || this._options.stdout === 'pipe') this._reporter!.onStdOut?.(colors.dim('[WebServer] ') + line.toString()); }); } private async _waitForProcess() { if (!this._isAvailableCallback) { this._processExitedPromise.catch(() => {}); return; } debugWebServer(`Waiting for availability...`); const launchTimeout = this._options.timeout || 60 * 1000; const cancellationToken = { canceled: false }; const { timedOut } = (await Promise.race([ raceAgainstDeadline(() => waitFor(this._isAvailableCallback!, cancellationToken), monotonicTime() + launchTimeout), this._processExitedPromise, ])); cancellationToken.canceled = true; if (timedOut) throw new Error(`Timed out waiting ${launchTimeout}ms from config.webServer.`); debugWebServer(`WebServer available`); } } async function isPortUsed(port: number): Promise { const innerIsPortUsed = (host: string) => new Promise(resolve => { const conn = net .connect(port, host) .on('error', () => { resolve(false); }) .on('connect', () => { conn.end(); resolve(true); }); }); return await innerIsPortUsed('127.0.0.1') || await innerIsPortUsed('::1'); } async function isURLAvailable(url: URL, ignoreHTTPSErrors: boolean, onStdErr: ReporterV2['onStdErr']) { let statusCode = await httpStatusCode(url, ignoreHTTPSErrors, onStdErr); if (statusCode === 404 && url.pathname === '/') { const indexUrl = new URL(url); indexUrl.pathname = '/index.html'; statusCode = await httpStatusCode(indexUrl, ignoreHTTPSErrors, onStdErr); } return statusCode >= 200 && statusCode < 404; } async function httpStatusCode(url: URL, ignoreHTTPSErrors: boolean, onStdErr: ReporterV2['onStdErr']): Promise { return new Promise(resolve => { debugWebServer(`HTTP GET: ${url}`); httpRequest({ url: url.toString(), headers: { Accept: '*/*' }, rejectUnauthorized: !ignoreHTTPSErrors }, res => { res.resume(); const statusCode = res.statusCode ?? 0; debugWebServer(`HTTP Status: ${statusCode}`); resolve(statusCode); }, error => { if ((error as NodeJS.ErrnoException).code === 'DEPTH_ZERO_SELF_SIGNED_CERT') onStdErr?.(`[WebServer] Self-signed certificate detected. Try adding ignoreHTTPSErrors: true to config.webServer.`); debugWebServer(`Error while checking if ${url} is available: ${error.message}`); resolve(0); }); }); } async function waitFor(waitFn: () => Promise, cancellationToken: { canceled: boolean }) { const logScale = [100, 250, 500]; while (!cancellationToken.canceled) { const connected = await waitFn(); if (connected) return; const delay = logScale.shift() || 1000; debugWebServer(`Waiting ${delay}ms`); await new Promise(x => setTimeout(x, delay)); } } function getIsAvailableFunction(url: string, checkPortOnly: boolean, ignoreHTTPSErrors: boolean, onStdErr: ReporterV2['onStdErr']) { const urlObject = new URL(url); if (!checkPortOnly) return () => isURLAvailable(urlObject, ignoreHTTPSErrors, onStdErr); const port = urlObject.port; return () => isPortUsed(+port); } export const webServer = (options: WebServerPluginOptions): TestRunnerPlugin => { return new WebServerPlugin(options, false); }; export const webServerPluginsForConfig = (config: FullConfigInternal): TestRunnerPlugin[] => { const shouldSetBaseUrl = !!config.config.webServer; const webServerPlugins = []; for (const webServerConfig of config.webServers) { if (webServerConfig.port && webServerConfig.url) throw new Error(`Either 'port' or 'url' should be specified in config.webServer.`); let url: string | undefined; if (webServerConfig.port || webServerConfig.url) { url = webServerConfig.url || `http://localhost:${webServerConfig.port}`; // We only set base url when only the port is given. That's a legacy mode we have regrets about. if (shouldSetBaseUrl && !webServerConfig.url) process.env.PLAYWRIGHT_TEST_BASE_URL = url; } webServerPlugins.push(new WebServerPlugin({ ...webServerConfig, url }, webServerConfig.port !== undefined)); } return webServerPlugins; };