introduced browserManager object to control all launched browser and electron instances (#92)

- 🚀 introduced browserManager object to control all launched browser and electron instances (#92)
- 🚀 added steps to start/stop/switch to other browser/electron instances

Author: AlexGalichenko

CHANGELOG.md

@@ -8,6 +8,10 @@ Check [Keep a Changelog](http://keepachangelog.com/) for recommendations on how
 :beetle: - bugfix
 :x: - deprecation
 
+## [0.41.0]
+- :rocket: introduced browserManager object to control all launched browser and electron instances
+- :rocket: added steps to start/stop/switch to other browser/electron instances
+
 ## [0.40.0]
 - :rocket: changed simple expects to poll expects
 - :rocket: changed behavior of _I switch to {string} window_ step (now it is wait for window existence)

README.md

@@ -35,32 +35,40 @@ module.exports = {
 ## Global variables
 @qavajs/steps-playwright exposes following global variables
 
-| variable   | type                                        | description                                  |
-|------------|---------------------------------------------|----------------------------------------------|
-| `browser`  | `Browser`                                   | browser instance                             |
-| `driver`   | `Browser`                                   | browser instance (alias for browser)         |
-| `context`  | `BrowserContext`                            | current browser context                      |
-| `page`     | `Page`                                      | current context page                         |
-| `contexts` | `{ [contextName: string]: BrowserContext }` | Map of opened contexts in multi browser mode |
+| variable         | type                             | description                                                   |
+|------------------|----------------------------------|---------------------------------------------------------------|
+| `browser`        | `Browser \| ElectronApplication` | browser instance                                              |
+| `driver`         | `Browser \| ElectronApplication` | browser instance (alias for browser)                          |
+| `context`        | `BrowserContext`                 | current browser context                                       |
+| `page`           | `Page`                           | current context page                                          |
+| `browserManager` | `BrowserManager`                 | manager to control all opened browsers and electron instances |
 
 ## Connect to playwright server
 In order to connect to playwright server pass _wsEndpoint_ property in capabilities object
 ```typescript
-{
-    capabilities: {
-        browserName: 'chromium',
-        wsEndpoint: 'ws://127.0.0.1:60291/2bd48ce272de2b543e4c8c533f664b83'    
+module.exports = {
+    default: {
+        browser: {
+            capabilities: {
+                browserName: 'chromium',
+                wsEndpoint: 'ws://127.0.0.1:60291/2bd48ce272de2b543e4c8c533f664b83'
+            }
+        },
     }
 }
 ```
 
 ## Connect to cdp endpoint
 In order to connect to CDP endpoint pass _cdpEndpoint_ property in capabilities object 
 ```typescript
-{
-    capabilities: {
-        browserName: 'chromium',
-        cdpEndpoint: 'http://localhost:9222/'    
+module.exports = {
+    default: {
+        browser: {
+            capabilities: {
+                browserName: 'chromium',
+                cdpEndpoint: 'http://localhost:9222/'
+            }
+        },
     }
 }
 ```
@@ -128,3 +136,22 @@ To properly use globals exposed by @qavajs/steps-playwright add corresponding ty
 }
 ```
 
+## Development and testing
+Install dependencies
+`npm install`
+
+Install playwright browsers
+`install:browsers`
+
+Build lib
+`npm run build`
+
+Execute unit test (with vitest)
+`npm run test`
+
+Execute e2e browser tests
+`npm run test:e2e`
+
+Execute e2e electron tests
+`npm run test:e2e:electron`
+

global.d.ts

@@ -1,11 +1,10 @@
 import { Browser, BrowserContext, Page } from 'playwright';
+import { BrowserManager } from './src/browserManager';
 
 declare global {
     var browser: Browser;
     var driver: Browser;
     var context: BrowserContext;
     var page: Page;
-    var contexts: {
-        [contextName: string]: BrowserContext
-    };
+    var browserManager: BrowserManager
 }