# skyrhrg/ocean-booster-version architecture

> Architecture diagram of the GitHub repository skyrhrg/ocean-booster-version, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/skyrhrg/ocean-booster-version
- Repository: https://github.com/skyrhrg/ocean-booster-version

## Overview

This package is Playwright’s Node.js driver: it exposes browser automation through a client API and command-line tools, with server-side browser control and protocol dispatch. The principal workflow is a user invoking the CLI or API, requests crossing the driver boundary, and server/browser-engine code acting on pages and network traffic. Separate branches cover recording/debugging and browser-state handling. The README is empty; relationships are limited to calls visible in excerpts or module references in the SOURCE INDEX, so unsampled capability links are omitted.

Main entry points: [`playwright/driver/package/lib/server/network.js`](https://github.com/skyrhrg/ocean-booster-version/blob/main/playwright/driver/package/lib/server/network.js) (Network requests), [`playwright/driver/package/lib/server/browserContext.js`](https://github.com/skyrhrg/ocean-booster-version/blob/main/playwright/driver/package/lib/server/browserContext.js) (Browser contexts), [`playwright/driver/package/lib/server/debugController.js`](https://github.com/skyrhrg/ocean-booster-version/blob/main/playwright/driver/package/lib/server/debugController.js) (Debug controller), [`playwright/driver/package/lib/server/dispatchers/dispatcher.js`](https://github.com/skyrhrg/ocean-booster-version/blob/main/playwright/driver/package/lib/server/dispatchers/dispatcher.js) (Protocol dispatch)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Entry points"]
  node_cli["CLI commands<br/>[program.js]"]
end

subgraph group_boundary["Driver boundary"]
  node_client["Client API<br/>[api.js]"]
  node_connection["Client connection<br/>[connection.js]"]
  node_server["Playwright server"]
  node_dispatch["Protocol dispatch<br/>[dispatcher.js]"]
  node_validator["Protocol validation<br/>[validator.js]"]
end

subgraph group_runtime["Automation runtime"]
  node_context["Browser contexts<br/>[browserContext.js]"]
  node_pages["Pages and frames<br/>[page.js]"]
  node_frames["Frame operations<br/>[frames.js]"]
  node_javascript["JavaScript execution<br/>[javascript.js]"]
  node_instrumentation["Runtime instrumentation<br/>[instrumentation.js]"]
  node_network["Network requests<br/>[network.js]"]
  node_storage["Storage state<br/>[storageScript.js]"]
  node_utils["Shared utilities<br/>[builtins.js]"]
  node_promises["Async primitives<br/>[manualPromise.js]"]
  node_events["Event helpers<br/>[eventsHelper.js]"]
  node_crypto["Cryptographic helpers<br/>[crypto.js]"]
  node_process["Process launcher<br/>[processLauncher.js]"]
  node_utils_bundle["Bundled utilities<br/>[utilsBundle.js]"]
end

subgraph group_engines["Browser engines"]
  node_chromium["Chromium backend"]
  node_firefox["Firefox backend"]
  node_bidi["WebDriver BiDi backend"]
end

subgraph group_tools["Recording and debug"]
  node_recorder["Action recorder<br/>[recorder.js]"]
  node_recorder_app["Recorder application<br/>[recorderApp.js]"]
  node_debug["Debug controller<br/>[debugController.js]"]
  node_codegen["Code generation<br/>[languages.js]"]
end

node_user(("Automation user"))

node_user -->|"runs commands"| node_cli
node_cli -->|"launches browser"| node_client
node_dispatch -->|"removes listeners"| node_events
node_chromium -->|"removes listeners"| node_events
node_debug -->|"registers listener"| node_instrumentation
node_debug -->|"extends app"| node_recorder_app
node_debug -.->|"uses launcher"| node_process
node_context -.->|"captures state"| node_storage
node_context -.->|"manages requests"| node_network
node_chromium -.->|"creates requests"| node_network
node_firefox -.->|"uses request model"| node_network
node_bidi -.->|"uses request model"| node_network
node_recorder -.->|"records actions"| node_context
node_recorder_app -.->|"generates scripts"| node_codegen
node_server -.->|"routes messages"| node_dispatch
node_connection -.->|"communicates with"| node_server
node_dispatch -.->|"validates messages"| node_validator
node_pages -.->|"delegates frame work"| node_frames
node_frames -.->|"evaluates scripts"| node_javascript
node_pages -.->|"emits events"| node_instrumentation
node_network -.->|"waits asynchronously"| node_promises
node_utils_bundle -.->|"bundles helpers"| node_utils
node_context -.->|"creates identifiers"| node_crypto

click node_cli "https://github.com/skyrhrg/ocean-booster-version/blob/main/playwright/driver/package/lib/cli/program.js"
click node_client "https://github.com/skyrhrg/ocean-booster-version/blob/main/playwright/driver/package/lib/client/api.js"
click node_connection "https://github.com/skyrhrg/ocean-booster-version/blob/main/playwright/driver/package/lib/client/connection.js"
click node_server "https://github.com/skyrhrg/ocean-booster-version/blob/main/playwright/driver/package/lib/remote/playwrightServer.js"
click node_dispatch "https://github.com/skyrhrg/ocean-booster-version/blob/main/playwright/driver/package/lib/server/dispatchers/dispatcher.js"
click node_validator "https://github.com/skyrhrg/ocean-booster-version/blob/main/playwright/driver/package/lib/protocol/validator.js"
click node_context "https://github.com/skyrhrg/ocean-booster-version/blob/main/playwright/driver/package/lib/server/browserContext.js"
click node_pages "https://github.com/skyrhrg/ocean-booster-version/blob/main/playwright/driver/package/lib/server/page.js"
click node_frames "https://github.com/skyrhrg/ocean-booster-version/blob/main/playwright/driver/package/lib/server/frames.js"
click node_javascript "https://github.com/skyrhrg/ocean-booster-version/blob/main/playwright/driver/package/lib/server/javascript.js"
click node_instrumentation "https://github.com/skyrhrg/ocean-booster-version/blob/main/playwright/driver/package/lib/server/instrumentation.js"
click node_network "https://github.com/skyrhrg/ocean-booster-version/blob/main/playwright/driver/package/lib/server/network.js"
click node_storage "https://github.com/skyrhrg/ocean-booster-version/blob/main/playwright/driver/package/lib/server/storageScript.js"
click node_chromium "https://github.com/skyrhrg/ocean-booster-version/blob/main/playwright/driver/package/lib/server/chromium/crNetworkManager.js"
click node_firefox "https://github.com/skyrhrg/ocean-booster-version/blob/main/playwright/driver/package/lib/server/firefox/ffNetworkManager.js"
click node_bidi "https://github.com/skyrhrg/ocean-booster-version/blob/main/playwright/driver/package/lib/server/bidi/bidiNetworkManager.js"
click node_recorder "https://github.com/skyrhrg/ocean-booster-version/blob/main/playwright/driver/package/lib/server/recorder.js"
click node_recorder_app "https://github.com/skyrhrg/ocean-booster-version/blob/main/playwright/driver/package/lib/server/recorder/recorderApp.js"
click node_debug "https://github.com/skyrhrg/ocean-booster-version/blob/main/playwright/driver/package/lib/server/debugController.js"
click node_codegen "https://github.com/skyrhrg/ocean-booster-version/blob/main/playwright/driver/package/lib/server/codegen/languages.js"
click node_utils "https://github.com/skyrhrg/ocean-booster-version/blob/main/playwright/driver/package/lib/utils/isomorphic/builtins.js"
click node_promises "https://github.com/skyrhrg/ocean-booster-version/blob/main/playwright/driver/package/lib/utils/isomorphic/manualPromise.js"
click node_events "https://github.com/skyrhrg/ocean-booster-version/blob/main/playwright/driver/package/lib/server/utils/eventsHelper.js"
click node_crypto "https://github.com/skyrhrg/ocean-booster-version/blob/main/playwright/driver/package/lib/server/utils/crypto.js"
click node_process "https://github.com/skyrhrg/ocean-booster-version/blob/main/playwright/driver/package/lib/server/utils/processLauncher.js"
click node_utils_bundle "https://github.com/skyrhrg/ocean-booster-version/blob/main/playwright/driver/package/lib/utilsBundle.js"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_cli,node_user toneBlue
class node_client,node_connection,node_server,node_dispatch,node_validator toneAmber
class node_context,node_pages,node_frames,node_javascript,node_instrumentation,node_network,node_storage,node_utils,node_promises,node_events,node_crypto,node_process,node_utils_bundle toneMint
class node_chromium,node_firefox,node_bidi toneRose
class node_recorder,node_recorder_app,node_debug,node_codegen toneIndigo
```

## Components

### Entry points

- [CLI commands](https://github.com/skyrhrg/ocean-booster-version/blob/main/playwright/driver/package/lib/cli/program.js): `playwright/driver/package/lib/cli/program.js`

### Driver boundary

- [Client API](https://github.com/skyrhrg/ocean-booster-version/blob/main/playwright/driver/package/lib/client/api.js): `playwright/driver/package/lib/client/api.js`
- [Client connection](https://github.com/skyrhrg/ocean-booster-version/blob/main/playwright/driver/package/lib/client/connection.js): `playwright/driver/package/lib/client/connection.js`
- [Playwright server](https://github.com/skyrhrg/ocean-booster-version/blob/main/playwright/driver/package/lib/remote/playwrightServer.js): `playwright/driver/package/lib/remote/playwrightServer.js`
- [Protocol dispatch](https://github.com/skyrhrg/ocean-booster-version/blob/main/playwright/driver/package/lib/server/dispatchers/dispatcher.js): `playwright/driver/package/lib/server/dispatchers/dispatcher.js`
- [Protocol validation](https://github.com/skyrhrg/ocean-booster-version/blob/main/playwright/driver/package/lib/protocol/validator.js): `playwright/driver/package/lib/protocol/validator.js`

### Automation runtime

- [Browser contexts](https://github.com/skyrhrg/ocean-booster-version/blob/main/playwright/driver/package/lib/server/browserContext.js): `playwright/driver/package/lib/server/browserContext.js`
- [Pages and frames](https://github.com/skyrhrg/ocean-booster-version/blob/main/playwright/driver/package/lib/server/page.js): `playwright/driver/package/lib/server/page.js`
- [Frame operations](https://github.com/skyrhrg/ocean-booster-version/blob/main/playwright/driver/package/lib/server/frames.js): `playwright/driver/package/lib/server/frames.js`
- [JavaScript execution](https://github.com/skyrhrg/ocean-booster-version/blob/main/playwright/driver/package/lib/server/javascript.js): `playwright/driver/package/lib/server/javascript.js`
- [Runtime instrumentation](https://github.com/skyrhrg/ocean-booster-version/blob/main/playwright/driver/package/lib/server/instrumentation.js): `playwright/driver/package/lib/server/instrumentation.js`
- [Network requests](https://github.com/skyrhrg/ocean-booster-version/blob/main/playwright/driver/package/lib/server/network.js): `playwright/driver/package/lib/server/network.js`
- [Storage state](https://github.com/skyrhrg/ocean-booster-version/blob/main/playwright/driver/package/lib/server/storageScript.js): `playwright/driver/package/lib/server/storageScript.js`
- [Shared utilities](https://github.com/skyrhrg/ocean-booster-version/blob/main/playwright/driver/package/lib/utils/isomorphic/builtins.js): `playwright/driver/package/lib/utils/isomorphic/builtins.js`
- [Async primitives](https://github.com/skyrhrg/ocean-booster-version/blob/main/playwright/driver/package/lib/utils/isomorphic/manualPromise.js): `playwright/driver/package/lib/utils/isomorphic/manualPromise.js`
- [Event helpers](https://github.com/skyrhrg/ocean-booster-version/blob/main/playwright/driver/package/lib/server/utils/eventsHelper.js): `playwright/driver/package/lib/server/utils/eventsHelper.js`
- [Cryptographic helpers](https://github.com/skyrhrg/ocean-booster-version/blob/main/playwright/driver/package/lib/server/utils/crypto.js): `playwright/driver/package/lib/server/utils/crypto.js`
- [Process launcher](https://github.com/skyrhrg/ocean-booster-version/blob/main/playwright/driver/package/lib/server/utils/processLauncher.js): `playwright/driver/package/lib/server/utils/processLauncher.js`
- [Bundled utilities](https://github.com/skyrhrg/ocean-booster-version/blob/main/playwright/driver/package/lib/utilsBundle.js): `playwright/driver/package/lib/utilsBundle.js`

### Browser engines

- [Chromium backend](https://github.com/skyrhrg/ocean-booster-version/blob/main/playwright/driver/package/lib/server/chromium/crNetworkManager.js): `playwright/driver/package/lib/server/chromium/crNetworkManager.js`
- [Firefox backend](https://github.com/skyrhrg/ocean-booster-version/blob/main/playwright/driver/package/lib/server/firefox/ffNetworkManager.js): `playwright/driver/package/lib/server/firefox/ffNetworkManager.js`
- [WebDriver BiDi backend](https://github.com/skyrhrg/ocean-booster-version/blob/main/playwright/driver/package/lib/server/bidi/bidiNetworkManager.js): `playwright/driver/package/lib/server/bidi/bidiNetworkManager.js`

### Recording and debug

- [Action recorder](https://github.com/skyrhrg/ocean-booster-version/blob/main/playwright/driver/package/lib/server/recorder.js): `playwright/driver/package/lib/server/recorder.js`
- [Recorder application](https://github.com/skyrhrg/ocean-booster-version/blob/main/playwright/driver/package/lib/server/recorder/recorderApp.js): `playwright/driver/package/lib/server/recorder/recorderApp.js`
- [Debug controller](https://github.com/skyrhrg/ocean-booster-version/blob/main/playwright/driver/package/lib/server/debugController.js): `playwright/driver/package/lib/server/debugController.js`
- [Code generation](https://github.com/skyrhrg/ocean-booster-version/blob/main/playwright/driver/package/lib/server/codegen/languages.js): `playwright/driver/package/lib/server/codegen/languages.js`

### Other components

- **Automation user**

## Connections

- Automation user → CLI commands: runs commands (evidence: `playwright/driver/package/lib/cli/program.js`)
- CLI commands → Client API: launches browser (evidence: `playwright/driver/package/lib/cli/program.js`)
- Protocol dispatch → Event helpers: removes listeners (evidence: `playwright/driver/package/lib/server/dispatchers/dispatcher.js`)
- Chromium backend → Event helpers: removes listeners (evidence: `playwright/driver/package/lib/server/chromium/crNetworkManager.js`)
- Debug controller → Runtime instrumentation: registers listener (evidence: `playwright/driver/package/lib/server/debugController.js`)
- Debug controller → Recorder application: extends app (evidence: `playwright/driver/package/lib/server/debugController.js`)
- Debug controller → Process launcher: uses launcher (evidence: `playwright/driver/package/lib/server/debugController.js`)
- Browser contexts → Storage state: captures state (evidence: `playwright/driver/package/lib/server/browserContext.js`)
- Browser contexts → Network requests: manages requests (evidence: `playwright/driver/package/lib/server/browserContext.js`)
- Chromium backend → Network requests: creates requests (evidence: `playwright/driver/package/lib/server/chromium/crNetworkManager.js`)
- Firefox backend → Network requests: uses request model (evidence: `playwright/driver/package/lib/server/firefox/ffNetworkManager.js`)
- WebDriver BiDi backend → Network requests: uses request model (evidence: `playwright/driver/package/lib/server/bidi/bidiNetworkManager.js`)
- Action recorder → Browser contexts: records actions (evidence: `playwright/driver/package/lib/server/browserContext.js`)
- Recorder application → Code generation: generates scripts
- Playwright server → Protocol dispatch: routes messages
- Client connection → Playwright server: communicates with
- Protocol dispatch → Protocol validation: validates messages (evidence: `playwright/driver/package/lib/server/dispatchers/dispatcher.js`)
- Pages and frames → Frame operations: delegates frame work (evidence: `playwright/driver/package/lib/server/page.js`)
- Frame operations → JavaScript execution: evaluates scripts
- Pages and frames → Runtime instrumentation: emits events (evidence: `playwright/driver/package/lib/server/page.js`)
- Network requests → Async primitives: waits asynchronously (evidence: `playwright/driver/package/lib/server/network.js`)
- Bundled utilities → Shared utilities: bundles helpers
- Browser contexts → Cryptographic helpers: creates identifiers (evidence: `playwright/driver/package/lib/server/browserContext.js`)
