#!/usr/bin/env node /** * 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. */ /* eslint-disable no-console */ "use strict"; var _fs = _interopRequireDefault(require("fs")); var _os = _interopRequireDefault(require("os")); var _path = _interopRequireDefault(require("path")); var _commander = _interopRequireDefault(require("commander")); var _driver = require("./driver"); var _traceViewer = require("../server/trace/viewer/traceViewer"); var playwright = _interopRequireWildcard(require("../..")); var _child_process = require("child_process"); var _registry = require("../utils/registry"); var _gridAgent = require("../grid/gridAgent"); var _gridServer = require("../grid/gridServer"); function _getRequireWildcardCache(nodeInterop) { if (typeof WeakMap !== "function") return null; var cacheBabelInterop = new WeakMap(); var cacheNodeInterop = new WeakMap(); return (_getRequireWildcardCache = function (nodeInterop) { return nodeInterop ? cacheNodeInterop : cacheBabelInterop; })(nodeInterop); } function _interopRequireWildcard(obj, nodeInterop) { if (!nodeInterop && obj && obj.__esModule) { return obj; } if (obj === null || typeof obj !== "object" && typeof obj !== "function") { return { default: obj }; } var cache = _getRequireWildcardCache(nodeInterop); if (cache && cache.has(obj)) { return cache.get(obj); } var newObj = {}; var hasPropertyDescriptor = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var key in obj) { if (key !== "default" && Object.prototype.hasOwnProperty.call(obj, key)) { var desc = hasPropertyDescriptor ? Object.getOwnPropertyDescriptor(obj, key) : null; if (desc && (desc.get || desc.set)) { Object.defineProperty(newObj, key, desc); } else { newObj[key] = obj[key]; } } } newObj.default = obj; if (cache) { cache.set(obj, newObj); } return newObj; } function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; } const packageJSON = require('../../package.json'); _commander.default.version('Version ' + packageJSON.version).name(process.env.PW_CLI_NAME || 'npx playwright'); commandWithOpenOptions('open [url]', 'open page in browser specified via -b, --browser', []).action(function (url, command) { open(command, url, language()).catch(logErrorAndExit); }).on('--help', function () { console.log(''); console.log('Examples:'); console.log(''); console.log(' $ open'); console.log(' $ open -b webkit https://example.com'); }); commandWithOpenOptions('codegen [url]', 'open page and generate code for user actions', [['-o, --output ', 'saves the generated script to a file'], ['--target ', `language to generate, one of javascript, test, python, python-async, csharp`, language()]]).action(function (url, command) { codegen(command, url, command.target, command.output).catch(logErrorAndExit); }).on('--help', function () { console.log(''); console.log('Examples:'); console.log(''); console.log(' $ codegen'); console.log(' $ codegen --target=python'); console.log(' $ codegen -b webkit https://example.com'); }); _commander.default.command('debug [args...]', { hidden: true }).description('run command in debug mode: disable timeout, open inspector').allowUnknownOption(true).action(function (app, args) { (0, _child_process.spawn)(app, args, { env: { ...process.env, PWDEBUG: '1' }, stdio: 'inherit' }); }).on('--help', function () { console.log(''); console.log('Examples:'); console.log(''); console.log(' $ debug node test.js'); console.log(' $ debug npm run test'); }); function suggestedBrowsersToInstall() { return _registry.registry.executables().filter(e => e.installType !== 'none' && e.type !== 'tool').map(e => e.name).join(', '); } function checkBrowsersToInstall(args) { const faultyArguments = []; const executables = []; for (const arg of args) { const executable = _registry.registry.findExecutable(arg); if (!executable || executable.installType === 'none') faultyArguments.push(arg);else executables.push(executable); } if (faultyArguments.length) { console.log(`Invalid installation targets: ${faultyArguments.map(name => `'${name}'`).join(', ')}. Expecting one of: ${suggestedBrowsersToInstall()}`); process.exit(1); } return executables; } _commander.default.command('install [browser...]').description('ensure browsers necessary for this version of Playwright are installed').option('--with-deps', 'install system dependencies for browsers').action(async function (args, command) { try { if (!args.length) { if (command.opts().withDeps) await _registry.registry.installDeps(); await _registry.registry.install(); } else { const executables = checkBrowsersToInstall(args); if (command.opts().withDeps) await _registry.registry.installDeps(executables); await _registry.registry.install(executables); } } catch (e) { console.log(`Failed to install browsers\n${e}`); process.exit(1); } }).on('--help', function () { console.log(``); console.log(`Examples:`); console.log(` - $ install`); console.log(` Install default browsers.`); console.log(``); console.log(` - $ install chrome firefox`); console.log(` Install custom browsers, supports ${suggestedBrowsersToInstall()}.`); }); _commander.default.command('install-deps [browser...]').description('install dependencies necessary to run browsers (will ask for sudo permissions)').action(async function (args) { try { if (!args.length) await _registry.registry.installDeps();else await _registry.registry.installDeps(checkBrowsersToInstall(args)); } catch (e) { console.log(`Failed to install browser dependencies\n${e}`); process.exit(1); } }).on('--help', function () { console.log(``); console.log(`Examples:`); console.log(` - $ install-deps`); console.log(` Install dependencies for default browsers.`); console.log(``); console.log(` - $ install-deps chrome firefox`); console.log(` Install dependencies for specific browsers, supports ${suggestedBrowsersToInstall()}.`); }); const browsers = [{ alias: 'cr', name: 'Chromium', type: 'chromium' }, { alias: 'ff', name: 'Firefox', type: 'firefox' }, { alias: 'wk', name: 'WebKit', type: 'webkit' }]; for (const { alias, name, type } of browsers) { commandWithOpenOptions(`${alias} [url]`, `open page in ${name}`, []).action(function (url, command) { open({ ...command, browser: type }, url, command.target).catch(logErrorAndExit); }).on('--help', function () { console.log(''); console.log('Examples:'); console.log(''); console.log(` $ ${alias} https://example.com`); }); } commandWithOpenOptions('screenshot ', 'capture a page screenshot', [['--wait-for-selector ', 'wait for selector before taking a screenshot'], ['--wait-for-timeout ', 'wait for timeout in milliseconds before taking a screenshot'], ['--full-page', 'whether to take a full page screenshot (entire scrollable area)']]).action(function (url, filename, command) { screenshot(command, command, url, filename).catch(logErrorAndExit); }).on('--help', function () { console.log(''); console.log('Examples:'); console.log(''); console.log(' $ screenshot -b webkit https://example.com example.png'); }); commandWithOpenOptions('pdf ', 'save page as pdf', [['--wait-for-selector ', 'wait for given selector before saving as pdf'], ['--wait-for-timeout ', 'wait for given timeout in milliseconds before saving as pdf']]).action(function (url, filename, command) { pdf(command, command, url, filename).catch(logErrorAndExit); }).on('--help', function () { console.log(''); console.log('Examples:'); console.log(''); console.log(' $ pdf https://example.com example.pdf'); }); _commander.default.command('experimental-grid-server', { hidden: true }).option('--port ', 'grid port; defaults to 3333').option('--agent-factory ', 'path to grid agent factory or npm package').option('--auth-token ', 'optional authentication token').action(function (options) { (0, _gridServer.launchGridServer)(options.agentFactory, options.port || 3333, options.authToken); }); _commander.default.command('experimental-grid-agent', { hidden: true }).requiredOption('--agent-id ', 'agent ID').requiredOption('--grid-url ', 'grid URL').action(function (options) { (0, _gridAgent.launchGridAgent)(options.agentId, options.gridUrl); }); _commander.default.command('show-trace [trace]').option('-b, --browser ', 'browser to use, one of cr, chromium, ff, firefox, wk, webkit', 'chromium').description('Show trace viewer').action(function (trace, command) { if (command.browser === 'cr') command.browser = 'chromium'; if (command.browser === 'ff') command.browser = 'firefox'; if (command.browser === 'wk') command.browser = 'webkit'; (0, _traceViewer.showTraceViewer)(trace, command.browser).catch(logErrorAndExit); }).on('--help', function () { console.log(''); console.log('Examples:'); console.log(''); console.log(' $ show-trace trace/directory'); }); if (!process.env.PW_CLI_TARGET_LANG) { let playwrightTestPackagePath = null; try { const isLocal = packageJSON.name === '@playwright/test' || process.env.PWTEST_CLI_ALLOW_TEST_COMMAND; if (isLocal) { playwrightTestPackagePath = '../test/cli'; } else { playwrightTestPackagePath = require.resolve('@playwright/test/lib/test/cli', { paths: [__dirname, process.cwd()] }); } } catch {} if (playwrightTestPackagePath) { require(playwrightTestPackagePath).addTestCommand(_commander.default); } else { const command = _commander.default.command('test').allowUnknownOption(true); command.description('Run tests with Playwright Test. Available in @playwright/test package.'); command.action(async (args, opts) => { console.error('Please install @playwright/test package to use Playwright Test.'); console.error(' npm install -D @playwright/test'); process.exit(1); }); } } if (process.argv[2] === 'run-driver') (0, _driver.runDriver)();else if (process.argv[2] === 'run-server') (0, _driver.runServer)(process.argv[3] ? +process.argv[3] : undefined).catch(logErrorAndExit);else if (process.argv[2] === 'print-api-json') (0, _driver.printApiJson)();else if (process.argv[2] === 'launch-server') (0, _driver.launchBrowserServer)(process.argv[3], process.argv[4]).catch(logErrorAndExit);else _commander.default.parse(process.argv); async function launchContext(options, headless, executablePath) { validateOptions(options); const browserType = lookupBrowserType(options); const launchOptions = { headless, executablePath }; if (options.channel) launchOptions.channel = options.channel; const contextOptions = // Copy the device descriptor since we have to compare and modify the options. options.device ? { ...playwright.devices[options.device] } : {}; // In headful mode, use host device scale factor for things to look nice. // In headless, keep things the way it works in Playwright by default. // Assume high-dpi on MacOS. TODO: this is not perfect. if (!headless) contextOptions.deviceScaleFactor = _os.default.platform() === 'darwin' ? 2 : 1; // Work around the WebKit GTK scrolling issue. if (browserType.name() === 'webkit' && process.platform === 'linux') { delete contextOptions.hasTouch; delete contextOptions.isMobile; } if (contextOptions.isMobile && browserType.name() === 'firefox') contextOptions.isMobile = undefined; contextOptions.acceptDownloads = true; // Proxy if (options.proxyServer) { launchOptions.proxy = { server: options.proxyServer }; } const browser = await browserType.launch(launchOptions); // Viewport size if (options.viewportSize) { try { const [width, height] = options.viewportSize.split(',').map(n => parseInt(n, 10)); contextOptions.viewport = { width, height }; } catch (e) { console.log('Invalid window size format: use "width, height", for example --window-size=800,600'); process.exit(0); } } // Geolocation if (options.geolocation) { try { const [latitude, longitude] = options.geolocation.split(',').map(n => parseFloat(n.trim())); contextOptions.geolocation = { latitude, longitude }; } catch (e) { console.log('Invalid geolocation format: user lat, long, for example --geolocation="37.819722,-122.478611"'); process.exit(0); } contextOptions.permissions = ['geolocation']; } // User agent if (options.userAgent) contextOptions.userAgent = options.userAgent; // Lang if (options.lang) contextOptions.locale = options.lang; // Color scheme if (options.colorScheme) contextOptions.colorScheme = options.colorScheme; // Timezone if (options.timezone) contextOptions.timezoneId = options.timezone; // Storage if (options.loadStorage) contextOptions.storageState = options.loadStorage; if (options.ignoreHttpsErrors) contextOptions.ignoreHTTPSErrors = true; // Close app when the last window closes. const context = await browser.newContext(contextOptions); let closingBrowser = false; async function closeBrowser() { // We can come here multiple times. For example, saving storage creates // a temporary page and we call closeBrowser again when that page closes. if (closingBrowser) return; closingBrowser = true; if (options.saveTrace) await context.tracing.stop({ path: options.saveTrace }); if (options.saveStorage) await context.storageState({ path: options.saveStorage }).catch(e => null); await browser.close(); } context.on('page', page => { page.on('dialog', () => {}); // Prevent dialogs from being automatically dismissed. page.on('close', () => { const hasPage = browser.contexts().some(context => context.pages().length > 0); if (hasPage) return; // Avoid the error when the last page is closed because the browser has been closed. closeBrowser().catch(e => null); }); }); if (options.timeout) { context.setDefaultTimeout(parseInt(options.timeout, 10)); context.setDefaultNavigationTimeout(parseInt(options.timeout, 10)); } if (options.saveTrace) await context.tracing.start({ screenshots: true, snapshots: true }); // Omit options that we add automatically for presentation purpose. delete launchOptions.headless; delete launchOptions.executablePath; delete contextOptions.deviceScaleFactor; delete contextOptions.acceptDownloads; return { browser, browserName: browserType.name(), context, contextOptions, launchOptions }; } async function openPage(context, url) { const page = await context.newPage(); if (url) { if (_fs.default.existsSync(url)) url = 'file://' + _path.default.resolve(url);else if (!url.startsWith('http') && !url.startsWith('file://') && !url.startsWith('about:') && !url.startsWith('data:')) url = 'http://' + url; await page.goto(url); } return page; } async function open(options, url, language) { const { context, launchOptions, contextOptions } = await launchContext(options, !!process.env.PWTEST_CLI_HEADLESS, process.env.PWTEST_CLI_EXECUTABLE_PATH); await context._enableRecorder({ language, launchOptions, contextOptions, device: options.device, saveStorage: options.saveStorage }); await openPage(context, url); if (process.env.PWTEST_CLI_EXIT) await Promise.all(context.pages().map(p => p.close())); } async function codegen(options, url, language, outputFile) { const { context, launchOptions, contextOptions } = await launchContext(options, !!process.env.PWTEST_CLI_HEADLESS, process.env.PWTEST_CLI_EXECUTABLE_PATH); await context._enableRecorder({ language, launchOptions, contextOptions, device: options.device, saveStorage: options.saveStorage, startRecording: true, outputFile: outputFile ? _path.default.resolve(outputFile) : undefined }); await openPage(context, url); if (process.env.PWTEST_CLI_EXIT) await Promise.all(context.pages().map(p => p.close())); } async function waitForPage(page, captureOptions) { if (captureOptions.waitForSelector) { console.log(`Waiting for selector ${captureOptions.waitForSelector}...`); await page.waitForSelector(captureOptions.waitForSelector); } if (captureOptions.waitForTimeout) { console.log(`Waiting for timeout ${captureOptions.waitForTimeout}...`); await page.waitForTimeout(parseInt(captureOptions.waitForTimeout, 10)); } } async function screenshot(options, captureOptions, url, path) { const { browser, context } = await launchContext(options, true); console.log('Navigating to ' + url); const page = await openPage(context, url); await waitForPage(page, captureOptions); console.log('Capturing screenshot into ' + path); await page.screenshot({ path, fullPage: !!captureOptions.fullPage }); await browser.close(); } async function pdf(options, captureOptions, url, path) { if (options.browser !== 'chromium') { console.error('PDF creation is only working with Chromium'); process.exit(1); } const { browser, context } = await launchContext({ ...options, browser: 'chromium' }, true); console.log('Navigating to ' + url); const page = await openPage(context, url); await waitForPage(page, captureOptions); console.log('Saving as pdf into ' + path); await page.pdf({ path }); await browser.close(); } function lookupBrowserType(options) { let name = options.browser; if (options.device) { const device = playwright.devices[options.device]; name = device.defaultBrowserType; } let browserType; switch (name) { case 'chromium': browserType = playwright.chromium; break; case 'webkit': browserType = playwright.webkit; break; case 'firefox': browserType = playwright.firefox; break; case 'cr': browserType = playwright.chromium; break; case 'wk': browserType = playwright.webkit; break; case 'ff': browserType = playwright.firefox; break; } if (browserType) return browserType; _commander.default.help(); } function validateOptions(options) { if (options.device && !(options.device in playwright.devices)) { console.log(`Device descriptor not found: '${options.device}', available devices are:`); for (const name in playwright.devices) console.log(` "${name}"`); process.exit(0); } if (options.colorScheme && !['light', 'dark'].includes(options.colorScheme)) { console.log('Invalid color scheme, should be one of "light", "dark"'); process.exit(0); } } function logErrorAndExit(e) { console.error(e); process.exit(1); } function language() { return process.env.PW_CLI_TARGET_LANG || 'test'; } function commandWithOpenOptions(command, description, options) { let result = _commander.default.command(command).description(description); for (const option of options) result = result.option(option[0], ...option.slice(1)); return result.option('-b, --browser ', 'browser to use, one of cr, chromium, ff, firefox, wk, webkit', 'chromium').option('--channel ', 'Chromium distribution channel, "chrome", "chrome-beta", "msedge-dev", etc').option('--color-scheme ', 'emulate preferred color scheme, "light" or "dark"').option('--device ', 'emulate device, for example "iPhone 11"').option('--geolocation ', 'specify geolocation coordinates, for example "37.819722,-122.478611"').option('--ignore-https-errors', 'ignore https errors').option('--load-storage ', 'load context storage state from the file, previously saved with --save-storage').option('--lang ', 'specify language / locale, for example "en-GB"').option('--proxy-server ', 'specify proxy server, for example "http://myproxy:3128" or "socks5://myproxy:8080"').option('--save-storage ', 'save context storage state at the end, for later use with --load-storage').option('--save-trace ', 'record a trace for the session and save it to a file').option('--timezone