@playwright/mcp 0.0.36-alpha-2025-09-04 → 0.0.37-alpha-2025-09-08

package/lib/browser/codegen.js

@@ -1,54 +0,0 @@
-"use strict";
-/**
- * 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.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.escapeWithQuotes = escapeWithQuotes;
-exports.quote = quote;
-exports.formatObject = formatObject;
-// adapted from:
-// - https://github.com/microsoft/playwright/blob/76ee48dc9d4034536e3ec5b2c7ce8be3b79418a8/packages/playwright-core/src/utils/isomorphic/stringUtils.ts
-// - https://github.com/microsoft/playwright/blob/76ee48dc9d4034536e3ec5b2c7ce8be3b79418a8/packages/playwright-core/src/server/codegen/javascript.ts
-// NOTE: this function should not be used to escape any selectors.
-function escapeWithQuotes(text, char = '\'') {
-    const stringified = JSON.stringify(text);
-    const escapedText = stringified.substring(1, stringified.length - 1).replace(/\\"/g, '"');
-    if (char === '\'')
-        return char + escapedText.replace(/[']/g, '\\\'') + char;
-    if (char === '"')
-        return char + escapedText.replace(/["]/g, '\\"') + char;
-    if (char === '`')
-        return char + escapedText.replace(/[`]/g, '\\`') + char;
-    throw new Error('Invalid escape char');
-}
-function quote(text) {
-    return escapeWithQuotes(text, '\'');
-}
-function formatObject(value, indent = '  ') {
-    if (typeof value === 'string')
-        return quote(value);
-    if (Array.isArray(value))
-        return `[${value.map(o => formatObject(o)).join(', ')}]`;
-    if (typeof value === 'object') {
-        const keys = Object.keys(value).filter(key => value[key] !== undefined).sort();
-        if (!keys.length)
-            return '{}';
-        const tokens = [];
-        for (const key of keys)
-            tokens.push(`${key}: ${formatObject(value[key])}`);
-        return `{\n${indent}${tokens.join(`,\n${indent}`)}\n}`;
-    }
-    return String(value);
-}

package/lib/browser/config.js

@@ -1,263 +0,0 @@
-"use strict";
-/**
- * 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.
- */
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.resolveConfig = resolveConfig;
-exports.resolveCLIConfig = resolveCLIConfig;
-exports.configFromCLIOptions = configFromCLIOptions;
-exports.outputFile = outputFile;
-exports.semicolonSeparatedList = semicolonSeparatedList;
-exports.commaSeparatedList = commaSeparatedList;
-const fs_1 = __importDefault(require("fs"));
-const os_1 = __importDefault(require("os"));
-const path_1 = __importDefault(require("path"));
-const playwright_1 = require("playwright");
-const defaultConfig = {
-    browser: {
-        browserName: 'chromium',
-        launchOptions: {
-            channel: 'chrome',
-            headless: os_1.default.platform() === 'linux' && !process.env.DISPLAY,
-            chromiumSandbox: true,
-        },
-        contextOptions: {
-            viewport: null,
-        },
-    },
-    network: {
-        allowedOrigins: undefined,
-        blockedOrigins: undefined,
-    },
-    server: {},
-    saveTrace: false,
-};
-async function resolveConfig(config) {
-    return mergeConfig(defaultConfig, config);
-}
-async function resolveCLIConfig(cliOptions) {
-    const configInFile = await loadConfig(cliOptions.config);
-    const envOverrides = configFromEnv();
-    const cliOverrides = configFromCLIOptions(cliOptions);
-    let result = defaultConfig;
-    result = mergeConfig(result, configInFile);
-    result = mergeConfig(result, envOverrides);
-    result = mergeConfig(result, cliOverrides);
-    return result;
-}
-function configFromCLIOptions(cliOptions) {
-    let browserName;
-    let channel;
-    switch (cliOptions.browser) {
-        case 'chrome':
-        case 'chrome-beta':
-        case 'chrome-canary':
-        case 'chrome-dev':
-        case 'chromium':
-        case 'msedge':
-        case 'msedge-beta':
-        case 'msedge-canary':
-        case 'msedge-dev':
-            browserName = 'chromium';
-            channel = cliOptions.browser;
-            break;
-        case 'firefox':
-            browserName = 'firefox';
-            break;
-        case 'webkit':
-            browserName = 'webkit';
-            break;
-    }
-    // Launch options
-    const launchOptions = {
-        channel,
-        executablePath: cliOptions.executablePath,
-        headless: cliOptions.headless,
-    };
-    // --no-sandbox was passed, disable the sandbox
-    if (cliOptions.sandbox === false)
-        launchOptions.chromiumSandbox = false;
-    if (cliOptions.proxyServer) {
-        launchOptions.proxy = {
-            server: cliOptions.proxyServer
-        };
-        if (cliOptions.proxyBypass)
-            launchOptions.proxy.bypass = cliOptions.proxyBypass;
-    }
-    if (cliOptions.device && cliOptions.cdpEndpoint)
-        throw new Error('Device emulation is not supported with cdpEndpoint.');
-    // Context options
-    const contextOptions = cliOptions.device ? playwright_1.devices[cliOptions.device] : {};
-    if (cliOptions.storageState)
-        contextOptions.storageState = cliOptions.storageState;
-    if (cliOptions.userAgent)
-        contextOptions.userAgent = cliOptions.userAgent;
-    if (cliOptions.viewportSize) {
-        try {
-            const [width, height] = cliOptions.viewportSize.split(',').map(n => +n);
-            if (isNaN(width) || isNaN(height))
-                throw new Error('bad values');
-            contextOptions.viewport = { width, height };
-        }
-        catch (e) {
-            throw new Error('Invalid viewport size format: use "width,height", for example --viewport-size="800,600"');
-        }
-    }
-    if (cliOptions.ignoreHttpsErrors)
-        contextOptions.ignoreHTTPSErrors = true;
-    if (cliOptions.blockServiceWorkers)
-        contextOptions.serviceWorkers = 'block';
-    const result = {
-        browser: {
-            browserName,
-            isolated: cliOptions.isolated,
-            userDataDir: cliOptions.userDataDir,
-            launchOptions,
-            contextOptions,
-            cdpEndpoint: cliOptions.cdpEndpoint,
-        },
-        server: {
-            port: cliOptions.port,
-            host: cliOptions.host,
-        },
-        capabilities: cliOptions.caps,
-        network: {
-            allowedOrigins: cliOptions.allowedOrigins,
-            blockedOrigins: cliOptions.blockedOrigins,
-        },
-        saveSession: cliOptions.saveSession,
-        saveTrace: cliOptions.saveTrace,
-        outputDir: cliOptions.outputDir,
-        imageResponses: cliOptions.imageResponses,
-    };
-    return result;
-}
-function configFromEnv() {
-    const options = {};
-    options.allowedOrigins = semicolonSeparatedList(process.env.PLAYWRIGHT_MCP_ALLOWED_ORIGINS);
-    options.blockedOrigins = semicolonSeparatedList(process.env.PLAYWRIGHT_MCP_BLOCKED_ORIGINS);
-    options.blockServiceWorkers = envToBoolean(process.env.PLAYWRIGHT_MCP_BLOCK_SERVICE_WORKERS);
-    options.browser = envToString(process.env.PLAYWRIGHT_MCP_BROWSER);
-    options.caps = commaSeparatedList(process.env.PLAYWRIGHT_MCP_CAPS);
-    options.cdpEndpoint = envToString(process.env.PLAYWRIGHT_MCP_CDP_ENDPOINT);
-    options.config = envToString(process.env.PLAYWRIGHT_MCP_CONFIG);
-    options.device = envToString(process.env.PLAYWRIGHT_MCP_DEVICE);
-    options.executablePath = envToString(process.env.PLAYWRIGHT_MCP_EXECUTABLE_PATH);
-    options.headless = envToBoolean(process.env.PLAYWRIGHT_MCP_HEADLESS);
-    options.host = envToString(process.env.PLAYWRIGHT_MCP_HOST);
-    options.ignoreHttpsErrors = envToBoolean(process.env.PLAYWRIGHT_MCP_IGNORE_HTTPS_ERRORS);
-    options.isolated = envToBoolean(process.env.PLAYWRIGHT_MCP_ISOLATED);
-    if (process.env.PLAYWRIGHT_MCP_IMAGE_RESPONSES === 'omit')
-        options.imageResponses = 'omit';
-    options.sandbox = envToBoolean(process.env.PLAYWRIGHT_MCP_SANDBOX);
-    options.outputDir = envToString(process.env.PLAYWRIGHT_MCP_OUTPUT_DIR);
-    options.port = envToNumber(process.env.PLAYWRIGHT_MCP_PORT);
-    options.proxyBypass = envToString(process.env.PLAYWRIGHT_MCP_PROXY_BYPASS);
-    options.proxyServer = envToString(process.env.PLAYWRIGHT_MCP_PROXY_SERVER);
-    options.saveTrace = envToBoolean(process.env.PLAYWRIGHT_MCP_SAVE_TRACE);
-    options.storageState = envToString(process.env.PLAYWRIGHT_MCP_STORAGE_STATE);
-    options.userAgent = envToString(process.env.PLAYWRIGHT_MCP_USER_AGENT);
-    options.userDataDir = envToString(process.env.PLAYWRIGHT_MCP_USER_DATA_DIR);
-    options.viewportSize = envToString(process.env.PLAYWRIGHT_MCP_VIEWPORT_SIZE);
-    return configFromCLIOptions(options);
-}
-async function loadConfig(configFile) {
-    if (!configFile)
-        return {};
-    try {
-        return JSON.parse(await fs_1.default.promises.readFile(configFile, 'utf8'));
-    }
-    catch (error) {
-        throw new Error(`Failed to load config file: ${configFile}, ${error}`);
-    }
-}
-async function outputFile(config, rootPath, name) {
-    var _a, _b;
-    const outputDir = (_b = (_a = config.outputDir) !== null && _a !== void 0 ? _a : (rootPath ? path_1.default.join(rootPath, '.playwright-mcp') : undefined)) !== null && _b !== void 0 ? _b : path_1.default.join(os_1.default.tmpdir(), 'playwright-mcp-output', sanitizeForFilePath(new Date().toISOString()));
-    await fs_1.default.promises.mkdir(outputDir, { recursive: true });
-    const fileName = sanitizeForFilePath(name);
-    return path_1.default.join(outputDir, fileName);
-}
-function pickDefined(obj) {
-    return Object.fromEntries(Object.entries(obj !== null && obj !== void 0 ? obj : {}).filter(([_, v]) => v !== undefined));
-}
-function mergeConfig(base, overrides) {
-    var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m;
-    const browser = {
-        ...pickDefined(base.browser),
-        ...pickDefined(overrides.browser),
-        browserName: (_d = (_b = (_a = overrides.browser) === null || _a === void 0 ? void 0 : _a.browserName) !== null && _b !== void 0 ? _b : (_c = base.browser) === null || _c === void 0 ? void 0 : _c.browserName) !== null && _d !== void 0 ? _d : 'chromium',
-        isolated: (_h = (_f = (_e = overrides.browser) === null || _e === void 0 ? void 0 : _e.isolated) !== null && _f !== void 0 ? _f : (_g = base.browser) === null || _g === void 0 ? void 0 : _g.isolated) !== null && _h !== void 0 ? _h : false,
-        launchOptions: {
-            ...pickDefined((_j = base.browser) === null || _j === void 0 ? void 0 : _j.launchOptions),
-            ...pickDefined((_k = overrides.browser) === null || _k === void 0 ? void 0 : _k.launchOptions),
-            ...{ assistantMode: true },
-        },
-        contextOptions: {
-            ...pickDefined((_l = base.browser) === null || _l === void 0 ? void 0 : _l.contextOptions),
-            ...pickDefined((_m = overrides.browser) === null || _m === void 0 ? void 0 : _m.contextOptions),
-        },
-    };
-    if (browser.browserName !== 'chromium' && browser.launchOptions)
-        delete browser.launchOptions.channel;
-    return {
-        ...pickDefined(base),
-        ...pickDefined(overrides),
-        browser,
-        network: {
-            ...pickDefined(base.network),
-            ...pickDefined(overrides.network),
-        },
-        server: {
-            ...pickDefined(base.server),
-            ...pickDefined(overrides.server),
-        },
-    };
-}
-function semicolonSeparatedList(value) {
-    if (!value)
-        return undefined;
-    return value.split(';').map(v => v.trim());
-}
-function commaSeparatedList(value) {
-    if (!value)
-        return undefined;
-    return value.split(',').map(v => v.trim());
-}
-function envToNumber(value) {
-    if (!value)
-        return undefined;
-    return +value;
-}
-function envToBoolean(value) {
-    if (value === 'true' || value === '1')
-        return true;
-    if (value === 'false' || value === '0')
-        return false;
-    return undefined;
-}
-function envToString(value) {
-    return value ? value.trim() : undefined;
-}
-function sanitizeForFilePath(s) {
-    const sanitize = (s) => s.replace(/[\x00-\x2C\x2E-\x2F\x3A-\x40\x5B-\x60\x7B-\x7F]+/g, '-');
-    const separator = s.lastIndexOf('.');
-    if (separator === -1)
-        return sanitize(s);
-    return sanitize(s.substring(0, separator)) + '.' + sanitize(s.substring(separator + 1));
-}

