patchright-core 1.48.2

package/lib/server/debugController.js

@@ -0,0 +1,234 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.DebugController = void 0;
+var _processLauncher = require("../utils/processLauncher");
+var _instrumentation = require("./instrumentation");
+var _recorder = require("./recorder");
+var _recorderApp = require("./recorder/recorderApp");
+var _utils = require("../utils");
+/**
+ * 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.
+ */
+
+const internalMetadata = (0, _instrumentation.serverSideCallMetadata)();
+class DebugController extends _instrumentation.SdkObject {
+  constructor(playwright) {
+    super({
+      attribution: {
+        isInternalPlaywright: true
+      },
+      instrumentation: (0, _instrumentation.createInstrumentation)()
+    }, undefined, 'DebugController');
+    this._autoCloseTimer = void 0;
+    // TODO: remove in 1.27
+    this._autoCloseAllowed = false;
+    this._trackHierarchyListener = void 0;
+    this._playwright = void 0;
+    this._sdkLanguage = 'javascript';
+    this._codegenId = 'playwright-test';
+    this._playwright = playwright;
+  }
+  initialize(codegenId, sdkLanguage) {
+    this._codegenId = codegenId;
+    this._sdkLanguage = sdkLanguage;
+  }
+  setAutoCloseAllowed(allowed) {
+    this._autoCloseAllowed = allowed;
+  }
+  dispose() {
+    this.setReportStateChanged(false);
+    this.setAutoCloseAllowed(false);
+  }
+  setReportStateChanged(enabled) {
+    if (enabled && !this._trackHierarchyListener) {
+      this._trackHierarchyListener = {
+        onPageOpen: () => this._emitSnapshot(),
+        onPageClose: () => this._emitSnapshot()
+      };
+      this._playwright.instrumentation.addListener(this._trackHierarchyListener, null);
+    } else if (!enabled && this._trackHierarchyListener) {
+      this._playwright.instrumentation.removeListener(this._trackHierarchyListener);
+      this._trackHierarchyListener = undefined;
+    }
+  }
+  async resetForReuse() {
+    const contexts = new Set();
+    for (const page of this._playwright.allPages()) contexts.add(page.context());
+    for (const context of contexts) await context.resetForReuse(internalMetadata, null);
+  }
+  async navigate(url) {
+    for (const p of this._playwright.allPages()) await p.mainFrame().goto(internalMetadata, url);
+  }
+  async setRecorderMode(params) {
+    // TODO: |file| is only used in the legacy mode.
+    await this._closeBrowsersWithoutPages();
+    if (params.mode === 'none') {
+      for (const recorder of await this._allRecorders()) {
+        recorder.hideHighlightedSelector();
+        recorder.setMode('none');
+      }
+      this.setAutoCloseEnabled(true);
+      return;
+    }
+    if (!this._playwright.allBrowsers().length) await this._playwright.chromium.launch(internalMetadata, {
+      headless: !!process.env.PW_DEBUG_CONTROLLER_HEADLESS
+    });
+    // Create page if none.
+    const pages = this._playwright.allPages();
+    if (!pages.length) {
+      const [browser] = this._playwright.allBrowsers();
+      const {
+        context
+      } = await browser.newContextForReuse({}, internalMetadata);
+      await context.newPage(internalMetadata);
+    }
+    // Update test id attribute.
+    if (params.testIdAttributeName) {
+      for (const page of this._playwright.allPages()) page.context().selectors().setTestIdAttributeName(params.testIdAttributeName);
+    }
+    // Toggle the mode.
+    for (const recorder of await this._allRecorders()) {
+      recorder.hideHighlightedSelector();
+      if (params.mode !== 'inspecting') recorder.setOutput(this._codegenId, params.file);
+      recorder.setMode(params.mode);
+    }
+    this.setAutoCloseEnabled(true);
+  }
+  async setAutoCloseEnabled(enabled) {
+    if (!this._autoCloseAllowed) return;
+    if (this._autoCloseTimer) clearTimeout(this._autoCloseTimer);
+    if (!enabled) return;
+    const heartBeat = () => {
+      if (!this._playwright.allPages().length) (0, _processLauncher.gracefullyProcessExitDoNotHang)(0);else this._autoCloseTimer = setTimeout(heartBeat, 5000);
+    };
+    this._autoCloseTimer = setTimeout(heartBeat, 30000);
+  }
+  async highlight(selector) {
+    for (const recorder of await this._allRecorders()) recorder.setHighlightedSelector(this._sdkLanguage, selector);
+  }
+  async hideHighlight() {
+    // Hide all active recorder highlights.
+    for (const recorder of await this._allRecorders()) recorder.hideHighlightedSelector();
+    // Hide all locator.highlight highlights.
+    await this._playwright.hideHighlight();
+  }
+  allBrowsers() {
+    return [...this._playwright.allBrowsers()];
+  }
+  async resume() {
+    for (const recorder of await this._allRecorders()) recorder.resume();
+  }
+  async kill() {
+    (0, _processLauncher.gracefullyProcessExitDoNotHang)(0);
+  }
+  async closeAllBrowsers() {
+    await Promise.all(this.allBrowsers().map(browser => browser.close({
+      reason: 'Close all browsers requested'
+    })));
+  }
+  _emitSnapshot() {
+    const browsers = [];
+    let pageCount = 0;
+    for (const browser of this._playwright.allBrowsers()) {
+      const b = {
+        contexts: []
+      };
+      browsers.push(b);
+      for (const context of browser.contexts()) {
+        const c = {
+          pages: []
+        };
+        b.contexts.push(c);
+        for (const page of context.pages()) c.pages.push(page.mainFrame().url());
+        pageCount += context.pages().length;
+      }
+    }
+    this.emit(DebugController.Events.StateChanged, {
+      pageCount
+    });
+  }
+  async _allRecorders() {
+    const contexts = new Set();
+    for (const page of this._playwright.allPages()) contexts.add(page.context());
+    const result = await Promise.all([...contexts].map(c => _recorder.Recorder.showInspector(c, {
+      omitCallTracking: true
+    }, () => Promise.resolve(new InspectingRecorderApp(this)))));
+    return result.filter(Boolean);
+  }
+  async _closeBrowsersWithoutPages() {
+    for (const browser of this._playwright.allBrowsers()) {
+      for (const context of browser.contexts()) {
+        if (!context.pages().length) await context.close({
+          reason: 'Browser collected'
+        });
+      }
+      if (!browser.contexts()) await browser.close({
+        reason: 'Browser collected'
+      });
+    }
+  }
+}
+exports.DebugController = DebugController;
+DebugController.Events = {
+  StateChanged: 'stateChanged',
+  InspectRequested: 'inspectRequested',
+  SourceChanged: 'sourceChanged',
+  Paused: 'paused',
+  SetModeRequested: 'setModeRequested'
+};
+class InspectingRecorderApp extends _recorderApp.EmptyRecorderApp {
+  constructor(debugController) {
+    super();
+    this._debugController = void 0;
+    this._debugController = debugController;
+  }
+  async setSelector(selector) {
+    const locator = (0, _utils.asLocator)(this._debugController._sdkLanguage, selector);
+    this._debugController.emit(DebugController.Events.InspectRequested, {
+      selector,
+      locator
+    });
+  }
+  async setSources(sources) {
+    const source = sources.find(s => s.id === this._debugController._codegenId);
+    const {
+      text,
+      header,
+      footer,
+      actions
+    } = source || {
+      text: ''
+    };
+    this._debugController.emit(DebugController.Events.SourceChanged, {
+      text,
+      header,
+      footer,
+      actions
+    });
+  }
+  async setPaused(paused) {
+    this._debugController.emit(DebugController.Events.Paused, {
+      paused
+    });
+  }
+  async setMode(mode) {
+    this._debugController.emit(DebugController.Events.SetModeRequested, {
+      mode
+    });
+  }
+}

