@mcp-b/chrome-devtools-mcp 2.0.13 → 2.2.0

package/build/vendor/chrome-devtools-frontend/front_end/core/host/InspectorFrontendHostStub.js

@@ -1,438 +0,0 @@
-// Copyright 2025 The Chromium Authors
-// Use of this source code is governed by a BSD-style license that can be
-// found in the LICENSE file.
-import * as Common from '../common/common.js';
-import * as i18n from '../i18n/i18n.js';
-import * as Platform from '../platform/platform.js';
-import { Events, } from './InspectorFrontendHostAPI.js';
-import { streamWrite as resourceLoaderStreamWrite } from './ResourceLoader.js';
-const UIStrings = {
-    /**
-     * @description Document title in Inspector Frontend Host of the DevTools window
-     * @example {example.com} PH1
-     */
-    devtoolsS: 'DevTools - {PH1}',
-};
-const str_ = i18n.i18n.registerUIStrings('core/host/InspectorFrontendHostStub.ts', UIStrings);
-const i18nString = i18n.i18n.getLocalizedString.bind(undefined, str_);
-const MAX_RECORDED_HISTOGRAMS_SIZE = 100;
-const OVERRIDES_FILE_SYSTEM_PATH = '/overrides';
-/**
- * The `InspectorFrontendHostStub` is a stub interface used the frontend is loaded like a webpage. Examples:
- *   - devtools://devtools/bundled/devtools_app.html
- *   - https://chrome-devtools-frontend.appspot.com/serve_rev/@030cc140435b0152645522b9864b75cac6c0a854/worker_app.html
- *   - http://localhost:9222/devtools/inspector.html?ws=localhost:9222/devtools/page/xTARGET_IDx
- *
- * When the frontend runs within the native embedder, then the InspectorFrontendHostAPI methods are provided
- * by devtools_compatibility.js. Those leverage `DevToolsAPI.sendMessageToEmbedder()` which match up with
- * the embedder API defined here: https://source.chromium.org/search?q=f:devtools%20f:dispatcher%20f:cc%20symbol:CreateForDevToolsFrontend&sq=&ss=chromium%2Fchromium%2Fsrc
- * The native implementations live in devtools_ui_bindings.cc: https://source.chromium.org/chromium/chromium/src/+/main:chrome/browser/devtools/devtools_ui_bindings.cc
- */
-export class InspectorFrontendHostStub {
-    #urlsBeingSaved = new Map();
-    #fileSystem = null;
-    recordedCountHistograms = [];
-    recordedEnumeratedHistograms = [];
-    recordedPerformanceHistograms = [];
-    constructor() {
-        // Guard against errors should this file ever be imported at the top level
-        // within a worker - in which case this constructor is run. If there's no
-        // document, we can early exit.
-        if (typeof document === 'undefined') {
-            return;
-        }
-        function stopEventPropagation(event) {
-            // Let browser handle Ctrl+/Ctrl- shortcuts in hosted mode.
-            const zoomModifier = this.platform() === 'mac' ? event.metaKey : event.ctrlKey;
-            if (zoomModifier && (event.key === '+' || event.key === '-')) {
-                event.stopPropagation();
-            }
-        }
-        document.addEventListener('keydown', event => {
-            stopEventPropagation.call(this, (event));
-        }, true);
-    }
-    platform() {
-        const userAgent = navigator.userAgent;
-        if (userAgent.includes('Windows NT')) {
-            return 'windows';
-        }
-        if (userAgent.includes('Mac OS X')) {
-            return 'mac';
-        }
-        return 'linux';
-    }
-    loadCompleted() {
-    }
-    bringToFront() {
-    }
-    closeWindow() {
-    }
-    setIsDocked(_isDocked, callback) {
-        window.setTimeout(callback, 0);
-    }
-    showSurvey(_trigger, callback) {
-        window.setTimeout(() => callback({ surveyShown: false }), 0);
-    }
-    canShowSurvey(_trigger, callback) {
-        window.setTimeout(() => callback({ canShowSurvey: false }), 0);
-    }
-    /**
-     * Requests inspected page to be placed atop of the inspector frontend with specified bounds.
-     */
-    setInspectedPageBounds(_bounds) {
-    }
-    inspectElementCompleted() {
-    }
-    setInjectedScriptForOrigin(_origin, _script) {
-    }
-    inspectedURLChanged(url) {
-        if (!('document' in globalThis)) {
-            return;
-        }
-        document.title = i18nString(UIStrings.devtoolsS, { PH1: url.replace(/^https?:\/\//, '') });
-    }
-    copyText(text) {
-        if (text === undefined || text === null) {
-            return;
-        }
-        void navigator.clipboard.writeText(text);
-    }
-    openInNewTab(url) {
-        if (Common.ParsedURL.schemeIs(url, 'javascript:')) {
-            return;
-        }
-        window.open(url, '_blank');
-    }
-    openSearchResultsInNewTab(_query) {
-        Common.Console.Console.instance().error('Search is not enabled in hosted mode. Please inspect using chrome://inspect');
-    }
-    showItemInFolder(_fileSystemPath) {
-        Common.Console.Console.instance().error('Show item in folder is not enabled in hosted mode. Please inspect using chrome://inspect');
-    }
-    // Reminder: the methods in this class belong to InspectorFrontendHostStub and are typically not executed.
-    // InspectorFrontendHostStub is ONLY used in the uncommon case of devtools not being embedded. For example: trace.cafe or http://localhost:9222/devtools/inspector.html?ws=localhost:9222/devtools/page/xTARGET_IDx
-    save(url, content, _forceSaveAs, isBase64) {
-        let buffer = this.#urlsBeingSaved.get(url)?.buffer;
-        if (!buffer) {
-            buffer = [];
-            this.#urlsBeingSaved.set(url, { isBase64, buffer });
-        }
-        buffer.push(content);
-        this.events.dispatchEventToListeners(Events.SavedURL, { url, fileSystemPath: url });
-    }
-    append(url, content) {
-        const buffer = this.#urlsBeingSaved.get(url)?.buffer;
-        if (buffer) {
-            buffer.push(content);
-            this.events.dispatchEventToListeners(Events.AppendedToURL, url);
-        }
-    }
-    close(url) {
-        const { isBase64, buffer } = this.#urlsBeingSaved.get(url) || { isBase64: false, buffer: [] };
-        this.#urlsBeingSaved.delete(url);
-        let fileName = '';
-        if (url) {
-            try {
-                const trimmed = Platform.StringUtilities.trimURL(url);
-                fileName = Platform.StringUtilities.removeURLFragment(trimmed);
-            }
-            catch {
-                // If url is not a valid URL, it is probably a filename.
-                fileName = url;
-            }
-        }
-        /* eslint-disable-next-line @devtools/no-imperative-dom-api */
-        const link = document.createElement('a');
-        link.download = fileName;
-        let blob;
-        if (isBase64) {
-            const bytes = Common.Base64.decode(buffer.join(''));
-            blob = new Blob([bytes], { type: 'application/gzip' });
-        }
-        else {
-            blob = new Blob(buffer, { type: 'text/plain' });
-        }
-        const blobUrl = URL.createObjectURL(blob);
-        link.href = blobUrl;
-        link.click();
-        URL.revokeObjectURL(blobUrl);
-    }
-    sendMessageToBackend(_message) {
-    }
-    recordCountHistogram(histogramName, sample, min, exclusiveMax, bucketSize) {
-        if (this.recordedCountHistograms.length >= MAX_RECORDED_HISTOGRAMS_SIZE) {
-            this.recordedCountHistograms.shift();
-        }
-        this.recordedCountHistograms.push({ histogramName, sample, min, exclusiveMax, bucketSize });
-    }
-    recordEnumeratedHistogram(actionName, actionCode, _bucketSize) {
-        if (this.recordedEnumeratedHistograms.length >= MAX_RECORDED_HISTOGRAMS_SIZE) {
-            this.recordedEnumeratedHistograms.shift();
-        }
-        this.recordedEnumeratedHistograms.push({ actionName, actionCode });
-    }
-    recordPerformanceHistogram(histogramName, duration) {
-        if (this.recordedPerformanceHistograms.length >= MAX_RECORDED_HISTOGRAMS_SIZE) {
-            this.recordedPerformanceHistograms.shift();
-        }
-        this.recordedPerformanceHistograms.push({ histogramName, duration });
-    }
-    recordPerformanceHistogramMedium(histogramName, duration) {
-        if (this.recordedPerformanceHistograms.length >= MAX_RECORDED_HISTOGRAMS_SIZE) {
-            this.recordedPerformanceHistograms.shift();
-        }
-        this.recordedPerformanceHistograms.push({ histogramName, duration });
-    }
-    recordUserMetricsAction(_umaName) {
-    }
-    recordNewBadgeUsage(_featureName) {
-    }
-    connectAutomaticFileSystem(_fileSystemPath, _fileSystemUUID, _addIfMissing, callback) {
-        queueMicrotask(() => callback({ success: false }));
-    }
-    disconnectAutomaticFileSystem(_fileSystemPath) {
-    }
-    requestFileSystems() {
-        this.events.dispatchEventToListeners(Events.FileSystemsLoaded, []);
-    }
-    addFileSystem(_type) {
-        const onFileSystem = (fs) => {
-            this.#fileSystem = fs;
-            const fileSystem = {
-                fileSystemName: 'sandboxedRequestedFileSystem',
-                fileSystemPath: OVERRIDES_FILE_SYSTEM_PATH,
-                rootURL: 'filesystem:devtools://devtools/isolated/',
-                type: 'overrides',
-            };
-            this.events.dispatchEventToListeners(Events.FileSystemAdded, { fileSystem });
-        };
-        window.webkitRequestFileSystem(window.TEMPORARY, 1024 * 1024, onFileSystem);
-    }
-    removeFileSystem(_fileSystemPath) {
-        const removalCallback = (entries) => {
-            entries.forEach(entry => {
-                if (entry.isDirectory) {
-                    entry.removeRecursively(() => { });
-                }
-                else if (entry.isFile) {
-                    entry.remove(() => { });
-                }
-            });
-        };
-        if (this.#fileSystem) {
-            this.#fileSystem.root.createReader().readEntries(removalCallback);
-        }
-        this.#fileSystem = null;
-        this.events.dispatchEventToListeners(Events.FileSystemRemoved, OVERRIDES_FILE_SYSTEM_PATH);
-    }
-    isolatedFileSystem(_fileSystemId, _registeredName) {
-        return this.#fileSystem;
-    }
-    loadNetworkResource(url, _headers, streamId, callback) {
-        fetch(url)
-            .then(async (result) => {
-            const respBuffer = await result.arrayBuffer();
-            const text = await Common.Gzip.arrayBufferToString(respBuffer);
-            return text;
-        })
-            .then(function (text) {
-            resourceLoaderStreamWrite(streamId, text);
-            callback({
-                statusCode: 200,
-                headers: undefined,
-                messageOverride: undefined,
-                netError: undefined,
-                netErrorName: undefined,
-                urlValid: undefined,
-            });
-        })
-            .catch(function () {
-            callback({
-                statusCode: 404,
-                headers: undefined,
-                messageOverride: undefined,
-                netError: undefined,
-                netErrorName: undefined,
-                urlValid: undefined,
-            });
-        });
-    }
-    registerPreference(_name, _options) {
-    }
-    getPreferences(callback) {
-        const prefs = {};
-        for (const name in window.localStorage) {
-            prefs[name] = window.localStorage[name];
-        }
-        callback(prefs);
-    }
-    getPreference(name, callback) {
-        callback(window.localStorage[name]);
-    }
-    setPreference(name, value) {
-        window.localStorage[name] = value;
-    }
-    removePreference(name) {
-        delete window.localStorage[name];
-    }
-    clearPreferences() {
-        window.localStorage.clear();
-    }
-    getSyncInformation(callback) {
-        if ('getSyncInformationForTesting' in globalThis) {
-            // @ts-expect-error for testing
-            return callback(globalThis.getSyncInformationForTesting());
-        }
-        callback({
-            isSyncActive: false,
-            arePreferencesSynced: false,
-        });
-    }
-    getHostConfig(callback) {
-        // This HostConfig config is used in the hosted mode (see the
-        // comment on top of this class). Only add non-default config params
-        // here that you want to also apply in the hosted mode. For tests
-        // use the hostConfigForTesting override.
-        const hostConfigForHostedMode = {
-            devToolsVeLogging: {
-                enabled: true,
-            },
-            thirdPartyCookieControls: {
-                thirdPartyCookieMetadataEnabled: true,
-                thirdPartyCookieHeuristicsEnabled: true,
-                managedBlockThirdPartyCookies: 'Unset',
-            },
-            devToolsFlexibleLayout: {
-                verticalDrawerEnabled: true,
-            },
-        };
-        if ('hostConfigForTesting' in globalThis) {
-            const { hostConfigForTesting } = globalThis;
-            for (const key of Object.keys(hostConfigForTesting)) {
-                const mergeEntry = (key) => {
-                    if (typeof hostConfigForHostedMode[key] === 'object' && typeof hostConfigForTesting[key] === 'object') {
-                        // If the config is an object, merge the settings, but preferring
-                        // the hostConfigForTesting values over the result values.
-                        hostConfigForHostedMode[key] = { ...hostConfigForHostedMode[key], ...hostConfigForTesting[key] };
-                    }
-                    else {
-                        // Override with the testing config if the value is present + not null/undefined.
-                        hostConfigForHostedMode[key] = hostConfigForTesting[key] ?? hostConfigForHostedMode[key];
-                    }
-                };
-                mergeEntry(key);
-            }
-        }
-        callback(hostConfigForHostedMode);
-    }
-    upgradeDraggedFileSystemPermissions(_fileSystem) {
-    }
-    indexPath(_requestId, _fileSystemPath, _excludedFolders) {
-    }
-    stopIndexing(_requestId) {
-    }
-    searchInPath(_requestId, _fileSystemPath, _query) {
-    }
-    zoomFactor() {
-        return 1;
-    }
-    zoomIn() {
-    }
-    zoomOut() {
-    }
-    resetZoom() {
-    }
-    setWhitelistedShortcuts(_shortcuts) {
-    }
-    setEyeDropperActive(_active) {
-    }
-    showCertificateViewer(_certChain) {
-    }
-    reattach(_callback) {
-    }
-    readyForTest() {
-    }
-    connectionReady() {
-    }
-    setOpenNewWindowForPopups(_value) {
-    }
-    setDevicesDiscoveryConfig(_config) {
-    }
-    setDevicesUpdatesEnabled(_enabled) {
-    }
-    openRemotePage(_browserId, _url) {
-    }
-    openNodeFrontend() {
-    }
-    showContextMenuAtPoint(_x, _y, _items, _document) {
-        throw new Error('Soft context menu should be used');
-    }
-    /**
-     * Think of **Hosted mode** as "non-embedded" mode; you can see a devtools frontend URL as the tab's URL. It's an atypical way that DevTools is run.
-     * Whereas in **Non-hosted** (aka "embedded"), DevTools is embedded and fully dockable. It's the common way DevTools is run.
-     *
-     * **Hosted mode** == we're using the `InspectorFrontendHostStub`. impl. (@see `InspectorFrontendHostStub` class comment)
-     * Whereas with **non-hosted** mode, native `DevToolsEmbedderMessageDispatcher` is used for CDP and more.  `globalThis.DevToolsAPI` is present.
-     *
-     * Relationships to other signals:
-     * - _Connection_: Hosted-ness does not indicate whether the frontend is _connected to a valid CDP target_.
-     * - _Dockability_: Being _"dockable"_ (aka `canDock`) is typically aligned but technically orthogonal.
-     * - _URL scheme_: If the main frame's URL scheme is `devtools://`, it's non-hosted.
-     *
-     *  | Example case                                | Mode           | Example devtools                                                              |
-     *  | :------------------------------------------ | :------------- | :---------------------------------------------------------------------------- |
-     *  | tab URL: `devtools://…`                     | **NOT Hosted** | `devtools://devtools/bundled/devtools_app.html?targetType=tab&...`            |
-     *  | tab URL: `devtools://…?ws=…`                | **NOT Hosted** | `devtools://devtools/bundled/devtools_app.html?ws=localhost:9228/...`         |
-     *  | tab URL: `devtools://…` but no connection   | **NOT Hosted** | `devtools://devtools/bundled/trace_app.html`                                  |
-     *  | tab URL: `https://…` but no connection      | **Hosted**     | `https://chrome-devtools-frontend.appspot.com/serve_rev/@.../trace_app.html`  |
-     *  | tab URL: `http://…?ws=` (connected)         | **Hosted**     | `http://localhost:9222/devtools/inspector.html?ws=localhost:9222/...`         |
-     */
-    isHostedMode() {
-        return true;
-    }
-    setAddExtensionCallback(_callback) {
-        // Extensions are not supported in hosted mode.
-    }
-    async initialTargetId() {
-        return null;
-    }
-    doAidaConversation(_request, _streamId, callback) {
-        callback({
-            error: 'Not implemented',
-        });
-    }
-    registerAidaClientEvent(_request, callback) {
-        callback({
-            error: 'Not implemented',
-        });
-    }
-    aidaCodeComplete(_request, callback) {
-        callback({
-            error: 'Not implemented',
-        });
-    }
-    dispatchHttpRequest(_request, callback) {
-        callback({ error: 'Not implemented' });
-    }
-    recordImpression(_event) {
-    }
-    recordResize(_event) {
-    }
-    recordClick(_event) {
-    }
-    recordHover(_event) {
-    }
-    recordDrag(_event) {
-    }
-    recordChange(_event) {
-    }
-    recordKeyDown(_event) {
-    }
-    recordSettingAccess(_event) {
-    }
-    recordFunctionCall(_event) {
-    }
-    setChromeFlag(_flagName, _value) {
-    }
-}

package/build/vendor/chrome-devtools-frontend/front_end/core/host/Platform.js

@@ -1,61 +0,0 @@
-// Copyright 2014 The Chromium Authors
-// Use of this source code is governed by a BSD-style license that can be
-// found in the LICENSE file.
-/* eslint-disable @typescript-eslint/naming-convention */
-import { InspectorFrontendHostInstance } from './InspectorFrontendHost.js';
-let _platform;
-export function platform() {
-    if (!_platform) {
-        _platform = InspectorFrontendHostInstance.platform();
-    }
-    return _platform;
-}
-let _isMac;
-export function isMac() {
-    if (typeof _isMac === 'undefined') {
-        _isMac = platform() === 'mac';
-    }
-    return _isMac;
-}
-let _isWin;
-export function isWin() {
-    if (typeof _isWin === 'undefined') {
-        _isWin = platform() === 'windows';
-    }
-    return _isWin;
-}
-/**
- * In Chrome Layout tests the imported 'Platform' object is not writable/
- * configurable, which prevents us from monkey-patching 'Platform''s methods.
- * We circumvent this by adding 'setPlatformForTests'.
- **/
-export function setPlatformForTests(platform) {
-    _platform = platform;
-    _isMac = undefined;
-    _isWin = undefined;
-}
-let _isCustomDevtoolsFrontend;
-export function isCustomDevtoolsFrontend() {
-    if (typeof _isCustomDevtoolsFrontend === 'undefined') {
-        _isCustomDevtoolsFrontend = window.location.toString().startsWith('devtools://devtools/custom/');
-    }
-    return _isCustomDevtoolsFrontend;
-}
-let _fontFamily;
-export function fontFamily() {
-    if (_fontFamily) {
-        return _fontFamily;
-    }
-    switch (platform()) {
-        case 'linux':
-            _fontFamily = 'Roboto, Ubuntu, Arial, sans-serif';
-            break;
-        case 'mac':
-            _fontFamily = '\'Lucida Grande\', sans-serif';
-            break;
-        case 'windows':
-            _fontFamily = '\'Segoe UI\', Tahoma, sans-serif';
-            break;
-    }
-    return _fontFamily;
-}