How santosh1664/browserless-chromium works
Browserless is a browser-automation platform exposing HTTP and WebSocket interfaces for Chromium operations, including REST-style tasks, browser protocols, custom functions, and BrowserQL. A request enters the server and is routed to an operation; BrowserQL also supports GraphQL subscriptions over WebSocket. The tree shows management endpoints and browser backends as distinct product areas. Evidence is limited to the supplied excerpts and SOURCE INDEX; where runtime wiring was not shown, the graph preserves capabilities without guessing their call paths.
Main entry points: server.ts HTTP and WS server · http Chromium HTTP routes · index.ts Browser manager · ws-session.ts BrowserQL WebSocket
Components 24
Request interfaces
- HTTP and WS server
src/server.ts - Chromium HTTP routes
src/routes/chromium/http - Chromium WS routes
src/routes/chromium/ws - HTTP operation handlers
src/shared - Function runner handler
src/shared/utils/function/handler.ts - In-browser function client
src/shared/utils/function/client.ts - Request schema validation
src/shared/utils/schema-validator.ts
Browser runtime
- Browser manager
src/browsers/index.ts - Playwright backend
src/browsers/browsers.playwright.ts - CDP backend
src/browsers/browsers.cdp.ts - Navigation security
src/network-security.ts
BrowserQL
- BrowserQL HTTP
src/bql/http.ts - BrowserQL WebSocket
src/bql/ws-session.ts - BrowserQL executor
src/bql/executor.ts - BrowserQL browser API
src/bql/api/browser-api.ts - GraphQL schema assembly
src/bql/schema/build.ts - BrowserQL resolvers
src/bql/schema/resolvers - Event subscriptions
src/bql/schema/resolvers/subscription.ts - JSON serialization
src/bql/json.ts - BrowserQL patterns
src/bql/patterns.ts
Platform operations
- Management endpoints
src/routes/management/http - Runtime configuration
src/config.ts - Metrics and monitoring
src/metrics.ts
Other components
- API clients
Connections 17
- API clients → HTTP and WS server: sends requests
- HTTP and WS server → Request schema validation: validates schemas
src/server.ts - HTTP and WS server → Chromium HTTP routes: routes HTTP
- HTTP and WS server → Chromium WS routes: routes WebSocket
- Chromium HTTP routes → HTTP operation handlers: dispatches operations
- Chromium HTTP routes → Function runner handler: dispatches functions
- Function runner handler → In-browser function client: runs page code
src/shared/utils/function/handler.ts - Browser manager → Playwright backend: provides backend
- Browser manager → CDP backend: provides backend
- Playwright backend → Runtime configuration: reads settings
src/browsers/browsers.playwright.ts - Runtime configuration → Navigation security: uses policies
src/config.ts - BrowserQL HTTP → BrowserQL executor: executes queries
- BrowserQL WebSocket → BrowserQL executor: executes operations
- BrowserQL WebSocket → JSON serialization: formats messages
src/bql/ws-session.ts - BrowserQL browser API → BrowserQL patterns: matches patterns
src/bql/api/browser-api.ts - GraphQL schema assembly → BrowserQL resolvers: registers resolvers
src/bql/schema/build.ts - Event subscriptions → BrowserQL browser API: streams browser events
src/bql/schema/resolvers/subscription.ts