package/lib/server/debugger.js

@@ -0,0 +1,132 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.Debugger = void 0;
+exports.shouldSlowMo = shouldSlowMo;
+var _events = require("events");
+var _utils = require("../utils");
+var _browserContext = require("./browserContext");
+var _debug = require("../protocol/debug");
+/**
+ * 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.
+ */
+
+const symbol = Symbol('Debugger');
+class Debugger extends _events.EventEmitter {
+  constructor(context) {
+    super();
+    this._pauseOnNextStatement = false;
+    this._pausedCallsMetadata = new Map();
+    this._enabled = void 0;
+    this._context = void 0;
+    this._muted = false;
+    this._slowMo = void 0;
+    this._context = context;
+    this._context[symbol] = this;
+    this._enabled = (0, _utils.debugMode)() === 'inspector';
+    if (this._enabled) this.pauseOnNextStatement();
+    context.instrumentation.addListener(this, context);
+    this._context.once(_browserContext.BrowserContext.Events.Close, () => {
+      this._context.instrumentation.removeListener(this);
+    });
+    this._slowMo = this._context._browser.options.slowMo;
+  }
+  async setMuted(muted) {
+    this._muted = muted;
+  }
+  async onBeforeCall(sdkObject, metadata) {
+    if (this._muted) return;
+    if (shouldPauseOnCall(sdkObject, metadata) || this._pauseOnNextStatement && shouldPauseBeforeStep(metadata)) await this.pause(sdkObject, metadata);
+  }
+  async _doSlowMo() {
+    await new Promise(f => setTimeout(f, this._slowMo));
+  }
+  async onAfterCall(sdkObject, metadata) {
+    if (this._slowMo && shouldSlowMo(metadata)) await this._doSlowMo();
+  }
+  async onBeforeInputAction(sdkObject, metadata) {
+    if (this._muted) return;
+    if (this._enabled && this._pauseOnNextStatement) await this.pause(sdkObject, metadata);
+  }
+  async pause(sdkObject, metadata) {
+    if (this._muted) return;
+    this._enabled = true;
+    metadata.pauseStartTime = (0, _utils.monotonicTime)();
+    const result = new Promise(resolve => {
+      this._pausedCallsMetadata.set(metadata, {
+        resolve,
+        sdkObject
+      });
+    });
+    this.emit(Debugger.Events.PausedStateChanged);
+    return result;
+  }
+  resume(step) {
+    if (!this.isPaused()) return;
+    this._pauseOnNextStatement = step;
+    const endTime = (0, _utils.monotonicTime)();
+    for (const [metadata, {
+      resolve
+    }] of this._pausedCallsMetadata) {
+      metadata.pauseEndTime = endTime;
+      resolve();
+    }
+    this._pausedCallsMetadata.clear();
+    this.emit(Debugger.Events.PausedStateChanged);
+  }
+  pauseOnNextStatement() {
+    this._pauseOnNextStatement = true;
+  }
+  isPaused(metadata) {
+    if (metadata) return this._pausedCallsMetadata.has(metadata);
+    return !!this._pausedCallsMetadata.size;
+  }
+  pausedDetails() {
+    const result = [];
+    for (const [metadata, {
+      sdkObject
+    }] of this._pausedCallsMetadata) result.push({
+      metadata,
+      sdkObject
+    });
+    return result;
+  }
+}
+exports.Debugger = Debugger;
+Debugger.Events = {
+  PausedStateChanged: 'pausedstatechanged'
+};
+function shouldPauseOnCall(sdkObject, metadata) {
+  var _sdkObject$attributio;
+  if (sdkObject.attribution.playwright.options.isServer) return false;
+  if (!((_sdkObject$attributio = sdkObject.attribution.browser) !== null && _sdkObject$attributio !== void 0 && _sdkObject$attributio.options.headful) && !(0, _utils.isUnderTest)()) return false;
+  return metadata.method === 'pause';
+}
+function shouldPauseBeforeStep(metadata) {
+  // Don't stop on internal.
+  if (!metadata.apiName) return false;
+  // Always stop on 'close'
+  if (metadata.method === 'close') return true;
+  if (metadata.method === 'waitForSelector' || metadata.method === 'waitForEventInfo') return false; // Never stop on those, primarily for the test harness.
+  const step = metadata.type + '.' + metadata.method;
+  // Stop before everything that generates snapshot. But don't stop before those marked as pausesBeforeInputActions
+  // since we stop in them on a separate instrumentation signal.
+  return _debug.commandsWithTracingSnapshots.has(step) && !_debug.pausesBeforeInputActions.has(metadata.type + '.' + metadata.method);
+}
+function shouldSlowMo(metadata) {
+  return _debug.slowMoActions.has(metadata.type + '.' + metadata.method);
+}

package/lib/server/deviceDescriptors.js

@@ -0,0 +1,26 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.deviceDescriptors = void 0;
+var _deviceDescriptorsSource = _interopRequireDefault(require("./deviceDescriptorsSource.json"));
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+/**
+ * Copyright 2017 Google Inc. All rights reserved.
+ * Modifications copyright (c) Microsoft Corporation.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+const deviceDescriptors = exports.deviceDescriptors = _deviceDescriptorsSource.default;