feat: add t.openIsolatedSession() for multi-user e2e tests via CDP

sam-yh · sam-yh · commit bbe3112b0be7 · 2026-03-17T14:11:08.000+01:00
Add the ability to open fully isolated browser sessions within a single test. Each isolated session gets its own Chrome browser context (separate cookies, localStorage, sessionStorage, service workers) via CDP Target.createBrowserContext(). This enables multi-user e2e tests — e.g. doctor + patient in a video call, two users editing the same document, concurrent booking scenarios — all in one test without needing multiple TestCafe instances. API: const t2 = await t.openIsolatedSession(); await t2.navigateTo('https://example.com'); await t2.click('#btn'); await t2.typeText('#input', 'text'); Supported: click, rightClick, doubleClick, hover, drag, dragToElement, typeText, pressKey, selectText, scroll, scrollBy, scrollIntoView, dispatchEvent, navigateTo, wait, eval, expect, useRole, getCookies, setCookies, deleteCookies, takeScreenshot, takeElementScreenshot, setFilesToUpload, setPageLoadTimeout, maximizeWindow, resizeWindow, switchToIframe, switchToMainWindow. Selector chaining (withText, nth, filterVisible, find, withAttribute, etc.) works. t2.run() provides transparent Selector/ClientFunction evaluation in the isolated tab. Requires Native Automation mode (Chrome only). Includes 40 functional tests covering isolation, commands, selector chaining, t2.run(), cookies, iframes, screenshots, file upload, and window management.
diff --git a/.gitignore b/.gitignore
@@ -14,6 +14,3 @@ Gemfile.lock
 .DS_Store
 !gulp
 /test/functional/fixtures/**/package.json
-_uploads_/
-testcafe-*.tgz
-yarn.lock
diff --git a/.gitlab-ci.yml b/.gitlab-ci.yml
diff --git a/README.md b/README.md
diff --git a/gulp/constants/functional-test-globs.js b/gulp/constants/functional-test-globs.js
@@ -1,5 +1,5 @@
 const MULTIPLE_WINDOWS_TESTS_GLOB      = 'test/functional/fixtures/multiple-windows/test.js';
-const ISOLATED_SESSIONS_TESTS_GLOB     = 'test/functional/fixtures/isolated-sessions/test.js'; // SAMEDI
+const ISOLATED_SESSIONS_TESTS_GLOB     = 'test/functional/fixtures/isolated-sessions/test.js';
 const HEADED_CHROME_FIREFOX_TESTS_GLOB = ['test/functional/fixtures/live/test.js', 'test/functional/fixtures/ui/test.js'];
 const COMPILER_SERVICE_TESTS_GLOB      = 'test/functional/fixtures/compiler-service/test.js';
 const LEGACY_TESTS_GLOB                = 'test/functional/legacy-fixtures/**/test.js';
