JavaScript Integration Component

The Jabra JavaScript SDK is the successor of the Browser Component and Node.js Component.
It can be used for both Web Applications running in browsers and Desktop applications written in Node.js.

Most notable improvements are:

  • Option to use WebHID in Chromium-based browsers
  • Available on Windows, macOS, and Linux, with native support for Apple M1-based systems
  • New modular architecture that allows Jabra to quickly adapt, expand, and bugfix the libraries

Functionality

The JavaScript version 4 library supports the following functionality:

  • Call Control

Please use the Browser Component or Node.js Component if you need support for other features, like:

  • Device settings
  • Telemetry data
  • Configurable buttons

Supported Platforms

With the JavaScript SDK library we support all major platforms:

  • Windows
  • macOS
  • Linux
  • Chrome OS

Tested Platforms

The latest release was tested on these operating systems and hardware:

Operating System Tested on
Windows 11 Intel 64-bit
Windows 10 Intel 64-bit
macOS 12 - Monterey Intel 64-bit, Apple M1
macOS 11 - Big Sur Intel 64-bit, Apple M1
Ubuntu 20.04 Intel 64-bit
Chrome OS 94 Intel 64-bit

Supported Browsers

For browser integration we support Google Chrome and Microsoft Edge.
Each release is tested on the latest version of each browser.

Installation

The Jabra JavaScript library package from npm is needed for both Web and Node.js integrations.
Find the link under Resources.

Additional Components for Browser Integration

The Jabra JavaScript library can be used without installing any software on the clients.
This is achieved by utilizing WebHID, which is available in Chromium-based browsers.

WebHID is very limited in the operations it allows, so opting for this option means:

  • Only call control is supported
  • For wireless devices, only the USB connected dongles and deskstands will be available
    • Call control works for wireless devices, but it will be the name of the dongle/deskstand that is displayed

Recommended Approach

It is recommended that the following two components are installed on the client machines:

  • Jabra Device Connector for browsers
    • This is a small application which must be installed on the computer accessing the web application
  • Integration Extension for Jabra Device Connector
    • This is a browser extension that enable the Jabra JavaScript library to connect to the Jabra Device Connector for browsers

The benefits of installing these components are:

  • More advanced functionality, like telemetry data, devices settings, configurable buttons, will be available in the future

Documentation

For documentation on how to use the JavaScript library, see the JavaScript documentation page.

Release Highlights

For detailed information see the changelog.

Version 4.1.2

🔧 Fixes

  • Fixed an issue with Device Connector not being recognized as an application on Mac OS
  • Improved error message when Device Connector is not installed on the system
  • Improved error messages across the Easy Call Control module
  • Stability improvements for the Easy Call Control module

🐛 Known Issues

  • Webpack doesn't pack the console app properly for Nodejs apps (e.g. Electron)
    • Error message: UnhandledPromiseRejectionWarning: Error: Cannot find native console app. Please make sure you have installed the SDK correctly.
    • Possible work-around: Adding externals: ["@gnaudio/jabra-js/node-cjs"] to the Webpack config file fixes the issue in certain situations
  • Jabra Speak 410 (UC version) and Jabra Speak 510 (UC version) are not recognized on Chrome OS
  • On Linux, when using the Integration Extension for Jabra Device Connector, the Easy Call Control modules sometimes interpret reject call signals from wireless devices as accept call

Resources

Title Version Last Updated Link
⬇️ Jabra JavaScript library package 4.1.2 Mar 2022 npmjs.com
⬇️ Jabra Device Connector for browsers - Windows 1.0.0 Oct 2021 Download
⬇️ Jabra Device Connector for browsers - macOS 1.0.0 Oct 2021 Download
⬇️ Jabra Device Connector for browsers - Linux 1.0.0 Oct 2021 Download
⬇️ Integration Extension for Jabra Device Connector 1.0 Oct 2021 Google Web Store

For older versions, please see the archive.