From d9bc5fcfcce43db5870f907910f55f05c91399a4 Mon Sep 17 00:00:00 2001
From: Matt Kleinsmith <8968171+MattKleinsmith@users.noreply.github.com>
Date: Tue, 16 Jul 2024 09:22:36 -0700
Subject: [PATCH] Add comment to onContextMenu

---
 .../playwright-core/src/server/injected/recorder/recorder.ts   | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/packages/playwright-core/src/server/injected/recorder/recorder.ts b/packages/playwright-core/src/server/injected/recorder/recorder.ts
index 10ab06e3da..e70eb9227a 100644
--- a/packages/playwright-core/src/server/injected/recorder/recorder.ts
+++ b/packages/playwright-core/src/server/injected/recorder/recorder.ts
@@ -260,6 +260,9 @@ class RecordActionTool implements RecorderTool {
   }
 
   onContextMenu(event: MouseEvent) {
+    // the 'contextmenu' event is triggered by a right-click or equivalent action,
+    // and it prevents the click event from firing for that action, so we always
+    // convert 'contextmenu' into a right-click.
     if (this._shouldIgnoreMouseEvent(event))
       return;
     if (this._actionInProgress(event))