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

Add the ability to open fully isolated browser sessions within a single
test. Each session gets its own Chrome browser context (separate cookies,
localStorage, sessionStorage, service workers) via CDP's
Target.createBrowserContext().

Includes 40 functional tests, selector chaining support, t2.run() for
transparent Selector/ClientFunction evaluation, and automatic cleanup.

Requires Native Automation mode (Chrome only).

Author: sam-yh

Gulpfile.js

@@ -33,6 +33,7 @@ const {
     TESTS_GLOB,
     LEGACY_TESTS_GLOB,
     MULTIPLE_WINDOWS_TESTS_GLOB,
+    ISOLATED_SESSIONS_TESTS_GLOB,
     HEADED_CHROME_FIREFOX_TESTS_GLOB,
 } = require('./gulp/constants/functional-test-globs');
 
@@ -466,6 +467,13 @@ gulp.step('test-functional-local-multiple-windows-na-run', () => {
 
 gulp.task('test-functional-local-multiple-windows-na', gulp.series('prepare-tests', 'test-functional-local-multiple-windows-na-run'));
 
+// Isolated multi-session tests run against native automation Chrome
+gulp.step('test-functional-local-isolated-sessions-run', () => {
+    return testFunctional(ISOLATED_SESSIONS_TESTS_GLOB, functionalTestConfig.testingEnvironmentNames.localChrome, { nativeAutomation: true });
+});
+
+gulp.task('test-functional-local-isolated-sessions', gulp.series('prepare-tests', 'test-functional-local-isolated-sessions-run'));
+
 gulp.step('test-functional-local-chrome-firefox-headed-run', () => {
     return testFunctional(HEADED_CHROME_FIREFOX_TESTS_GLOB, functionalTestConfig.testingEnvironmentNames.localBrowsersChromeFirefox);
 });

gulp/constants/functional-test-globs.js

@@ -1,4 +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';
 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';
@@ -12,13 +13,15 @@ const SCREENSHOT_TESTS_GLOB = [
 const TESTS_GLOB = [
     BASIC_TESTS_GLOB,
     `!${MULTIPLE_WINDOWS_TESTS_GLOB}`,
+    `!${ISOLATED_SESSIONS_TESTS_GLOB}`,
     `!${COMPILER_SERVICE_TESTS_GLOB}`,
 ];
 
 module.exports = {
     TESTS_GLOB,
     LEGACY_TESTS_GLOB,
     MULTIPLE_WINDOWS_TESTS_GLOB,
+    ISOLATED_SESSIONS_TESTS_GLOB,
     BASIC_TESTS_GLOB,
     COMPILER_SERVICE_TESTS_GLOB,
     SCREENSHOT_TESTS_GLOB,

src/api/test-controller/index.js

@@ -647,6 +647,23 @@ export default class TestController {
     [delegatedAPI(ReportCommand.methodName)] (...args) {
         return this.enqueueCommand(ReportCommand, { args });
     }
+
+    // isolated session opener — creates a CDP-isolated browser context
+    _openIsolatedSession$ () {
+        const callsite = getCallsiteForMethod('openIsolatedSession');
+
+        return this._enqueueTask('openIsolatedSession', () => {
+            return async () => {
+                if (!this.testRun.isNativeAutomation)
+                    throw new Error('openIsolatedSession requires Native Automation mode');
+
+                const isolatedSession = await this.testRun.createIsolatedSession();
+
+                return isolatedSession.controller;
+            };
+        }, callsite);
+    }
+
     shouldStop (command) {
         // NOTE: should always stop on Debug command
         return command === 'debug';