@@ -13,15 +13,15 @@ const SCREENSHOT_TESTS_GLOB = [
 const TESTS_GLOB = [
     BASIC_TESTS_GLOB,
     `!${MULTIPLE_WINDOWS_TESTS_GLOB}`,
-    `!${ISOLATED_SESSIONS_TESTS_GLOB}`, // SAMEDI
+    `!${ISOLATED_SESSIONS_TESTS_GLOB}`,
     `!${COMPILER_SERVICE_TESTS_GLOB}`,
 ];
 
 module.exports = {
     TESTS_GLOB,
     LEGACY_TESTS_GLOB,
     MULTIPLE_WINDOWS_TESTS_GLOB,
-    ISOLATED_SESSIONS_TESTS_GLOB, // SAMEDI
+    ISOLATED_SESSIONS_TESTS_GLOB,
     BASIC_TESTS_GLOB,
     COMPILER_SERVICE_TESTS_GLOB,
     SCREENSHOT_TESTS_GLOB,
diff --git a/package-lock.json b/package-lock.json
diff --git a/package.json b/package.json
@@ -1,5 +1,5 @@
 {
-  "name": "@qa/testcafe-fork",
+  "name": "testcafe",
   "description": "Automated browser testing for the modern web development stack.",
   "license": "MIT",
   "version": "3.7.4",
@@ -54,7 +54,6 @@
   "scripts": {
     "test": "gulp travis",
     "build": "gulp build",
-    "prepare": "gulp build",
     "test-functional-local-headless-chrome-run-esm": "cross-env NODE_OPTIONS='--experimental-loader=./lib/compiler/esm-loader.js' gulp test-functional-local-headless-chrome-run --steps-as-tasks",
     "test-functional-local-headless-chrome-esm": "npm run build && npm run test-functional-local-headless-chrome-run-esm",
     "publish-please-only": "publish-please",
@@ -230,7 +229,7 @@
     "sinon": "^7.3.0",
     "stack-chain": "^2.0.0",
     "strip-ansi": "^3.0.0",
-"testcafe-browser-provider-browserstack": "^1.14.1",
+    "testcafe-browser-provider-browserstack": "^1.14.1",
     "tslib": "^2.4.0",
     "uglify-js": "~3.10.4"
   },
diff --git a/src/api/test-controller/index.js b/src/api/test-controller/index.js
@@ -648,7 +648,7 @@ export default class TestController {
         return this.enqueueCommand(ReportCommand, { args });
     }
 
-    // SAMEDI: isolated session opener — creates a CDP-isolated browser context
+    // Open an isolated browser session via CDP Target.createBrowserContext
     _openIsolatedSession$ () {
         const callsite = getCallsiteForMethod('openIsolatedSession');
 
diff --git a/src/api/test-controller/isolated.js b/src/api/test-controller/isolated.js
@@ -1,4 +1,4 @@
-// SAMEDI: IsolatedTestController — test controller for CDP-isolated browser sessions (t2 API)
+// IsolatedTestController — test controller for CDP-isolated browser sessions (t2 API)
 //
 // The t2 object returned by t.openIsolatedSession(). Mirrors TestController's
 // delegatedAPI pattern but routes commands to IsolatedSession.executeCommand()
diff --git a/src/browser/provider/built-in/dedicated/chrome/cdp-client/index.ts b/src/browser/provider/built-in/dedicated/chrome/cdp-client/index.ts
@@ -71,7 +71,7 @@ export class BrowserClient {
     private _videoFramesBuffer: VideoFrameData[];
     private _lastFrame: VideoFrameData | null;
     private _screencastFrameListenerAttached = false;
-    private _browserLevelClient: remoteChrome.ProtocolApi | null = null; // SAMEDI
+    private _browserLevelClient: remoteChrome.ProtocolApi | null = null;
 
     public constructor (runtimeInfo: RuntimeInfo) {
         this._runtimeInfo = runtimeInfo;
@@ -461,7 +461,7 @@ export class BrowserClient {
         }
     }
 
-    // SAMEDI: browser-level CDP client + isolated context creation/disposal
+
     private async _getBrowserLevelClient (): Promise<remoteChrome.ProtocolApi> {
         if (this._browserLevelClient)
             return this._browserLevelClient;
diff --git a/src/browser/provider/built-in/dedicated/chrome/index.js b/src/browser/provider/built-in/dedicated/chrome/index.js
@@ -10,7 +10,7 @@ import {
 } from './local-chrome';
 import { GET_WINDOW_DIMENSIONS_INFO_SCRIPT } from '../../../utils/client-functions';
 import { BrowserClient } from './cdp-client';
-import { NativeAutomationIsolatedWindow } from '../../../../../native-automation/isolated-window'; // SAMEDI
+import { NativeAutomationIsolatedWindow } from '../../../../../native-automation/isolated-window';
 import { dispatchEvent as dispatchNativeAutomationEvent, navigateTo } from '../../../../../native-automation/utils/cdp';
 import { chromeBrowserProviderLogger } from '../../../../../utils/debug-loggers';
 import { EventType } from '../../../../../native-automation/types';
@@ -62,7 +62,7 @@ export default {
         await nativeAutomation.start();
 
         runtimeInfo.nativeAutomation        = nativeAutomation;
-        runtimeInfo.nativeAutomationOptions = nativeAutomationOptions; // SAMEDI: store for isolated session creation
+        runtimeInfo.nativeAutomationOptions = nativeAutomationOptions;
     },
 
     async _startChrome (startOptions, pageUrl) {
@@ -223,7 +223,7 @@ export default {
         }
     },
 
-    // SAMEDI: create/dispose isolated browser contexts via CDP
+
     async createIsolatedSession (browserId) {
         const runtimeInfo   = this.openedBrowsers[browserId];
         const browserClient = runtimeInfo.browserClient;
diff --git a/src/client-functions/selectors/selector-builder.js b/src/client-functions/selectors/selector-builder.js
@@ -157,8 +157,8 @@ export default class SelectorBuilder extends ClientFunctionBuilder {
             visibilityCheck:           !!this.options.visibilityCheck,
             timeout:                   this.options.timeout,
             strictError:               this.options.strictError,
-            counterMode:               !!this.options.counterMode, // SAMEDI: isolated session selector support
-            getVisibleValueMode:       !!this.options.getVisibleValueMode, // SAMEDI
+            counterMode:               !!this.options.counterMode,
+            getVisibleValueMode:       !!this.options.getVisibleValueMode,
         });
     }
 
diff --git a/src/native-automation/isolated-window.ts b/src/native-automation/isolated-window.ts
@@ -1,4 +1,4 @@
-// SAMEDI: stripped-down NativeAutomation for isolated sessions (no request interception)
+// Stripped-down NativeAutomation for isolated sessions (no request interception)
 import { ProtocolApi } from 'chrome-remote-interface';
 import { NativeAutomationBase } from './index';
 import { NativeAutomationInitOptions } from '../shared/types';
diff --git a/src/test-run/commands/execute-client-function.js b/src/test-run/commands/execute-client-function.js
@@ -39,8 +39,8 @@ export class ExecuteSelectorCommand extends ExecuteClientFunctionCommandBase {
             { name: 'needError' },
             { name: 'index', defaultValue: 0 },
             { name: 'strictError' },
-            { name: 'counterMode', defaultValue: false }, // SAMEDI: isolated session selector support
-            { name: 'getVisibleValueMode', defaultValue: false }, // SAMEDI
+            { name: 'counterMode', defaultValue: false },
+            { name: 'getVisibleValueMode', defaultValue: false },
         ];
     }
 }
diff --git a/src/test-run/index.ts b/src/test-run/index.ts
@@ -137,7 +137,6 @@ import NativeAutomationRequestPipeline from '../native-automation/request-pipeli
 import { NativeAutomationBase } from '../native-automation';
 import ReportDataLog from '../reporter/report-data-log';
 import remoteChrome from 'chrome-remote-interface';
-// SAMEDI: isolated session support
 import { IsolatedSession } from './isolated-session';
 import { IsolatedTestController } from '../api/test-controller/isolated';
 
@@ -275,7 +274,7 @@ export default class TestRun extends AsyncEventEmitter {
     private readonly _roleProvider: RoleProvider;
     public readonly isNativeAutomation: boolean;
     public readonly isExperimentalMultipleWindows: boolean;
-    private _isolatedSessions: IsolatedSession[]; // SAMEDI
+    private _isolatedSessions: IsolatedSession[];
 
     public constructor ({ test, browserConnection, screenshotCapturer, globalWarningLog, opts, messageBus, startRunExecutionTime, nativeAutomation }: TestRunInit) {
         super();
@@ -307,7 +306,7 @@ export default class TestRun extends AsyncEventEmitter {
 
         this.disableMultipleWindows        = opts.disableMultipleWindows as boolean;
         this.isExperimentalMultipleWindows = opts.experimentalMultipleWindows as boolean;
-        this._isolatedSessions             = []; // SAMEDI
+        this._isolatedSessions             = [];
 
         this.requestTimeout = this._getRequestTimeout(test, opts);
 
@@ -723,7 +722,7 @@ export default class TestRun extends AsyncEventEmitter {
             await this._enqueueSetBreakpointCommand(void 0, null, errStr);
         }
 
-        await this._disposeIsolatedSessions(); // SAMEDI
+        await this._disposeIsolatedSessions();
 
         await this.emit('before-done');
 
@@ -1449,7 +1448,7 @@ export default class TestRun extends AsyncEventEmitter {
         return !disableMultipleWindows && !(test as LegacyTestRun).isLegacy && !!testRun.activeWindowId;
     }
 
-    // SAMEDI: isolated session lifecycle — create, dispose, find
+
     public async createIsolatedSession (): Promise<IsolatedSession> {
         const plugin = this.browserConnection.provider.plugin;
 
diff --git a/src/test-run/isolated-session.ts b/src/test-run/isolated-session.ts
@@ -1,4 +1,4 @@
-// SAMEDI: IsolatedSession — manages CDP browser context lifecycle, command routing, and eval
+// IsolatedSession — manages CDP browser context lifecycle, command routing, and eval
 import { nanoid } from 'nanoid';
 import { ProtocolApi } from 'chrome-remote-interface';
 import AsyncEventEmitter from '../utils/async-event-emitter';

Original file line number	Diff line number	Diff line change
`@@ -648,7 +648,7 @@ export default class TestController {`
`648`	`648`	`return this.enqueueCommand(ReportCommand, { args });`
`649`	`649`	`}`
`650`	`650`
`651`		`- // SAMEDI: isolated session opener — creates a CDP-isolated browser context`
	`651`	`+ // Open an isolated browser session via CDP Target.createBrowserContext`
`652`	`652`	`_openIsolatedSession$ () {`
`653`	`653`	`const callsite = getCallsiteForMethod('openIsolatedSession');`
`654`	`654`
Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-// SAMEDI: IsolatedTestController — test controller for CDP-isolated browser sessions (t2 API)`
	`1`	`+// IsolatedTestController — test controller for CDP-isolated browser sessions (t2 API)`
`2`	`2`	`//`
`3`	`3`	`// The t2 object returned by t.openIsolatedSession(). Mirrors TestController's`
`4`	`4`	`// delegatedAPI pattern but routes commands to IsolatedSession.executeCommand()`