rebrowser-playwright-core 1.48.2 → 1.49.1

package/lib/server/page.js

@@ -22,6 +22,7 @@ var _instrumentation = require("./instrumentation");
 var _selectorParser = require("../utils/isomorphic/selectorParser");
 var _utilityScriptSerializers = require("./isomorphic/utilityScriptSerializers");
 var _errors = require("./errors");
+var _helper = require("./helper");
 function _getRequireWildcardCache(e) { if ("function" != typeof WeakMap) return null; var r = new WeakMap(), t = new WeakMap(); return (_getRequireWildcardCache = function (e) { return e ? t : r; })(e); }
 function _interopRequireWildcard(e, r) { if (!r && e && e.__esModule) return e; if (null === e || "object" != typeof e && "function" != typeof e) return { default: e }; var t = _getRequireWildcardCache(r); if (t && t.has(e)) return t.get(e); var n = { __proto__: null }, a = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var u in e) if ("default" !== u && Object.prototype.hasOwnProperty.call(e, u)) { var i = a ? Object.getOwnPropertyDescriptor(e, u) : null; i && (i.get || i.set) ? Object.defineProperty(n, u, i) : n[u] = e[u]; } return n.default = e, t && t.set(e, n), n; }
 /**
@@ -308,7 +309,29 @@ class Page extends _instrumentation.SdkObject {
   unregisterLocatorHandler(uid) {
     this._locatorHandlers.delete(uid);
   }
-  async performLocatorHandlersCheckpoint(progress) {
+  async performActionPreChecks(progress) {
+    await this._performWaitForNavigationCheck(progress);
+    progress.throwIfAborted();
+    await this._performLocatorHandlersCheckpoint(progress);
+    progress.throwIfAborted();
+    // Wait once again, just in case a locator handler caused a navigation.
+    await this._performWaitForNavigationCheck(progress);
+  }
+  async _performWaitForNavigationCheck(progress) {
+    var _mainFrame$pendingDoc;
+    if (process.env.PLAYWRIGHT_SKIP_NAVIGATION_CHECK) return;
+    const mainFrame = this._frameManager.mainFrame();
+    if (!mainFrame || !mainFrame.pendingDocument()) return;
+    const url = (_mainFrame$pendingDoc = mainFrame.pendingDocument()) === null || _mainFrame$pendingDoc === void 0 || (_mainFrame$pendingDoc = _mainFrame$pendingDoc.request) === null || _mainFrame$pendingDoc === void 0 ? void 0 : _mainFrame$pendingDoc.url();
+    const toUrl = url ? `" ${(0, _utils.trimStringWithEllipsis)(url, 200)}"` : '';
+    progress.log(`  waiting for${toUrl} navigation to finish...`);
+    await _helper.helper.waitForEvent(progress, mainFrame, frames.Frame.Events.InternalNavigation, e => {
+      if (!e.isPublic) return false;
+      if (!e.error) progress.log(`  navigated to "${(0, _utils.trimStringWithEllipsis)(mainFrame.url(), 200)}"`);
+      return true;
+    }).promise;
+  }
+  async _performLocatorHandlersCheckpoint(progress) {
     // Do not run locator handlers from inside locator handler callbacks to avoid deadlocks.
     if (this._locatorHandlerRunningCounter) return;
     for (const [uid, handler] of this._locatorHandlers) {
@@ -409,7 +432,7 @@ class Page extends _instrumentation.SdkObject {
     const rafrafScreenshot = locator ? async (progress, timeout) => {
       return await locator.frame.rafrafTimeoutScreenshotElementWithProgress(progress, locator.selector, timeout, options || {});
     } : async (progress, timeout) => {
-      await this.performLocatorHandlersCheckpoint(progress);
+      await this.performActionPreChecks(progress);
       await this.mainFrame().rafrafTimeout(timeout);
       return await this._screenshotter.screenshotPage(progress, options || {});
     };
@@ -472,19 +495,23 @@ class Page extends _instrumentation.SdkObject {
         progress.log(`screenshot matched expectation`);
         return {};
       }
-      if (areEqualScreenshots(actual, options.expected, previous)) {
+      if (areEqualScreenshots(actual, options.expected, undefined)) {
         progress.log(`screenshot matched expectation`);
         return {};
       }
       throw new Error(intermediateResult.errorMessage);
     }, callTimeout).catch(e => {
+      var _intermediateResult;
       // Q: Why not throw upon isSessionClosedError(e) as in other places?
       // A: We want user to receive a friendly diff between actual and expected/previous.
       if (js.isJavaScriptErrorInEvaluate(e) || (0, _selectorParser.isInvalidSelectorError)(e)) throw e;
+      let errorMessage = e.message;
+      if (e instanceof _errors.TimeoutError && (_intermediateResult = intermediateResult) !== null && _intermediateResult !== void 0 && _intermediateResult.previous) errorMessage = `Failed to take two consecutive stable screenshots.`;
       return {
-        log: e.message ? [...metadata.log, e.message] : metadata.log,
+        log: (0, _utils.compressCallLog)(e.message ? [...metadata.log, e.message] : metadata.log),
         ...intermediateResult,
-        errorMessage: e.message
+        errorMessage,
+        timedOut: e instanceof _errors.TimeoutError
       };
     });
   }
@@ -596,16 +623,20 @@ Page.Events = {
   Worker: 'worker'
 };
 class Worker extends _instrumentation.SdkObject {
-  constructor(parent, url) {
+  constructor(parent, url, targetId, session) {
     super(parent, 'worker');
     this._url = void 0;
     this._executionContextPromise = void 0;
     this._executionContextCallback = void 0;
     this._existingExecutionContext = null;
     this.openScope = new _utils.LongStandingScope();
+    this._targetId = void 0;
+    this._session = void 0;
     this._url = url;
     this._executionContextCallback = () => {};
     this._executionContextPromise = new Promise(x => this._executionContextCallback = x);
+    this._targetId = targetId;
+    this._session = session;
   }
   _createExecutionContext(delegate) {
     this._existingExecutionContext = new js.ExecutionContext(this, delegate, 'worker');
@@ -619,14 +650,23 @@ class Worker extends _instrumentation.SdkObject {
     this.emit(Worker.Events.Close, this);
     this.openScope.close(new Error('Worker closed'));
   }
+  async getExecutionContext() {
+    if (process.env['REBROWSER_PATCHES_RUNTIME_FIX_MODE'] !== '0' && !this._existingExecutionContext) {
+      await this._session.__re__emitExecutionContext({
+        world: 'main',
+        targetId: this._targetId
+      });
+    }
+    return this._executionContextPromise;
+  }
   async evaluateExpression(expression, isFunction, arg) {
-    return js.evaluateExpression(await this._executionContextPromise, expression, {
+    return js.evaluateExpression(await this.getExecutionContext(), expression, {
       returnByValue: true,
       isFunction
     }, arg);
   }
   async evaluateExpressionHandle(expression, isFunction, arg) {
-    return js.evaluateExpression(await this._executionContextPromise, expression, {
+    return js.evaluateExpression(await this.getExecutionContext(), expression, {
       returnByValue: false,
       isFunction
     }, arg);
@@ -650,6 +690,10 @@ class PageBinding {
     this.internal = name.startsWith('__pw');
   }
   static async dispatch(page, payload, context) {
+    if (process.env['REBROWSER_PATCHES_RUNTIME_FIX_MODE'] !== '0' && !payload.includes('{')) {
+      // ignore as it's not a JSON but a string from addBinding method
+      return;
+    }
     const {
       name,
       seq,

package/lib/server/progress.js

@@ -70,9 +70,6 @@ class ProgressController {
       throwIfAborted: () => {
         if (this._state === 'aborted') throw new AbortedError();
       },
-      beforeInputAction: async element => {
-        await this.instrumentation.onBeforeInputAction(this.sdkObject, this.metadata, element);
-      },
       metadata: this.metadata
     };
     const timeoutError = new _errors.TimeoutError(`Timeout ${this._timeout}ms exceeded.`);

package/lib/server/recorder/recorderApp.js

@@ -38,7 +38,7 @@ class EmptyRecorderApp extends _events.EventEmitter {
   async setPaused(paused) {}
   async setMode(mode) {}
   async setRunningFile(file) {}
-  async setSelector(selector, userGesture) {}
+  async elementPicked(elementInfo, userGesture) {}
   async updateCallLogs(callLogs) {}
   async setSources(sources) {}
   async setActions(actions, sources) {}
@@ -165,23 +165,14 @@ class RecorderApp extends _events.EventEmitter {
     }
   }
   async setActions(actions, sources) {}
-  async setSelector(selector, userGesture) {
-    if (userGesture) {
-      var _this$_recorder;
-      if (((_this$_recorder = this._recorder) === null || _this$_recorder === void 0 ? void 0 : _this$_recorder.mode()) === 'inspecting') {
-        this._recorder.setMode('standby');
-        this._page.bringToFront();
-      } else {
-        var _this$_recorder2;
-        (_this$_recorder2 = this._recorder) === null || _this$_recorder2 === void 0 || _this$_recorder2.setMode('recording');
-      }
-    }
-    await this._page.mainFrame().evaluateExpression((data => {
-      window.playwrightSetSelector(data.selector, data.userGesture);
+  async elementPicked(elementInfo, userGesture) {
+    if (userGesture) this._page.bringToFront();
+    await this._page.mainFrame().evaluateExpression((param => {
+      window.playwrightElementPicked(param.elementInfo, param.userGesture);
     }).toString(), {
       isFunction: true
     }, {
-      selector,
+      elementInfo,
       userGesture
     }).catch(() => {});
   }

package/lib/server/recorder/recorderCollection.js

@@ -36,7 +36,7 @@ class RecorderCollection extends _events.EventEmitter {
   }
   restart() {
     this._actions = [];
-    this._fireChange();
+    this.emit('change', []);
   }
   setEnabled(enabled) {
     this._enabled = enabled;

package/lib/server/recorder/recorderInTraceViewer.js

@@ -77,9 +77,9 @@ class RecorderInTraceViewer extends _events.EventEmitter {
       file
     });
   }
-  async setSelector(selector, userGesture) {
-    this._transport.deliverEvent('setSelector', {
-      selector,
+  async elementPicked(elementInfo, userGesture) {
+    this._transport.deliverEvent('elementPicked', {
+      elementInfo,
       userGesture
     });
   }

package/lib/server/recorder/recorderUtils.js

@@ -73,11 +73,12 @@ function callMetadataForAction(pageAliases, actionInContext) {
   const mainFrame = mainFrameForAction(pageAliases, actionInContext);
   const {
     method,
+    apiName,
     params
   } = (0, _recorderUtils.traceParamsForAction)(actionInContext);
   const callMetadata = {
     id: `call@${(0, _utils.createGuid)()}`,
-    apiName: 'page.' + method,
+    apiName,
     objectId: mainFrame.guid,
     pageId: mainFrame._page.guid,
     frameId: mainFrame.guid,

package/lib/server/recorder.js

@@ -13,6 +13,7 @@ var _debugger = require("./debugger");
 var _contextRecorder = require("./recorder/contextRecorder");
 var _recorderUtils = require("./recorder/recorderUtils");
 var _recorderUtils2 = require("../utils/isomorphic/recorderUtils");
+var _selectorParser = require("../utils/isomorphic/selectorParser");
 function _getRequireWildcardCache(e) { if ("function" != typeof WeakMap) return null; var r = new WeakMap(), t = new WeakMap(); return (_getRequireWildcardCache = function (e) { return e ? t : r; })(e); }
 function _interopRequireWildcard(e, r) { if (!r && e && e.__esModule) return e; if (null === e || "object" != typeof e && "function" != typeof e) return { default: e }; var t = _getRequireWildcardCache(r); if (t && t.has(e)) return t.get(e); var n = { __proto__: null }, a = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var u in e) if ("default" !== u && Object.prototype.hasOwnProperty.call(e, u)) { var i = a ? Object.getOwnPropertyDescriptor(e, u) : null; i && (i.get || i.set) ? Object.defineProperty(n, u, i) : n[u] = e[u]; } return n.default = e, t && t.set(e, n), n; }
 /**
@@ -58,7 +59,7 @@ class Recorder {
     this.handleSIGINT = void 0;
     this._context = void 0;
     this._mode = void 0;
-    this._highlightedSelector = '';
+    this._highlightedElement = {};
     this._overlayState = {
       offsetX: 0
     };
@@ -94,8 +95,9 @@ class Recorder {
         this.setMode(data.params.mode);
         return;
       }
-      if (data.event === 'selectorUpdated') {
-        this.setHighlightedSelector(this._currentLanguage, data.params.selector);
+      if (data.event === 'highlightRequested') {
+        if (data.params.selector) this.setHighlightedSelector(this._currentLanguage, data.params.selector);
+        if (data.params.ariaTemplate) this.setHighlightedAriaTemplate(data.params.ariaTemplate);
         return;
       }
       if (data.event === 'step') {
@@ -133,12 +135,12 @@ class Recorder {
       recorderApp.setRunningFile(undefined);
       this._pushAllSources();
     });
-    await this._context.exposeBinding('__pw_recorderState', false, source => {
-      let actionSelector = '';
+    await this._context.exposeBinding('__pw_recorderState', false, async source => {
+      let actionSelector;
       let actionPoint;
       const hasActiveScreenshotCommand = [...this._currentCallsMetadata.keys()].some(isScreenshotCommand);
       if (!hasActiveScreenshotCommand) {
-        actionSelector = this._highlightedSelector;
+        actionSelector = await this._scopeHighlightedSelectorToFrame(source.frame);
         for (const [metadata, sdkObject] of this._currentCallsMetadata) {
           if (source.page === sdkObject.attribution.page) {
             actionPoint = metadata.point || actionPoint;
@@ -150,18 +152,22 @@ class Recorder {
         mode: this._mode,
         actionPoint,
         actionSelector,
+        ariaTemplate: this._highlightedElement.ariaTemplate,
         language: this._currentLanguage,
         testIdAttributeName: this._contextRecorder.testIdAttributeName(),
         overlay: this._overlayState
       };
       return uiState;
     });
-    await this._context.exposeBinding('__pw_recorderSetSelector', false, async ({
+    await this._context.exposeBinding('__pw_recorderElementPicked', false, async ({
       frame
-    }, selector) => {
+    }, elementInfo) => {
       var _this$_recorderApp2;
       const selectorChain = await (0, _contextRecorder.generateFrameSelector)(frame);
-      await ((_this$_recorderApp2 = this._recorderApp) === null || _this$_recorderApp2 === void 0 ? void 0 : _this$_recorderApp2.setSelector((0, _recorderUtils2.buildFullSelector)(selectorChain, selector), true));
+      await ((_this$_recorderApp2 = this._recorderApp) === null || _this$_recorderApp2 === void 0 ? void 0 : _this$_recorderApp2.elementPicked({
+        selector: (0, _recorderUtils2.buildFullSelector)(selectorChain, elementInfo.selector),
+        ariaSnapshot: elementInfo.ariaSnapshot
+      }, true));
     });
     await this._context.exposeBinding('__pw_recorderSetMode', false, async ({
       frame
@@ -200,11 +206,11 @@ class Recorder {
   setMode(mode) {
     var _this$_recorderApp4;
     if (this._mode === mode) return;
-    this._highlightedSelector = '';
+    this._highlightedElement = {};
     this._mode = mode;
     (_this$_recorderApp4 = this._recorderApp) === null || _this$_recorderApp4 === void 0 || _this$_recorderApp4.setMode(this._mode);
-    this._contextRecorder.setEnabled(this._mode === 'recording' || this._mode === 'assertingText' || this._mode === 'assertingVisibility' || this._mode === 'assertingValue');
-    this._debugger.setMuted(this._mode === 'recording' || this._mode === 'assertingText' || this._mode === 'assertingVisibility' || this._mode === 'assertingValue');
+    this._contextRecorder.setEnabled(this._isRecording());
+    this._debugger.setMuted(this._isRecording());
     if (this._mode !== 'none' && this._mode !== 'standby' && this._context.pages().length === 1) this._context.pages()[0].bringToFront().catch(() => {});
     this._refreshOverlay();
   }
@@ -215,40 +221,66 @@ class Recorder {
     return this._mode;
   }
   setHighlightedSelector(language, selector) {
-    this._highlightedSelector = (0, _locatorParser.locatorOrSelectorAsSelector)(language, selector, this._context.selectors().testIdAttributeName());
+    this._highlightedElement = {
+      selector: (0, _locatorParser.locatorOrSelectorAsSelector)(language, selector, this._context.selectors().testIdAttributeName())
+    };
+    this._refreshOverlay();
+  }
+  setHighlightedAriaTemplate(ariaTemplate) {
+    this._highlightedElement = {
+      ariaTemplate
+    };
     this._refreshOverlay();
   }
   hideHighlightedSelector() {
-    this._highlightedSelector = '';
+    this._highlightedElement = {};
     this._refreshOverlay();
   }
+  async _scopeHighlightedSelectorToFrame(frame) {
+    if (!this._highlightedElement.selector) return;
+    try {
+      const mainFrame = frame._page.mainFrame();
+      const resolved = await mainFrame.selectors.resolveFrameForSelector(this._highlightedElement.selector);
+      // selector couldn't be found, don't highlight anything
+      if (!resolved) return '';
+
+      // selector points to no specific frame, highlight in all frames
+      if ((resolved === null || resolved === void 0 ? void 0 : resolved.frame) === mainFrame) return (0, _selectorParser.stringifySelector)(resolved.info.parsed);
+
+      // selector points to this frame, highlight it
+      if ((resolved === null || resolved === void 0 ? void 0 : resolved.frame) === frame) return (0, _selectorParser.stringifySelector)(resolved.info.parsed);
+
+      // selector points to a different frame, highlight nothing
+      return '';
+    } catch {
+      return '';
+    }
+  }
   setOutput(codegenId, outputFile) {
     this._contextRecorder.setOutput(codegenId, outputFile);
   }
   _refreshOverlay() {
-    for (const page of this._context.pages()) page.mainFrame().evaluateExpression('window.__pw_refreshOverlay()').catch(() => {});
+    for (const page of this._context.pages()) {
+      for (const frame of page.frames()) frame.evaluateExpression('window.__pw_refreshOverlay()').catch(() => {});
+    }
   }
   async onBeforeCall(sdkObject, metadata) {
-    if (this._omitCallTracking || this._mode === 'recording' || this._mode === 'assertingText' || this._mode === 'assertingVisibility' || this._mode === 'assertingValue') return;
+    if (this._omitCallTracking || this._isRecording()) return;
     this._currentCallsMetadata.set(metadata, sdkObject);
     this._updateUserSources();
     this.updateCallLog([metadata]);
-    if (isScreenshotCommand(metadata)) {
-      this.hideHighlightedSelector();
-    } else if (metadata.params && metadata.params.selector) {
-      var _this$_recorderApp5;
-      this._highlightedSelector = metadata.params.selector;
-      (_this$_recorderApp5 = this._recorderApp) === null || _this$_recorderApp5 === void 0 || _this$_recorderApp5.setSelector(this._highlightedSelector).catch(() => {});
-    }
+    if (isScreenshotCommand(metadata)) this.hideHighlightedSelector();else if (metadata.params && metadata.params.selector) this._highlightedElement = {
+      selector: metadata.params.selector
+    };
   }
   async onAfterCall(sdkObject, metadata) {
-    if (this._omitCallTracking || this._mode === 'recording' || this._mode === 'assertingText' || this._mode === 'assertingVisibility' || this._mode === 'assertingValue') return;
+    if (this._omitCallTracking || this._isRecording()) return;
     if (!metadata.error) this._currentCallsMetadata.delete(metadata);
     this._updateUserSources();
     this.updateCallLog([metadata]);
   }
   _updateUserSources() {
-    var _this$_recorderApp6;
+    var _this$_recorderApp5;
     // Remove old decorations.
     for (const source of this._userSources.values()) {
       source.highlight = [];
@@ -286,19 +318,19 @@ class Recorder {
       }
     }
     this._pushAllSources();
-    if (fileToSelect) (_this$_recorderApp6 = this._recorderApp) === null || _this$_recorderApp6 === void 0 || _this$_recorderApp6.setRunningFile(fileToSelect);
+    if (fileToSelect) (_this$_recorderApp5 = this._recorderApp) === null || _this$_recorderApp5 === void 0 || _this$_recorderApp5.setRunningFile(fileToSelect);
   }
   _pushAllSources() {
-    var _this$_recorderApp7;
-    (_this$_recorderApp7 = this._recorderApp) === null || _this$_recorderApp7 === void 0 || _this$_recorderApp7.setSources([...this._recorderSources, ...this._userSources.values()]);
+    var _this$_recorderApp6;
+    (_this$_recorderApp6 = this._recorderApp) === null || _this$_recorderApp6 === void 0 || _this$_recorderApp6.setSources([...this._recorderSources, ...this._userSources.values()]);
   }
   async onBeforeInputAction(sdkObject, metadata) {}
   async onCallLog(sdkObject, metadata, logName, message) {
     this.updateCallLog([metadata]);
   }
   updateCallLog(metadatas) {
-    var _this$_recorderApp8;
-    if (this._mode === 'recording' || this._mode === 'assertingText' || this._mode === 'assertingVisibility' || this._mode === 'assertingValue') return;
+    var _this$_recorderApp7;
+    if (this._isRecording()) return;
     const logs = [];
     for (const metadata of metadatas) {
       if (!metadata.method || metadata.internal) continue;
@@ -307,7 +339,10 @@ class Recorder {
       if (this._debugger.isPaused(metadata)) status = 'paused';
       logs.push((0, _recorderUtils.metadataToCallLog)(metadata, status));
     }
-    (_this$_recorderApp8 = this._recorderApp) === null || _this$_recorderApp8 === void 0 || _this$_recorderApp8.updateCallLogs(logs);
+    (_this$_recorderApp7 = this._recorderApp) === null || _this$_recorderApp7 === void 0 || _this$_recorderApp7.updateCallLogs(logs);
+  }
+  _isRecording() {
+    return ['recording', 'assertingText', 'assertingVisibility', 'assertingValue', 'assertingSnapshot'].includes(this._mode);
   }
   _readSource(fileName) {
     try {

package/lib/server/registry/index.js

@@ -8,7 +8,6 @@ exports.browserDirectoryToMarkerFilePath = browserDirectoryToMarkerFilePath;
 exports.buildPlaywrightCLICommand = buildPlaywrightCLICommand;
 exports.findChromiumChannel = findChromiumChannel;
 exports.installBrowsersForNpmInstall = installBrowsersForNpmInstall;
-exports.installDefaultBrowsersForNpmInstall = installDefaultBrowsersForNpmInstall;
 exports.registryDirectory = exports.registry = void 0;
 Object.defineProperty(exports, "writeDockerVersion", {
   enumerable: true,
@@ -65,6 +64,11 @@ const EXECUTABLE_PATHS = {
     'mac': ['chrome-mac', 'Chromium.app', 'Contents', 'MacOS', 'Chromium'],
     'win': ['chrome-win', 'chrome.exe']
   },
+  'chromium-headless-shell': {
+    'linux': ['chrome-linux', 'headless_shell'],
+    'mac': ['chrome-mac', 'headless_shell'],
+    'win': ['chrome-win', 'headless_shell.exe']
+  },
   'firefox': {
     'linux': ['firefox', 'firefox'],
     'mac': ['firefox', 'Nightly.app', 'Contents', 'MacOS', 'firefox'],
@@ -111,6 +115,35 @@ const DOWNLOAD_PATHS = {
     'mac15-arm64': 'builds/chromium/%s/chromium-mac-arm64.zip',
     'win64': 'builds/chromium/%s/chromium-win64.zip'
   },
+  'chromium-headless-shell': {
+    '<unknown>': undefined,
+    'ubuntu18.04-x64': undefined,
+    'ubuntu20.04-x64': 'builds/chromium/%s/chromium-headless-shell-linux.zip',
+    'ubuntu22.04-x64': 'builds/chromium/%s/chromium-headless-shell-linux.zip',
+    'ubuntu24.04-x64': 'builds/chromium/%s/chromium-headless-shell-linux.zip',
+    'ubuntu18.04-arm64': undefined,
+    'ubuntu20.04-arm64': 'builds/chromium/%s/chromium-headless-shell-linux-arm64.zip',
+    'ubuntu22.04-arm64': 'builds/chromium/%s/chromium-headless-shell-linux-arm64.zip',
+    'ubuntu24.04-arm64': 'builds/chromium/%s/chromium-headless-shell-linux-arm64.zip',
+    'debian11-x64': 'builds/chromium/%s/chromium-headless-shell-linux.zip',
+    'debian11-arm64': 'builds/chromium/%s/chromium-headless-shell-linux-arm64.zip',
+    'debian12-x64': 'builds/chromium/%s/chromium-headless-shell-linux.zip',
+    'debian12-arm64': 'builds/chromium/%s/chromium-headless-shell-linux-arm64.zip',
+    'mac10.13': undefined,
+    'mac10.14': undefined,
+    'mac10.15': undefined,
+    'mac11': 'builds/chromium/%s/chromium-headless-shell-mac.zip',
+    'mac11-arm64': 'builds/chromium/%s/chromium-headless-shell-mac-arm64.zip',
+    'mac12': 'builds/chromium/%s/chromium-headless-shell-mac.zip',
+    'mac12-arm64': 'builds/chromium/%s/chromium-headless-shell-mac-arm64.zip',
+    'mac13': 'builds/chromium/%s/chromium-headless-shell-mac.zip',
+    'mac13-arm64': 'builds/chromium/%s/chromium-headless-shell-mac-arm64.zip',
+    'mac14': 'builds/chromium/%s/chromium-headless-shell-mac.zip',
+    'mac14-arm64': 'builds/chromium/%s/chromium-headless-shell-mac-arm64.zip',
+    'mac15': 'builds/chromium/%s/chromium-headless-shell-mac.zip',
+    'mac15-arm64': 'builds/chromium/%s/chromium-headless-shell-mac-arm64.zip',
+    'win64': 'builds/chromium/%s/chromium-headless-shell-win64.zip'
+  },
   'chromium-tip-of-tree': {
     '<unknown>': undefined,
     'ubuntu18.04-x64': undefined,
@@ -313,7 +346,7 @@ const registryDirectory = exports.registryDirectory = (() => {
 function isBrowserDirectory(browserDirectory) {
   const baseName = _path.default.basename(browserDirectory);
   for (const browserName of allDownloadable) {
-    if (baseName.startsWith(browserName + '-')) return true;
+    if (baseName.startsWith(browserName.replace(/-/g, '_') + '-')) return true;
   }
   return false;
 }
@@ -326,6 +359,7 @@ function readDescriptors(browsersJSON) {
     const descriptor = {
       name,
       revision,
+      hasRevisionOverride: !!revisionOverride,
       // We only put browser version for the supported operating systems.
       browserVersion: revisionOverride ? undefined : obj.browserVersion,
       installByDefault: !!obj.installByDefault,
@@ -339,7 +373,7 @@ function readDescriptors(browsersJSON) {
     return descriptor;
   });
 }
-const allDownloadable = ['chromium', 'firefox', 'webkit', 'ffmpeg', 'firefox-beta', 'chromium-tip-of-tree'];
+const allDownloadable = ['android', 'chromium', 'firefox', 'webkit', 'ffmpeg', 'firefox-beta', 'chromium-tip-of-tree', 'chromium-headless-shell'];
 class Registry {
   constructor(browsersJSON) {
     this._executables = void 0;
@@ -372,13 +406,30 @@ class Registry {
       executablePath: () => chromiumExecutable,
       executablePathOrDie: sdkLanguage => executablePathOrDie('chromium', chromiumExecutable, chromium.installByDefault, sdkLanguage),
       installType: chromium.installByDefault ? 'download-by-default' : 'download-on-demand',
-      _validateHostRequirements: sdkLanguage => this._validateHostRequirements(sdkLanguage, 'chromium', chromium.dir, ['chrome-linux'], [], ['chrome-win']),
+      _validateHostRequirements: sdkLanguage => this._validateHostRequirements(sdkLanguage, chromium.dir, ['chrome-linux'], [], ['chrome-win']),
       downloadURLs: this._downloadURLs(chromium),
       browserVersion: chromium.browserVersion,
       _install: () => this._downloadExecutable(chromium, chromiumExecutable),
       _dependencyGroup: 'chromium',
       _isHermeticInstallation: true
     });
+    const chromiumHeadlessShell = descriptors.find(d => d.name === 'chromium-headless-shell');
+    const chromiumHeadlessShellExecutable = findExecutablePath(chromiumHeadlessShell.dir, 'chromium-headless-shell');
+    this._executables.push({
+      type: 'channel',
+      name: 'chromium-headless-shell',
+      browserName: 'chromium',
+      directory: chromiumHeadlessShell.dir,
+      executablePath: () => chromiumHeadlessShellExecutable,
+      executablePathOrDie: sdkLanguage => executablePathOrDie('chromium', chromiumHeadlessShellExecutable, chromiumHeadlessShell.installByDefault, sdkLanguage),
+      installType: chromiumHeadlessShell.installByDefault ? 'download-by-default' : 'download-on-demand',
+      _validateHostRequirements: sdkLanguage => this._validateHostRequirements(sdkLanguage, chromiumHeadlessShell.dir, ['chrome-linux'], [], ['chrome-win']),
+      downloadURLs: this._downloadURLs(chromiumHeadlessShell),
+      browserVersion: chromium.browserVersion,
+      _install: () => this._downloadExecutable(chromiumHeadlessShell, chromiumHeadlessShellExecutable),
+      _dependencyGroup: 'chromium',
+      _isHermeticInstallation: true
+    });
     const chromiumTipOfTree = descriptors.find(d => d.name === 'chromium-tip-of-tree');
     const chromiumTipOfTreeExecutable = findExecutablePath(chromiumTipOfTree.dir, 'chromium');
     this._executables.push({
@@ -389,7 +440,7 @@ class Registry {
       executablePath: () => chromiumTipOfTreeExecutable,
       executablePathOrDie: sdkLanguage => executablePathOrDie('chromium-tip-of-tree', chromiumTipOfTreeExecutable, chromiumTipOfTree.installByDefault, sdkLanguage),
       installType: chromiumTipOfTree.installByDefault ? 'download-by-default' : 'download-on-demand',
-      _validateHostRequirements: sdkLanguage => this._validateHostRequirements(sdkLanguage, 'chromium', chromiumTipOfTree.dir, ['chrome-linux'], [], ['chrome-win']),
+      _validateHostRequirements: sdkLanguage => this._validateHostRequirements(sdkLanguage, chromiumTipOfTree.dir, ['chrome-linux'], [], ['chrome-win']),
       downloadURLs: this._downloadURLs(chromiumTipOfTree),
       browserVersion: chromiumTipOfTree.browserVersion,
       _install: () => this._downloadExecutable(chromiumTipOfTree, chromiumTipOfTreeExecutable),
@@ -489,7 +540,7 @@ class Registry {
       executablePath: () => chromiumExecutable,
       executablePathOrDie: sdkLanguage => executablePathOrDie('chromium', chromiumExecutable, chromium.installByDefault, sdkLanguage),
       installType: 'download-on-demand',
-      _validateHostRequirements: sdkLanguage => this._validateHostRequirements(sdkLanguage, 'chromium', chromium.dir, ['chrome-linux'], [], ['chrome-win']),
+      _validateHostRequirements: sdkLanguage => this._validateHostRequirements(sdkLanguage, chromium.dir, ['chrome-linux'], [], ['chrome-win']),
       downloadURLs: this._downloadURLs(chromium),
       browserVersion: chromium.browserVersion,
       _install: () => this._downloadExecutable(chromium, chromiumExecutable),
@@ -506,7 +557,7 @@ class Registry {
       executablePath: () => firefoxExecutable,
       executablePathOrDie: sdkLanguage => executablePathOrDie('firefox', firefoxExecutable, firefox.installByDefault, sdkLanguage),
       installType: firefox.installByDefault ? 'download-by-default' : 'download-on-demand',
-      _validateHostRequirements: sdkLanguage => this._validateHostRequirements(sdkLanguage, 'firefox', firefox.dir, ['firefox'], [], ['firefox']),
+      _validateHostRequirements: sdkLanguage => this._validateHostRequirements(sdkLanguage, firefox.dir, ['firefox'], [], ['firefox']),
       downloadURLs: this._downloadURLs(firefox),
       browserVersion: firefox.browserVersion,
       _install: () => this._downloadExecutable(firefox, firefoxExecutable),
@@ -523,7 +574,7 @@ class Registry {
       executablePath: () => firefoxBetaExecutable,
       executablePathOrDie: sdkLanguage => executablePathOrDie('firefox-beta', firefoxBetaExecutable, firefoxBeta.installByDefault, sdkLanguage),
       installType: firefoxBeta.installByDefault ? 'download-by-default' : 'download-on-demand',
-      _validateHostRequirements: sdkLanguage => this._validateHostRequirements(sdkLanguage, 'firefox', firefoxBeta.dir, ['firefox'], [], ['firefox']),
+      _validateHostRequirements: sdkLanguage => this._validateHostRequirements(sdkLanguage, firefoxBeta.dir, ['firefox'], [], ['firefox']),
       downloadURLs: this._downloadURLs(firefoxBeta),
       browserVersion: firefoxBeta.browserVersion,
       _install: () => this._downloadExecutable(firefoxBeta, firefoxBetaExecutable),
@@ -541,7 +592,7 @@ class Registry {
       executablePath: () => webkitExecutable,
       executablePathOrDie: sdkLanguage => executablePathOrDie('webkit', webkitExecutable, webkit.installByDefault, sdkLanguage),
       installType: webkit.installByDefault ? 'download-by-default' : 'download-on-demand',
-      _validateHostRequirements: sdkLanguage => this._validateHostRequirements(sdkLanguage, 'webkit', webkit.dir, webkitLinuxLddDirectories, ['libGLESv2.so.2', 'libx264.so'], ['']),
+      _validateHostRequirements: sdkLanguage => this._validateHostRequirements(sdkLanguage, webkit.dir, webkitLinuxLddDirectories, ['libGLESv2.so.2', 'libx264.so'], ['']),
       downloadURLs: this._downloadURLs(webkit),
       browserVersion: webkit.browserVersion,
       _install: () => this._downloadExecutable(webkit, webkitExecutable),
@@ -695,20 +746,15 @@ class Registry {
   defaultExecutables() {
     return this._executables.filter(e => e.installType === 'download-by-default');
   }
-  _addRequirementsAndDedupe(executables) {
-    const set = new Set();
-    for (const executable of executables) {
-      set.add(executable);
-      if (executable.browserName === 'chromium') set.add(this.findExecutable('ffmpeg'));
-    }
-    return Array.from(set);
+  _dedupe(executables) {
+    return Array.from(new Set(executables));
   }
-  async _validateHostRequirements(sdkLanguage, browserName, browserDirectory, linuxLddDirectories, dlOpenLibraries, windowsExeAndDllDirectories) {
+  async _validateHostRequirements(sdkLanguage, browserDirectory, linuxLddDirectories, dlOpenLibraries, windowsExeAndDllDirectories) {
     if (os.platform() === 'linux') return await (0, _dependencies.validateDependenciesLinux)(sdkLanguage, linuxLddDirectories.map(d => _path.default.join(browserDirectory, d)), dlOpenLibraries);
     if (os.platform() === 'win32' && os.arch() === 'x64') return await (0, _dependencies.validateDependenciesWindows)(windowsExeAndDllDirectories.map(d => _path.default.join(browserDirectory, d)));
   }
   async installDeps(executablesToInstallDeps, dryRun) {
-    const executables = this._addRequirementsAndDedupe(executablesToInstallDeps);
+    const executables = this._dedupe(executablesToInstallDeps);
     const targets = new Set();
     for (const executable of executables) {
       if (executable._dependencyGroup) targets.add(executable._dependencyGroup);
@@ -718,7 +764,7 @@ class Registry {
     if (os.platform() === 'linux') return await (0, _dependencies.installDependenciesLinux)(targets, dryRun);
   }
   async install(executablesToInstall, forceReinstall) {
-    const executables = this._addRequirementsAndDedupe(executablesToInstall);
+    const executables = this._dedupe(executablesToInstall);
     await fs.promises.mkdir(registryDirectory, {
       recursive: true
     });
@@ -826,6 +872,11 @@ class Registry {
     const downloadURLs = this._downloadURLs(descriptor);
     if (!downloadURLs.length) throw new Error(`ERROR: Playwright does not support ${descriptor.name} on ${_hostPlatform.hostPlatform}`);
     if (!_hostPlatform.isOfficiallySupportedPlatform) (0, _browserFetcher.logPolitely)(`BEWARE: your OS is not officially supported by Playwright; downloading fallback build for ${_hostPlatform.hostPlatform}.`);
+    if (descriptor.hasRevisionOverride) {
+      const message = `You are using a frozen ${descriptor.name} browser which does not receive updates anymore on ${_hostPlatform.hostPlatform}. Please update to the latest version of your operating system to test up-to-date browsers.`;
+      if (process.env.GITHUB_ACTIONS) console.log(`::warning title=Playwright::${message}`); // eslint-disable-line no-console
+      else (0, _browserFetcher.logPolitely)(message);
+    }
     const displayName = descriptor.name.split('-').map(word => {
       return word === 'ffmpeg' ? 'FFMPEG' : word.charAt(0).toUpperCase() + word.slice(1);
     }).join(' ');
@@ -959,10 +1010,6 @@ function buildPlaywrightCLICommand(sdkLanguage, parameters) {
       }
   }
 }
-async function installDefaultBrowsersForNpmInstall() {
-  const defaultBrowserNames = registry.defaultExecutables().map(e => e.name);
-  return installBrowsersForNpmInstall(defaultBrowserNames);
-}
 async function installBrowsersForNpmInstall(browsers) {
   // PLAYWRIGHT_SKIP_BROWSER_DOWNLOAD should have a value of 0 or 1
   if ((0, _utils.getAsBooleanFromENV)('PLAYWRIGHT_SKIP_BROWSER_DOWNLOAD')) {