package/lib/browser/context.js

@@ -1,223 +0,0 @@
-"use strict";
-/**
- * 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.
- */
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.InputRecorder = exports.Context = void 0;
-const debug_1 = __importDefault(require("debug"));
-const log_1 = require("../log");
-const tab_1 = require("./tab");
-const config_1 = require("./config");
-const testDebug = (0, debug_1.default)('pw:mcp:test');
-class Context {
-    constructor(options) {
-        this._tabs = [];
-        this._abortController = new AbortController();
-        this.tools = options.tools;
-        this.config = options.config;
-        this.sessionLog = options.sessionLog;
-        this.options = options;
-        this._browserContextFactory = options.browserContextFactory;
-        this._clientInfo = options.clientInfo;
-        testDebug('create context');
-        Context._allContexts.add(this);
-    }
-    static async disposeAll() {
-        await Promise.all([...Context._allContexts].map(context => context.dispose()));
-    }
-    tabs() {
-        return this._tabs;
-    }
-    currentTab() {
-        return this._currentTab;
-    }
-    currentTabOrDie() {
-        if (!this._currentTab)
-            throw new Error('No open pages available. Use the "browser_navigate" tool to navigate to a page first.');
-        return this._currentTab;
-    }
-    async newTab() {
-        const { browserContext } = await this._ensureBrowserContext();
-        const page = await browserContext.newPage();
-        this._currentTab = this._tabs.find(t => t.page === page);
-        return this._currentTab;
-    }
-    async selectTab(index) {
-        const tab = this._tabs[index];
-        if (!tab)
-            throw new Error(`Tab ${index} not found`);
-        await tab.page.bringToFront();
-        this._currentTab = tab;
-        return tab;
-    }
-    async ensureTab() {
-        const { browserContext } = await this._ensureBrowserContext();
-        if (!this._currentTab)
-            await browserContext.newPage();
-        return this._currentTab;
-    }
-    async closeTab(index) {
-        const tab = index === undefined ? this._currentTab : this._tabs[index];
-        if (!tab)
-            throw new Error(`Tab ${index} not found`);
-        const url = tab.page.url();
-        await tab.page.close();
-        return url;
-    }
-    async outputFile(name) {
-        return (0, config_1.outputFile)(this.config, this._clientInfo.rootPath, name);
-    }
-    _onPageCreated(page) {
-        const tab = new tab_1.Tab(this, page, tab => this._onPageClosed(tab));
-        this._tabs.push(tab);
-        if (!this._currentTab)
-            this._currentTab = tab;
-    }
-    _onPageClosed(tab) {
-        const index = this._tabs.indexOf(tab);
-        if (index === -1)
-            return;
-        this._tabs.splice(index, 1);
-        if (this._currentTab === tab)
-            this._currentTab = this._tabs[Math.min(index, this._tabs.length - 1)];
-        if (!this._tabs.length)
-            void this.closeBrowserContext();
-    }
-    async closeBrowserContext() {
-        if (!this._closeBrowserContextPromise)
-            this._closeBrowserContextPromise = this._closeBrowserContextImpl().catch(log_1.logUnhandledError);
-        await this._closeBrowserContextPromise;
-        this._closeBrowserContextPromise = undefined;
-    }
-    isRunningTool() {
-        return this._runningToolName !== undefined;
-    }
-    setRunningTool(name) {
-        this._runningToolName = name;
-    }
-    async _closeBrowserContextImpl() {
-        if (!this._browserContextPromise)
-            return;
-        testDebug('close context');
-        const promise = this._browserContextPromise;
-        this._browserContextPromise = undefined;
-        await promise.then(async ({ browserContext, close }) => {
-            if (this.config.saveTrace)
-                await browserContext.tracing.stop();
-            await close();
-        });
-    }
-    async dispose() {
-        this._abortController.abort('MCP context disposed');
-        await this.closeBrowserContext();
-        Context._allContexts.delete(this);
-    }
-    async _setupRequestInterception(context) {
-        var _a, _b, _c, _d;
-        if ((_b = (_a = this.config.network) === null || _a === void 0 ? void 0 : _a.allowedOrigins) === null || _b === void 0 ? void 0 : _b.length) {
-            await context.route('**', route => route.abort('blockedbyclient'));
-            for (const origin of this.config.network.allowedOrigins)
-                await context.route(`*://${origin}/**`, route => route.continue());
-        }
-        if ((_d = (_c = this.config.network) === null || _c === void 0 ? void 0 : _c.blockedOrigins) === null || _d === void 0 ? void 0 : _d.length) {
-            for (const origin of this.config.network.blockedOrigins)
-                await context.route(`*://${origin}/**`, route => route.abort('blockedbyclient'));
-        }
-    }
-    _ensureBrowserContext() {
-        if (!this._browserContextPromise) {
-            this._browserContextPromise = this._setupBrowserContext();
-            this._browserContextPromise.catch(() => {
-                this._browserContextPromise = undefined;
-            });
-        }
-        return this._browserContextPromise;
-    }
-    async _setupBrowserContext() {
-        if (this._closeBrowserContextPromise)
-            throw new Error('Another browser context is being closed.');
-        // TODO: move to the browser context factory to make it based on isolation mode.
-        const result = await this._browserContextFactory.createContext(this._clientInfo, this._abortController.signal, this._runningToolName);
-        const { browserContext } = result;
-        await this._setupRequestInterception(browserContext);
-        if (this.sessionLog)
-            await InputRecorder.create(this, browserContext);
-        for (const page of browserContext.pages())
-            this._onPageCreated(page);
-        browserContext.on('page', page => this._onPageCreated(page));
-        if (this.config.saveTrace) {
-            await browserContext.tracing.start({
-                name: 'trace',
-                screenshots: false,
-                snapshots: true,
-                sources: false,
-            });
-        }
-        return result;
-    }
-}
-exports.Context = Context;
-Context._allContexts = new Set();
-class InputRecorder {
-    constructor(context, browserContext) {
-        this._context = context;
-        this._browserContext = browserContext;
-    }
-    static async create(context, browserContext) {
-        const recorder = new InputRecorder(context, browserContext);
-        await recorder._initialize();
-        return recorder;
-    }
-    async _initialize() {
-        const sessionLog = this._context.sessionLog;
-        await this._browserContext._enableRecorder({
-            mode: 'recording',
-            recorderMode: 'api',
-        }, {
-            actionAdded: (page, data, code) => {
-                if (this._context.isRunningTool())
-                    return;
-                const tab = tab_1.Tab.forPage(page);
-                if (tab)
-                    sessionLog.logUserAction(data.action, tab, code, false);
-            },
-            actionUpdated: (page, data, code) => {
-                if (this._context.isRunningTool())
-                    return;
-                const tab = tab_1.Tab.forPage(page);
-                if (tab)
-                    sessionLog.logUserAction(data.action, tab, code, true);
-            },
-            signalAdded: (page, data) => {
-                if (this._context.isRunningTool())
-                    return;
-                if (data.signal.name !== 'navigation')
-                    return;
-                const tab = tab_1.Tab.forPage(page);
-                const navigateAction = {
-                    name: 'navigate',
-                    url: data.signal.url,
-                    signals: [],
-                };
-                if (tab)
-                    sessionLog.logUserAction(navigateAction, tab, `await page.goto('${data.signal.url}');`, false);
-            },
-        });
-    }
-}
-exports.InputRecorder = InputRecorder;