/** * Copyright 2017 Google Inc. All rights reserved. * Modifications 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 * as childProcess from 'child_process'; import * as readline from 'readline'; import * as removeFolder from 'rimraf'; import * as stream from 'stream'; import { helper } from './helper'; import { Progress } from './progress'; import * as types from './types'; import { isUnderTest } from '../utils/utils'; export type Env = {[key: string]: string | number | boolean | undefined}; export type LaunchProcessOptions = { executablePath: string, args: string[], env?: Env, handleSIGINT?: boolean, handleSIGTERM?: boolean, handleSIGHUP?: boolean, pipe?: boolean, pipeStdin?: boolean, tempDirectories: string[], cwd?: string, // Note: attemptToGracefullyClose should reject if it does not close the browser. attemptToGracefullyClose: () => Promise, onExit: (exitCode: number | null, signal: string | null) => void, progress: Progress, }; type LaunchResult = { launchedProcess: childProcess.ChildProcess, gracefullyClose: () => Promise, kill: () => Promise, }; const gracefullyCloseSet = new Set<() => Promise>(); export async function gracefullyCloseAll() { await Promise.all(Array.from(gracefullyCloseSet).map(gracefullyClose => gracefullyClose().catch(e => {}))); } // We currently spawn a process per page when recording video in Chromium. // This triggers "too many listeners" on the process object once you have more than 10 pages open. const maxListeners = process.getMaxListeners(); if (maxListeners !== 0) process.setMaxListeners(Math.max(maxListeners || 0, 100)); export async function launchProcess(options: LaunchProcessOptions): Promise { const cleanup = () => helper.removeFolders(options.tempDirectories); const progress = options.progress; const stdio: ('ignore' | 'pipe')[] = options.pipe ? ['ignore', 'pipe', 'pipe', 'pipe', 'pipe'] : ['ignore', 'pipe', 'pipe']; if (options.pipeStdin) stdio[0] = 'pipe'; progress.log(` ${options.executablePath} ${options.args.join(' ')}`); const spawnedProcess = childProcess.spawn( options.executablePath, options.args, { // On non-windows platforms, `detached: true` makes child process a leader of a new // process group, making it possible to kill child process tree with `.kill(-pid)` command. // @see https://nodejs.org/api/child_process.html#child_process_options_detached detached: process.platform !== 'win32', env: (options.env as {[key: string]: string}), cwd: options.cwd, stdio, } ); // Prevent Unhandled 'error' event. spawnedProcess.on('error', () => {}); if (!spawnedProcess.pid) { let failed: (e: Error) => void; const failedPromise = new Promise((f, r) => failed = f); spawnedProcess.once('error', error => { failed(new Error('Failed to launch browser: ' + error)); }); return cleanup().then(() => failedPromise).then(e => Promise.reject(e)); } progress.log(` pid=${spawnedProcess.pid}`); const stdout = readline.createInterface({ input: spawnedProcess.stdout }); stdout.on('line', (data: string) => { progress.log('[out] ' + data); }); const stderr = readline.createInterface({ input: spawnedProcess.stderr }); stderr.on('line', (data: string) => { progress.log('[err] ' + data); }); let processClosed = false; let fulfillClose = () => {}; const waitForClose = new Promise(f => fulfillClose = f); let fulfillCleanup = () => {}; const waitForCleanup = new Promise(f => fulfillCleanup = f); spawnedProcess.once('exit', (exitCode, signal) => { progress.log(``); processClosed = true; helper.removeEventListeners(listeners); gracefullyCloseSet.delete(gracefullyClose); options.onExit(exitCode, signal); fulfillClose(); // Cleanup as process exits. cleanup().then(fulfillCleanup); }); const listeners = [ helper.addEventListener(process, 'exit', killProcess) ]; if (options.handleSIGINT) { listeners.push(helper.addEventListener(process, 'SIGINT', () => { gracefullyClose().then(() => { // Give tests a chance to dispatch any async calls. if (isUnderTest()) setTimeout(() => process.exit(130), 0); else process.exit(130); }); })); } if (options.handleSIGTERM) listeners.push(helper.addEventListener(process, 'SIGTERM', gracefullyClose)); if (options.handleSIGHUP) listeners.push(helper.addEventListener(process, 'SIGHUP', gracefullyClose)); gracefullyCloseSet.add(gracefullyClose); let gracefullyClosing = false; async function gracefullyClose(): Promise { gracefullyCloseSet.delete(gracefullyClose); // We keep listeners until we are done, to handle 'exit' and 'SIGINT' while // asynchronously closing to prevent zombie processes. This might introduce // reentrancy to this function, for example user sends SIGINT second time. // In this case, let's forcefully kill the process. if (gracefullyClosing) { progress.log(``); killProcess(); await waitForClose; // Ensure the process is dead and we called options.onkill. return; } gracefullyClosing = true; progress.log(``); await options.attemptToGracefullyClose().catch(() => killProcess()); await waitForCleanup; // Ensure the process is dead and we have cleaned up. progress.log(``); } // This method has to be sync to be used as 'exit' event handler. function killProcess() { progress.log(``); helper.removeEventListeners(listeners); if (spawnedProcess.pid && !spawnedProcess.killed && !processClosed) { // Force kill the browser. try { if (process.platform === 'win32') childProcess.execSync(`taskkill /pid ${spawnedProcess.pid} /T /F`); else process.kill(-spawnedProcess.pid, 'SIGKILL'); } catch (e) { // the process might have already stopped } } try { // Attempt to remove temporary directories to avoid littering. for (const dir of options.tempDirectories) removeFolder.sync(dir); } catch (e) { } } function killAndWait() { killProcess(); return waitForCleanup; } return { launchedProcess: spawnedProcess, gracefullyClose, kill: killAndWait }; } export function waitForLine(progress: Progress, process: childProcess.ChildProcess, inputStream: stream.Readable, regex: RegExp): Promise { return new Promise((resolve, reject) => { const rl = readline.createInterface({ input: inputStream }); const failError = new Error('Process failed to launch!'); const listeners = [ helper.addEventListener(rl, 'line', onLine), helper.addEventListener(rl, 'close', reject.bind(null, failError)), helper.addEventListener(process, 'exit', reject.bind(null, failError)), // It is Ok to remove error handler because we did not create process and there is another listener. helper.addEventListener(process, 'error', reject.bind(null, failError)) ]; progress.cleanupWhenAborted(cleanup); function onLine(line: string) { const match = line.match(regex); if (!match) return; cleanup(); resolve(match); } function cleanup() { helper.removeEventListeners(listeners); } }); } export function envArrayToObject(env: types.EnvArray): Env { const result: Env = {}; for (const { name, value } of env) result[name] = value; return result; }