Skip to main content
Among other things, the Hyperbeam client-side JavaScript SDK allows you to:
  • Connect to a virtual browser
  • Control the virtual browser navigation programmatically
  • Query the virtual browser state and listen to events
  • Manage user control permissions
  • Resize the browser
  • Set local virtual browser volume
The library is published on npm as @hyperbeam/web.

Installation

Using npm:
Terminal
$ npm install @hyperbeam/web --save
Using UNPKG:
JavaScript
<script type="module">
  import Hyperbeam from "https://unpkg.com/@hyperbeam/web@latest/dist/index.js"
  // ...
</script>

SDK Reference

Initializing the SDK

Create an instance of the HyperbeamClient object.

The HyperbeamClient Object

Control the virtual browser, manage user permissions, and debug connection issues.

Examples

Loading a virtual browser

How to create an instance of the HyperbeamClient object.

Destroying the embed

How to tear down network connections and browser events.

Setting video volume

How to set the local volume for the virtual browser.

Getting user ID

How to get the client’s user ID.

Pausing video stream

How to pause/resume the local virtual browser video stream.

Setting admin token

How to set the client’s admin token.

Setting permissions

How to set user permissions based on a user’s ID.

Manual reconnection

How to manually reconnect.

Resizing the browser

How to resize the virtual browser to a specific width and height.

Send events programmatically

How to send keyboard, mouse, and wheel events to the virtual browser.

Tighter control over keyboard events

How to customize keyboard events sent the virtual browser.

Control tabs programmatically

How to use Hyperbeam’s tab API.

Listen to tab events

How to listen to tab events.

Optimize server location

How to create a session with the optimal server location.