Conversation
Signed-off-by: Ahfu C Kit III <196157628+ahfuckit@users.noreply.github.com>
Signed-off-by: Ahfu C Kit III <196157628+ahfuckit@users.noreply.github.com>
Signed-off-by: Ahfu C Kit III <196157628+ahfuckit@users.noreply.github.com>
Owner
Author
| // 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. // We want to keep this a IIFE as we want to keep the global scope clean // We inject this script via a Classic script // https://crsrc.org/c/third_party/blink/renderer/controller/dev_tools_frontend_impl.cc;l=107 (window => { /** * A function that tries to check the remotely connected instance * major version. You should check against this to provide * forward and backwards compatibility. * * @returns {number\|null} */ function getRemoteMajorVersion() { try { const remoteVersion = new URLSearchParams(window.location.search).get('remoteVersion'); if (!remoteVersion) { return null; } return parseInt(remoteVersion.split('.')[0], 10); } catch { return null; } } // eslint-disable-next-line no-unused-vars const majorVersion = getRemoteMajorVersion(); // DevToolsAPI ---------------------------------------------------------------- /** * @typedef {{runtimeAllowedHosts: string[], runtimeBlockedHosts: string[]}} ExtensionHostsPolicy * @typedef {{startPage: string, name: string, exposeExperimentalAPIs: boolean, hostsPolicy?: ExtensionHostsPolicy}} ExtensionDescriptor */ class DevToolsAPIImpl { /** * @type {string[]} */ _originsForbiddenForExtensions = []; /** * @type {ExtensionDescriptor[]} */ _pendingExtensionDescriptors = []; /** * @type {number} */ _lastCallId = 0; /** * @type {Record void>} */ _callbacks = {}; /** * @type {((param:ExtensionDescriptor)=> void) \| null} */ _addExtensionCallback = null; /** * @type {Promise} */ _initialTargetIdPromise; /** * @type {(param:string) => void} */ _setInitialTargetId; constructor() { this._initialTargetIdPromise = new Promise(resolve => { this._setInitialTargetId = resolve; }); } /** * @param id * @param arg */ embedderMessageAck(id, arg) { const callback = this._callbacks[id]; delete this._callbacks[id]; if (callback) { callback(arg); } } /** * @param method * @param args * @param callback */ sendMessageToEmbedder(method, args, callback) { const callId = ++this._lastCallId; if (callback) { this._callbacks[callId] = callback; } const message = {id: callId, method}; if (args.length) { message.params = args; } DevToolsHost.sendMessageToEmbedder(JSON.stringify(message)); } /** * @typedef {import('./core/host/InspectorFrontendHostAPI.js').Events} Events * @typedef {import('./core/host/InspectorFrontendHost.js').InspectorFrontendAPIImplMethods} Methods * @param {`${Events\|Methods}`} method * @param args */ _dispatchOnInspectorFrontendAPI(method, args) { const inspectorFrontendAPI = window.InspectorFrontendAPI; if (!inspectorFrontendAPI) { // This is the case for device_mode_emulation_frame entrypoint. It's created via `window.open` from // the DevTools window, so it shares a context with DevTools but has a separate DevToolsUIBinding and `window` object. // We can safely ignore the events since they also arrive on the DevTools `window` object. return; } inspectorFrontendAPI[method].apply(inspectorFrontendAPI, args); } // API methods below this line -------------------------------------------- /** * @param {ExtensionDescriptor[]} extensions */ addExtensions(extensions) { // The addExtensions command is sent as the onload event happens for // DevTools front-end. We should buffer this command until the frontend // is ready for it. if (this._addExtensionCallback) { extensions.forEach(this._addExtensionCallback); } else { this._pendingExtensionDescriptors.push(...extensions); } } /** * @param {string[]} forbiddenOrigins */ setOriginsForbiddenForExtensions(forbiddenOrigins) { this._originsForbiddenForExtensions = forbiddenOrigins; } /** * @returns {string[]} */ getOriginsForbiddenForExtensions() { return this._originsForbiddenForExtensions; } /** * @param {string} url */ appendedToURL(url) { this._dispatchOnInspectorFrontendAPI('appendedToURL', [url]); } /** * @param {string} url */ canceledSaveURL(url) { this._dispatchOnInspectorFrontendAPI('canceledSaveURL', [url]); } contextMenuCleared() { this._dispatchOnInspectorFrontendAPI('contextMenuCleared', []); } /** * @param id */ contextMenuItemSelected(id) { this._dispatchOnInspectorFrontendAPI('contextMenuItemSelected', [id]); } /** * @param {number} count */ deviceCountUpdated(count) { this._dispatchOnInspectorFrontendAPI('deviceCountUpdated', [count]); } /** * @param config */ devicesDiscoveryConfigChanged(config) { this._dispatchOnInspectorFrontendAPI('devicesDiscoveryConfigChanged', [config]); } /** * @param status */ devicesPortForwardingStatusChanged(status) { this._dispatchOnInspectorFrontendAPI('devicesPortForwardingStatusChanged', [status]); } /** * @param devices */ devicesUpdated(devices) { this._dispatchOnInspectorFrontendAPI('devicesUpdated', [devices]); } /** * @param message */ dispatchMessage(message) { this._dispatchOnInspectorFrontendAPI('dispatchMessage', [message]); } /** * @param messageChunk * @param messageSize */ dispatchMessageChunk(messageChunk, messageSize) { this._dispatchOnInspectorFrontendAPI('dispatchMessageChunk', [messageChunk, messageSize]); } /** * Edge only: Triggered by DevToolsUIBindings (C++) when the Edge DevTools Enhancements extension * is installed or uninstalled. * @param {boolean} isInstalled */ edgeEnhancementsExtensionStatusChanged(isInstalled) { // todo: This method might be called before InspectorFrontendAPI is instantiated // This obviously has a problem: there isn't a mechanism to dispatch this event // before the dispatcher exists. Need to solve this problem before going public. this._dispatchOnInspectorFrontendAPI('edgeEnhancementsExtensionStatusChanged', [isInstalled]); } enterInspectElementMode() { this._dispatchOnInspectorFrontendAPI('enterInspectElementMode', []); } /** * @param color */ eyeDropperPickedColor(color) { this._dispatchOnInspectorFrontendAPI('eyeDropperPickedColor', [color]); } /** * @param fileSystems */ fileSystemsLoaded(fileSystems) { this._dispatchOnInspectorFrontendAPI('fileSystemsLoaded', [fileSystems]); } /** * @param fileSystemPath */ fileSystemRemoved(fileSystemPath) { this._dispatchOnInspectorFrontendAPI('fileSystemRemoved', [fileSystemPath]); } /** * @param error * @param fileSystem */ fileSystemAdded(error, fileSystem) { this._dispatchOnInspectorFrontendAPI('fileSystemAdded', [error, fileSystem]); } /** * @param changedPaths * @param addedPaths * @param removedPaths */ fileSystemFilesChangedAddedRemoved(changedPaths, addedPaths, removedPaths) { this._dispatchOnInspectorFrontendAPI( 'fileSystemFilesChangedAddedRemoved', [changedPaths, addedPaths, removedPaths]); } /** * @param requestId * @param fileSystemPath * @param totalWork */ indexingTotalWorkCalculated(requestId, fileSystemPath, totalWork) { this._dispatchOnInspectorFrontendAPI('indexingTotalWorkCalculated', [requestId, fileSystemPath, totalWork]); } /** * @param requestId * @param fileSystemPath * @param worked */ indexingWorked(requestId, fileSystemPath, worked) { this._dispatchOnInspectorFrontendAPI('indexingWorked', [requestId, fileSystemPath, worked]); } /** * @param requestId * @param fileSystemPath */ indexingDone(requestId, fileSystemPath) { this._dispatchOnInspectorFrontendAPI('indexingDone', [requestId, fileSystemPath]); } /** * @param event */ keyEventUnhandled(event) { event.keyIdentifier = keyCodeToKeyIdentifier(event.keyCode); this._dispatchOnInspectorFrontendAPI('keyEventUnhandled', [event]); } /** * @param {(param: object) => unknown} callback */ setAddExtensionCallback(callback) { this._addExtensionCallback = callback; if (this._pendingExtensionDescriptors.length) { this._pendingExtensionDescriptors.forEach(this._addExtensionCallback); this._pendingExtensionDescriptors = []; } } /** * @param {boolean} hard */ reloadInspectedPage(hard) { this._dispatchOnInspectorFrontendAPI('reloadInspectedPage', [hard]); } /** * @param url * @param lineNumber * @param columnNumber */ revealSourceLine(url, lineNumber, columnNumber) { this._dispatchOnInspectorFrontendAPI('revealSourceLine', [url, lineNumber, columnNumber]); } /** * @param url * @param fileSystemPath */ savedURL(url, fileSystemPath) { this._dispatchOnInspectorFrontendAPI('savedURL', [url, fileSystemPath]); } /** * @param requestId * @param fileSystemPath * @param files */ searchCompleted(requestId, fileSystemPath, files) { this._dispatchOnInspectorFrontendAPI('searchCompleted', [requestId, fileSystemPath, files]); } colorThemeChanged() { this._dispatchOnInspectorFrontendAPI('colorThemeChanged', []); } /** * @param {string} tabId */ setInspectedTabId(tabId) { this._inspectedTabIdValue = tabId; this._dispatchOnInspectorFrontendAPI('setInspectedTabId', [tabId]); } /** * @param {string} targetId */ setInitialTargetId(targetId) { this._setInitialTargetId(targetId); } /** * @returns */ getInspectedTabId() { return this._inspectedTabIdValue; } /** * @param {boolean} useSoftMenu */ setUseSoftMenu(useSoftMenu) { this._dispatchOnInspectorFrontendAPI('setUseSoftMenu', [useSoftMenu]); } /** * @param {string} panelName */ showPanel(panelName) { this._dispatchOnInspectorFrontendAPI('showPanel', [panelName]); } /** * @param {number} id * @param {string} chunk * @param {boolean} encoded */ streamWrite(id, chunk, encoded) { this._dispatchOnInspectorFrontendAPI('streamWrite', [id, encoded ? this._decodeBase64(chunk) : chunk]); } /** * @param {string} chunk * @returns {string} */ _decodeBase64(chunk) { const request = new XMLHttpRequest(); request.open('GET', 'data:text/plain;base64,' + chunk, false); request.send(null); if (request.status === 200) { return request.responseText; } console.error('Error while decoding chunk in streamWrite'); return ''; } // Edge-only methods -------------------------------------------------------- /** * @param {!boolean} isIE * @Suppress {missingProperties} */ async renderEngineSwitched(isIE) { const uiLegacy = await import('./ui/legacy/legacy.js'); const RenderEngineSwitchedScreen = uiLegacy.RenderEngineSwitchedScreen.RenderEngineSwitchedScreen; if (isIE) { RenderEngineSwitchedScreen.show(); } else { RenderEngineSwitchedScreen.dismiss(); } } } const DevToolsAPI = new DevToolsAPIImpl(); window.DevToolsAPI = DevToolsAPI; // InspectorFrontendHostImpl -------------------------------------------------- /** * Edge specific enum for recordPerformanceHistogram * Warning: There are three definitions of this enum in the DevTools code base, keep them in sync. * @readonly * @enum {string} */ const EdgeEnumeratedHistogram = { PANEL_SHOWN: 'Microsoft.DevTools.PanelShown', UNHANDLED_JAVASCRIPT_ERROR: 'Microsoft.DevTools.UnhandledJavascriptError', THEME_SELECTION: 'Microsoft.DevTools.ThemeSelection', CURRENT_THEME: 'Microsoft.DevTools.CurrentTheme', DEV_TOOLS_APPLICATION_LOCALE: 'Microsoft.LanguageUsage.DevToolsApplicationLocale', DEV_TOOLS_SESSION_PREFERRED_LOCALE: 'Microsoft.LanguageUsage.DevToolsSessionPreferredLocale', DEV_TOOLS_APPLICATION_LOCALE_FALLBACK_FROM: 'Microsoft.LanguageUsage.DevToolsApplicationLocaleFallbackFrom', DOM3_D_PANEL: 'Microsoft.DevTools.Dom3DPanel', LOCALIZATION_SETTING: 'Microsoft.DevTools.LocalizationSetting', MICROSOFT_EXPERIMENT_ENABLED_AT_LAUNCH: 'Microsoft.DevTools.ExperimentEnabledAtLaunch', MICROSOFT_EXPERIMENT_ENABLED: 'Microsoft.DevTools.ExperimentEnabled', MICROSOFT_EXPERIMENT_DISABLED: 'Microsoft.DevTools.ExperimentDisabled', WEBHINT_ISSUE_DOCUMENTATION_OPENED: 'Microsoft.DevTools.WebhintIssueDocumentationOpened', WEBHINT_ISSUE_EXPANDED: 'Microsoft.DevTools.WebhintIssueExpanded', WEBHINT_ISSUE_PANEL_OPENED: 'Microsoft.DevTools.WebhintIssuePanelOpened', WEBHINT_ISSUE_PANEL_OPENED_FROM: 'Microsoft.DevTools.WebhintIssuePanelOpenedFrom', PANEL_OPENED_VIA_PLUS_BUTTON: 'Microsoft.DevTools.PanelOpenedViaPlusButton', TOOLTIPS_ACTION: 'Microsoft.DevTools.TooltipsAction', PANEL_OPENED_VIA_COMMAND_PALETTE: 'Microsoft.DevTools.PanelOpenedViaCommandPalette', PANEL_OPENED_VIA_MORE_TOOLS: 'Microsoft.DevTools.PanelOpenedViaMoreTools', DETACHED_ELEMENTS_PANEL: 'Microsoft.DevTools.DetachedElementsPanel', EDGE_USER_ACTION: 'Microsoft.DevTools.UserAction', CONSOLE_ERROR_SEARCH: 'Microsoft.DevTools.ConsoleErrorSearch', WELCOME_ACTION: 'Microsoft.DevTools.Welcome', ENHANCED_TRACES: 'Microsoft.DevTools.EnhancedTraces', ENHANCED_TRACES_LOAD_SUCCESS: 'Microsoft.DevTools.EnhancedTracesLoadSuccess', SOURCE_MAP_RESOLUTION_RESULT: 'Microsoft.DevTools.SourceMapResolutionResult', PERFORMANCE_PANEL: 'Microsoft.DevTools.PerformancePanel', PERFORMANCE_PANEL_UNMINIFY_TIME: 'Microsoft.DevTools.PerformancePanelUnminifyTime', PERFORMANCE_PANEL_UNMINIFY_SUCCESS_RATIO: 'Microsoft.DevTools.PerformancePanelSuccessRatio', FOCUS_MODE_ACTIONS: 'Microsoft.DevTools.FocusModeActions', FOCUS_MODE_TABS_PINNED: 'Microsoft.DevTools.FocusModeTabsPinned', FOCUS_MODE_DRAWER_PANEL_OPEN: 'Microsoft.DevTools.FocusModeDrawerPanelOpen', EXTENSIONS_ACTION: 'Microsoft.DevTools.ExtensionsAction', ADAPTIVE_CPU_THROTTLING_ACTION: 'Microsoft.DevTools.AdaptiveCPUThrottlingAction', ADAPTIVE_CPU_THROTTLING_BENCHMARK: 'Microsoft.DevTools.AdaptiveCPUThrottlingBenchmark', AUTOMATIC_EMULATION_AT_LAUNCH_STATE: 'Microsoft.DevTools.AutomaticEmulationAtLaunchState', AUTOMATIC_EMULATION_ACTION: 'Microsoft.DevTools.AutomaticEmulationAction', HEAP_SNAPSHOT_VIEW_SHOWN: 'Microsoft.DevTools.HeapSnapshotViewShown', NETWORK_CONSOLE_REQUEST_FEATURE: 'Microsoft.DevTools.NetworkConsoleRequestFeature', NETWORK_CONSOLE_REQUEST_VERB: 'Microsoft.DevTools.NetworkConsoleRequestVerb', NETWORK_CONSOLE_ACTION: 'Microsoft.DevTools.NetworkConsoleAction', AUTOMATIC_UNMINIFY_SOURCE_MAPPED_SCRIPT_RATIO: 'Microsoft.DevTools.AutomaticUnminifySourceMappedScriptRatio', AUTOMATIC_UNMINIFY_SUCCESS_RATIO: 'Microsoft.DevTools.AutomaticUnminifySuccessRatio', AUTOMATIC_UNMINIFY_TIME: 'Microsoft.DevTools.AutomaticUnminifyTime', }; /** * Enum for recordPerformanceHistogram * Warning: There is another definition of this enum in the DevTools code * base, keep them in sync: * front_end/core/host/InspectorFrontendHostAPI.ts * @readonly * @enum {string} */ const EnumeratedHistogram = { // LINT.IfChange(EnumeratedHistogram) ActionTaken: 'DevTools.ActionTaken', DeveloperResourceLoaded: 'DevTools.DeveloperResourceLoaded', DeveloperResourceScheme: 'DevTools.DeveloperResourceScheme', ExperimentDisabled: 'DevTools.ExperimentDisabled', ExperimentDisabledAtLaunch: 'DevTools.ExperimentDisabledAtLaunch', ExperimentEnabled: 'DevTools.ExperimentEnabled', ExperimentEnabledAtLaunch: 'DevTools.ExperimentEnabledAtLaunch', IssueCreated: 'DevTools.IssueCreated', IssuesPanelIssueExpanded: 'DevTools.IssuesPanelIssueExpanded', IssuesPanelOpenedFrom: 'DevTools.IssuesPanelOpenedFrom', IssuesPanelResourceOpened: 'DevTools.IssuesPanelResourceOpened', KeybindSetSettingChanged: 'DevTools.KeybindSetSettingChanged', KeyboardShortcutFired: 'DevTools.KeyboardShortcutFired', Language: 'DevTools.Language', LighthouseModeRun: 'DevTools.LighthouseModeRun', LighthouseCategoryUsed: 'DevTools.LighthouseCategoryUsed', PanelShown: 'DevTools.PanelShown', RecordingAssertion: 'DevTools.RecordingAssertion', RecordingCodeToggled: 'DevTools.RecordingCodeToggled', RecordingCopiedToClipboard: 'DevTools.RecordingCopiedToClipboard', RecordingEdited: 'DevTools.RecordingEdited', RecordingExported: 'DevTools.RecordingExported', RecordingReplayFinished: 'DevTools.RecordingReplayFinished', RecordingReplaySpeed: 'DevTools.RecordingReplaySpeed', RecordingReplayStarted: 'DevTools.RecordingReplayStarted', RecordingToggled: 'DevTools.RecordingToggled', SourcesPanelFileDebugged: 'DevTools.SourcesPanelFileDebugged', SourcesPanelFileOpened: 'DevTools.SourcesPanelFileOpened', NetworkPanelResponsePreviewOpened: 'DevTools.NetworkPanelResponsePreviewOpened', TimelineNavigationSettingState: 'DevTools.TimelineNavigationSettingState', SyncSetting: 'DevTools.SyncSetting', SwatchActivated: 'DevTools.SwatchActivated', ...EdgeEnumeratedHistogram, BuiltInAiAvailability: 'DevTools.BuiltInAiAvailability' // LINT.ThenChange(/front_end/core/host/InspectorFrontendHostAPI.ts:EnumeratedHistogram) }; let createFileSelectorCallback; /** * @typedef {import('./core/host/InspectorFrontendHostAPI.js').InspectorFrontendHostAPI} InspectorFrontendHostAPI * @implements {InspectorFrontendHostAPI} */ class InspectorFrontendHostImpl { /** * Update inside `front_end/core/host/InspectorFrontendHost.ts:627` * @type {any} */ events; /** * @returns */ getSelectionForegroundColor() { return '#ffffff'; } /** * @returns */ getInactiveSelectionBackgroundColor() { return '#c9c8c8'; } /** * @returns */ getInactiveSelectionForegroundColor() { return '#323232'; } /** * @param {string} type * @param {string} message * @param {string} stack * @param {string} filename * @param {string} sourceUrl * @param {number} lineno * @param {number} colno */ reportError(type, message, stack, filename, sourceUrl, lineno, colno) { DevToolsAPI.sendMessageToEmbedder( 'reportError', [type, message, stack, filename, sourceUrl, lineno.toString(), colno.toString()], null); } /** * @param {number} itemId * @param {string} serviceId * @param {string} vote * @param {function(!InspectorFrontendHostAPI.MicroFeedbackVoteResult): void } callback */ sendMicroFeedbackVote(itemId, serviceId, vote, callback) { DevToolsAPI.sendMessageToEmbedder('sendMicroFeedbackVote', [itemId, serviceId, vote], callback); } /** * Edge only command to open source file in Visual Studio Code. * @OverRide * @param {string} workspace * @param {string=} file */ openFileInVSCode(workspace, file) { DevToolsAPI.sendMessageToEmbedder('openFileInVSCode', [workspace, file], null); } /** * Edge only command to open the AI copilot chat sidebar and ask a question. * @OverRide * @param {string} question * @param {string} prompt * @param {string} context * @param {number} action */ openAICopilotChatSidebar(question, prompt, context, action) { DevToolsAPI.sendMessageToEmbedder( 'openAICopilotChatSidebar', [question, prompt \|\| '', context \|\| '', action \|\| 1], null); } /** * Edge only command to launch an enhanced logfile window. * @OverRide */ launchEnhancedLogfileWindow(_file) { DevToolsAPI.sendMessageToEmbedder('launchEnhancedLogfileWindow', [], null); // unusued parameter: _file } openFileForPossibleCrossProcessImport(type = 'all-supported-types') { return new Promise(resolve => { DevToolsAPI.sendMessageToEmbedder('openFileForPossibleCrossProcessImport', [type], resolve); }); } openLogFile(filePath) { return DevToolsHost.openLogFile(filePath); } isUrlInspectionDenyListed(url) { return DevToolsHost.isUrlInspectionDenyListed(url); } /** * Edge only command to retrieve an enhanced logfile. Will only return the value once. * @OverRide * @returns {!Promise} */ obtainLogfilePath() { return new Promise(resolve => { DevToolsAPI.sendMessageToEmbedder('obtainLogfilePath', [], resolve); }); } setCreateFileSelectorCallback(creator) { createFileSelectorCallback = creator; } /** * * @returns */ createFileSelectorElement(callback, options = {}) { if (!createFileSelectorCallback) { throw new ReferenceError('File selector creator not yet initialized.'); } return createFileSelectorCallback(callback, options); } tryGetAADAuthorizationForAzureDevOps(tryInteractively, callback) { DevToolsAPI.sendMessageToEmbedder('tryGetAadAuthorizationTokenForAzureDevOps', [tryInteractively], callback); } /** * @param {number} itemId * @param {string} serviceId * @param {string} vote * @param {string} clientFeedbackId * @param {string} question * @param {string} questionId * @param {string} answer * @param {string} answerId */ sendMicroFeedbackFollowUpInfo(itemId, serviceId, vote, clientFeedbackId, question, questionId, answer, answerId) { DevToolsAPI.sendMessageToEmbedder( 'sendMicroFeedbackFollowUpInfo', [itemId, serviceId, vote, clientFeedbackId, question, questionId, answer, answerId], null); } /** * @returns */ getSelectionBackgroundColor() { return '#6e86ff'; } /** * @returns */ getSelectionForegroundColor() { return '#ffffff'; } /** * @returns */ getInactiveSelectionBackgroundColor() { return '#c9c8c8'; } /** * @returns */ getInactiveSelectionForegroundColor() { return '#323232'; } /** * @returns */ platform() { return DevToolsHost.platform(); } loadCompleted() { DevToolsAPI.sendMessageToEmbedder('loadCompleted', [], null); } bringToFront() { DevToolsAPI.sendMessageToEmbedder('bringToFront', [], null); } closeWindow() { DevToolsAPI.sendMessageToEmbedder('closeWindow', [], null); } /** * @param isDocked * @param callback */ setIsDocked(isDocked, callback) { DevToolsAPI.sendMessageToEmbedder('setIsDocked', [isDocked], callback); } /** * @param {DockState} DockState */ setDockState(dockState) { DevToolsAPI.sendMessageToEmbedder('setDockState', [dockState], null); } /** * @param {boolean} isVisible */ toggleDeviceMode(isVisible) { DevToolsAPI.sendMessageToEmbedder('toggleDeviceMode', [isVisible], null); } /** * @param trigger * @param {(param: object) => unknown} callback */ showSurvey(trigger, callback) { DevToolsAPI.sendMessageToEmbedder('showSurvey', [trigger], callback); } /** * @param trigger * @param {(param: object) => unknown} callback */ canShowSurvey(trigger, callback) { // Edge-only: we override the content of this method in Edge to always call the callback // with 'false' instead of calling DevToolsAPI.sendMessageToEmbedder like upstream does. // This is because we don't want to display surveys in Edge DevTools. setTimeout(() => callback({canShowSurvey: false}), 0); } /** * Requests inspected page to be placed atop of the inspector frontend with specified bounds. * @param bounds */ setInspectedPageBounds(bounds) { DevToolsAPI.sendMessageToEmbedder('setInspectedPageBounds', [bounds], null); } inspectElementCompleted() { DevToolsAPI.sendMessageToEmbedder('inspectElementCompleted', [], null); } /** * @param url * @param headers * @param streamId * @param {(param: object) => unknown} callback */ loadNetworkResource(url, headers, streamId, callback) { DevToolsAPI.sendMessageToEmbedder('loadNetworkResource', [url, headers, streamId], callback); } /** * @param name * @param options */ registerPreference(name, options) { DevToolsAPI.sendMessageToEmbedder('registerPreference', [name, options], null); } /** * @param {(param: object) => unknown} callback */ getPreferences(callback) { DevToolsAPI.sendMessageToEmbedder('getPreferences', [], callback); } /** * @param name * @param {(param: object) => unknown} callback */ getPreference(name, callback) { DevToolsAPI.sendMessageToEmbedder('getPreference', [name], callback); } /** * @param name * @param value */ setPreference(name, value) { DevToolsAPI.sendMessageToEmbedder('setPreference', [name, value], null); } /** * @param name */ removePreference(name) { DevToolsAPI.sendMessageToEmbedder('removePreference', [name], null); } clearPreferences() { DevToolsAPI.sendMessageToEmbedder('clearPreferences', [], null); } /** * @param callback */ getSyncInformation(callback) { DevToolsAPI.sendMessageToEmbedder('getSyncInformation', [], callback); } /** * @param callback */ getHostConfig(callback) { DevToolsAPI.sendMessageToEmbedder('getHostConfig', [], hostConfig => { const majorVersion = getRemoteMajorVersion(); if (majorVersion && majorVersion < 129 && hostConfig?.aidaAvailability) { return callback(this.hostConfigNewToOld(hostConfig)); } return callback(hostConfig); }); } /** * @param newConfig */ hostConfigNewToOld(newConfig) { const devToolsConsoleInsights = { enabled: (newConfig.devToolsConsoleInsights?.enabled && newConfig.aidaAvailability?.enabled) ?? false, aidaModelId: newConfig.devToolsConsoleInsights?.modelId ?? '', aidaTemperature: newConfig.devToolsConsoleInsights?.temperature ?? 0, blockedByAge: newConfig.aidaAvailability?.blockedByAge ?? true, blockedByEnterprisePolicy: newConfig.aidaAvailability?.blockedByEnterprisePolicy ?? true, blockedByFeatureFlag: (newConfig.devToolsConsoleInsights?.enabled && newConfig.aidaAvailability?.enabled) ?? false, blockedByGeo: newConfig.aidaAvailability?.blockedByGeo ?? true, blockedByRollout: false, disallowLogging: newConfig.aidaAvailability?.disallowLogging ?? true, optIn: false }; const devToolsFreestylerDogfood = { enabled: (newConfig.devToolsFreestyler?.enabled && newConfig.aidaAvailability?.enabled) ?? false, aidaModelId: newConfig.devToolsFreestyler?.modelId ?? '', aidaTemperature: newConfig.devToolsFreestyler?.temperature ?? 0, blockedByAge: newConfig.aidaAvailability?.blockedByAge ?? true, blockedByEnterprisePolicy: newConfig.aidaAvailability?.blockedByEnterprisePolicy ?? true, blockedByGeo: newConfig.aidaAvailability?.blockedByGeo ?? true }; return { devToolsConsoleInsights, devToolsFreestylerDogfood, devToolsVeLogging: newConfig.devToolsVeLogging, isOffTheRecord: newConfig.isOffTheRecord }; } /** * @param origin * @param script */ setInjectedScriptForOrigin(origin, script) { DevToolsAPI.sendMessageToEmbedder('registerExtensionsAPI', [origin, script], null); } /** * @param url */ inspectedURLChanged(url) { DevToolsAPI.sendMessageToEmbedder('inspectedURLChanged', [url], null); } /** * @param text */ copyText(text) { DevToolsHost.copyText(text); } /** * @param url */ openInNewTab(url) { DevToolsAPI.sendMessageToEmbedder('openInNewTab', [url], null); } /** * @param query */ openSearchResultsInNewTab(query) { DevToolsAPI.sendMessageToEmbedder('openSearchResultsInNewTab', [query], null); } /** * @param fileSystemPath */ showItemInFolder(fileSystemPath) { DevToolsAPI.sendMessageToEmbedder('showItemInFolder', [fileSystemPath], null); } /** * @param url * @param content * @param forceSaveAs * @param isBase64 */ save(url, content, forceSaveAs, isBase64) { DevToolsAPI.sendMessageToEmbedder('save', [url, content, forceSaveAs, isBase64], null); } /** * @param url * @param content */ append(url, content) { DevToolsAPI.sendMessageToEmbedder('append', [url, content], null); } /** * @param {string} _url */ close(_url) { // This is required when InspectorFrontendHostStub is used } /** * @param message */ sendMessageToBackend(message) { DevToolsAPI.sendMessageToEmbedder('dispatchProtocolMessage', [message], null); } /** * @param histogramName * @param sample * @param min * @param exclusiveMax * @param bucketSize */ recordCountHistogram(histogramName, sample, min, exclusiveMax, bucketSize) { DevToolsAPI.sendMessageToEmbedder( 'recordCountHistogram', [histogramName, sample, min, exclusiveMax, bucketSize], null); } /** * @param actionName * @param actionCode * @param bucketSize */ recordEnumeratedHistogram(actionName, actionCode, bucketSize) { if (!Object.values(EnumeratedHistogram).includes(actionName)) { return; } DevToolsAPI.sendMessageToEmbedder('recordEnumeratedHistogram', [actionName, actionCode, bucketSize], null); } /** * @param histogramName * @param duration */ recordPerformanceHistogram(histogramName, duration) { DevToolsAPI.sendMessageToEmbedder('recordPerformanceHistogram', [histogramName, duration], null); } /** * @param featureName */ recordNewBadgeUsage(featureName) { DevToolsAPI.sendMessageToEmbedder('recordNewBadgeUsage', [featureName], null); } /** * @param umaName */ recordUserMetricsAction(umaName) { DevToolsAPI.sendMessageToEmbedder('recordUserMetricsAction', [umaName], null); } /** * @param {string} umaName */ recordMemoryHistogram(histogramName, value) { DevToolsAPI.sendMessageToEmbedder('recordMemoryHistogram', [histogramName, value], null); } recordPercentageHistogram(histogramName, value) { value = value \| 0; // coerce to integer DevToolsAPI.sendMessageToEmbedder('recordPercentageHistogram', [histogramName, value], null); } connectAutomaticFileSystem(fileSystemPath, fileSystemUUID, addIfMissing, callback) { DevToolsAPI.sendMessageToEmbedder( 'connectAutomaticFileSystem', [fileSystemPath, fileSystemUUID, addIfMissing], callback, ); } disconnectAutomaticFileSystem(fileSystemPath) { DevToolsAPI.sendMessageToEmbedder( 'disconnectAutomaticFileSystem', [fileSystemPath], null, ); } requestFileSystems() { DevToolsAPI.sendMessageToEmbedder('requestFileSystems', [], null); } /** * @param type */ addFileSystem(type) { DevToolsAPI.sendMessageToEmbedder('addFileSystem', [type \|\| ''], null); } /** * @param fileSystemPath */ removeFileSystem(fileSystemPath) { DevToolsAPI.sendMessageToEmbedder('removeFileSystem', [fileSystemPath], null); } /** * @param fileSystemId * @param registeredName * @returns */ isolatedFileSystem(fileSystemId, registeredName) { return DevToolsHost.isolatedFileSystem(fileSystemId, registeredName); } /** * @param fileSystem */ upgradeDraggedFileSystemPermissions(fileSystem) { DevToolsHost.upgradeDraggedFileSystemPermissions(fileSystem); } /** * @param requestId * @param fileSystemPath * @param excludedFolders */ indexPath(requestId, fileSystemPath, excludedFolders) { // \|excludedFolders\| added in M67. For backward compatibility, // pass empty array. excludedFolders = excludedFolders \|\| '[]'; DevToolsAPI.sendMessageToEmbedder('indexPath', [requestId, fileSystemPath, excludedFolders], null); } /** * @param requestId */ stopIndexing(requestId) { DevToolsAPI.sendMessageToEmbedder('stopIndexing', [requestId], null); } /** * @param requestId * @param fileSystemPath * @param query */ searchInPath(requestId, fileSystemPath, query) { DevToolsAPI.sendMessageToEmbedder('searchInPath', [requestId, fileSystemPath, query], null); } /** * @returns */ zoomFactor() { return DevToolsHost.zoomFactor(); } zoomIn() { DevToolsAPI.sendMessageToEmbedder('zoomIn', [], null); } zoomOut() { DevToolsAPI.sendMessageToEmbedder('zoomOut', [], null); } resetZoom() { DevToolsAPI.sendMessageToEmbedder('resetZoom', [], null); } /** * @param shortcuts */ setWhitelistedShortcuts(shortcuts) { DevToolsAPI.sendMessageToEmbedder('setWhitelistedShortcuts', [shortcuts], null); } /** * @param active */ setEyeDropperActive(active) { DevToolsAPI.sendMessageToEmbedder('setEyeDropperActive', [active], null); } /** * @param certChain */ showCertificateViewer(certChain) { DevToolsAPI.sendMessageToEmbedder('showCertificateViewer', [JSON.stringify(certChain)], null); } /** * Only needed to run Lighthouse on old devtools. * @param callback */ reattach(callback) { DevToolsAPI.sendMessageToEmbedder('reattach', [], callback); } readyForTest() { DevToolsAPI.sendMessageToEmbedder('readyForTest', [], null); } connectionReady() { DevToolsAPI.sendMessageToEmbedder('connectionReady', [], null); } /** * @param value */ setOpenNewWindowForPopups(value) { DevToolsAPI.sendMessageToEmbedder('setOpenNewWindowForPopups', [value], null); } /** * @param config */ setDevicesDiscoveryConfig(config) { DevToolsAPI.sendMessageToEmbedder( 'setDevicesDiscoveryConfig', [ config.discoverUsbDevices, config.portForwardingEnabled, JSON.stringify(config.portForwardingConfig), config.networkDiscoveryEnabled, JSON.stringify(config.networkDiscoveryConfig) ], null); } /** * @param enabled */ setDevicesUpdatesEnabled(enabled) { DevToolsAPI.sendMessageToEmbedder('setDevicesUpdatesEnabled', [enabled], null); } /** * @param browserId * @param url */ openRemotePage(browserId, url) { DevToolsAPI.sendMessageToEmbedder('openRemotePage', [browserId, url], null); } openSendFeedbackDialog() { DevToolsAPI.sendMessageToEmbedder('openSendFeedbackDialog', [], null); } openNodeFrontend() { DevToolsAPI.sendMessageToEmbedder('openNodeFrontend', [], null); } /** * @param x * @param y * @param items * @param document */ showContextMenuAtPoint(x, y, items, document) { DevToolsHost.showContextMenuAtPoint(x, y, items, document); } /** * @returns */ isHostedMode() { return DevToolsHost.isHostedMode(); } /** * @param callback */ setAddExtensionCallback(callback) { DevToolsAPI.setAddExtensionCallback(callback); } /** * @param impressionEvent */ recordImpression(impressionEvent) { DevToolsAPI.sendMessageToEmbedder('recordImpression', [impressionEvent], null); } /** * @param resizeEvent */ recordResize(resizeEvent) { DevToolsAPI.sendMessageToEmbedder('recordResize', [resizeEvent], null); } /** * @param clickEvent */ recordClick(clickEvent) { DevToolsAPI.sendMessageToEmbedder('recordClick', [clickEvent], null); } /** * @param hoverEvent */ recordHover(hoverEvent) { DevToolsAPI.sendMessageToEmbedder('recordHover', [hoverEvent], null); } /** * @param dragEvent */ recordDrag(dragEvent) { DevToolsAPI.sendMessageToEmbedder('recordDrag', [dragEvent], null); } /** * @param changeEvent */ recordChange(changeEvent) { DevToolsAPI.sendMessageToEmbedder('recordChange', [changeEvent], null); } /** * @param keyDownEvent */ recordKeyDown(keyDownEvent) { DevToolsAPI.sendMessageToEmbedder('recordKeyDown', [keyDownEvent], null); } /** * @param settingAccessEvent */ recordSettingAccess(settingAccessEvent) { DevToolsAPI.sendMessageToEmbedder('recordSettingAccess', [settingAccessEvent], null); } /** * @param functionCallEvent */ recordFunctionCall(functionCallEvent) { DevToolsAPI.sendMessageToEmbedder('recordFunctionCall', [functionCallEvent], null); } // Backward-compatible methods below this line -------------------------------------------- /** * Support for legacy front-ends (} */ const styleRules = []; // Shadow DOM V0 polyfill if (majorVersion <= 73 && !Element.prototype.createShadowRoot) { Element.prototype.createShadowRoot = function() { try { return this.attachShadow({mode: 'open'}); } catch { // some elements we use to add shadow roots can no // longer have shadow roots. const fakeShadowHost = document.createElement('span'); this.appendChild(fakeShadowHost); fakeShadowHost.className = 'fake-shadow-host'; return fakeShadowHost.createShadowRoot(); } }; const origAdd = DOMTokenList.prototype.add; DOMTokenList.prototype.add = function(...tokens) { if (tokens[0].startsWith('insertion-point') \|\| tokens[0].startsWith('tabbed-pane-header')) { this._myElement.slot = '.' + tokens[0]; } return origAdd.apply(this, tokens); }; const origCreateElement = Document.prototype.createElement; Document.prototype.createElement = function(tagName, ...rest) { if (tagName === 'content') { tagName = 'slot'; } const element = origCreateElement.call(this, tagName, ...rest); element.classList._myElement = element; return element; }; Object.defineProperty(HTMLSlotElement.prototype, 'select', { set(selector) { this.name = selector; } }); } // Custom Elements V0 polyfill if (majorVersion <= 73 && !Document.prototype.hasOwnProperty('registerElement')) { const fakeRegistry = new Map(); Document.prototype.registerElement = function(typeExtension, options) { const {prototype, extends: localName} = options; const document = this; const callback = function() { const element = document.createElement(localName \|\| typeExtension); const skip = new Set(['constructor', '__proto__']); for (const key of Object.keys(Object.getOwnPropertyDescriptors(prototype.__proto__ \|\| {}))) { if (skip.has(key)) { continue; } element[key] = prototype[key]; } element.setAttribute('is', typeExtension); if (element['createdCallback']) { element['createdCallback'](); } return element; }; fakeRegistry.set(typeExtension, callback); return callback; }; const origCreateElement = Document.prototype.createElement; Document.prototype.createElement = function(tagName, fakeCustomElementType) { const fakeConstructor = fakeRegistry.get(fakeCustomElementType); if (fakeConstructor) { return fakeConstructor(); } return origCreateElement.call(this, tagName, fakeCustomElementType); }; // DevTools front-ends mistakenly assume that // classList.toggle('a', undefined) works as // classList.toggle('a', false) rather than as // classList.toggle('a'); const originalDOMTokenListToggle = DOMTokenList.prototype.toggle; DOMTokenList.prototype.toggle = function(token, force) { if (arguments.length === 1) { force = !this.contains(token); } return originalDOMTokenListToggle.call(this, token, Boolean(force)); }; } if (majorVersion <= 66) { /** @type {(!function(number, number):Element\|undefined)} */ ShadowRoot.prototype.__originalShadowRootElementFromPoint; if (!ShadowRoot.prototype.__originalShadowRootElementFromPoint) { ShadowRoot.prototype.__originalShadowRootElementFromPoint = ShadowRoot.prototype.elementFromPoint; /** * @param x * @param y * @returns */ ShadowRoot.prototype.elementFromPoint = function(x, y) { const originalResult = ShadowRoot.prototype.__originalShadowRootElementFromPoint.apply(this, arguments); if (this.host && originalResult === this.host) { return null; } return originalResult; }; } } if (majorVersion <= 71) { styleRules.push( '.coverage-toolbar-container, .animation-timeline-toolbar-container, .computed-properties { flex-basis: auto; }'); } installExtraStyleRules(styleRules); } /** * @param styleRules */ function installExtraStyleRules(styleRules) { if (!styleRules.length) { return; } const styleText = styleRules.join('\n'); document.head.appendChild(createStyleElement(styleText)); const origCreateShadowRoot = HTMLElement.prototype.createShadowRoot; HTMLElement.prototype.createShadowRoot = function(...args) { const shadowRoot = origCreateShadowRoot.call(this, ...args); shadowRoot.appendChild(createStyleElement(styleText)); return shadowRoot; }; } /** * @param styleText * @returns */ function createStyleElement(styleText) { const style = document.createElement('style'); style.textContent = styleText; return style; } installBackwardsCompatibility(); })(window); |
Owner
Author
|
// Copyright 2014 The Chromium Authors // We want to keep this a IIFE as we want to keep the global scope clean
function getRemoteMajorVersion() { // DevToolsAPI ----------------------------------------------------------------
} const DevToolsAPI = new DevToolsAPIImpl(); // InspectorFrontendHostImpl --------------------------------------------------
/**
let createFileSelectorCallback; /**
} window.InspectorFrontendHost = new InspectorFrontendHostImpl(); // DevToolsApp --------------------------------------------------------------- const staticKeyIdentifiers = new Map([ /**
function installBackwardsCompatibility() { } /**
} /**
installBackwardsCompatibility(); |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
SECRET_DO_NOT_PASS_THIS_OR_YOU_WILL_BE_FIRED"!==o){var s=new Error("Calling PropTypes validators directly is not supported by the
prop-typespackage. Use PropTypes.checkPropTypes() to call them. Read more at http://fb.me/use-check-prop-types");