Getting Started in the Browser

Overview#

This guide will help you start integrating the Jabra library into your browser-based softphone app.

If your solution works as a standalone app, refer to Getting Started in Node instead.

Prerequisites#

You need to install three components to use this library in a browser:

A Native Console App
A Chrome Extension
The jabra-js npm package.

Note: Optionally, you can use the library via the WebHID API. This option does not require the Native Console App nor the Chrome Extension to be installed. See the WebHID guide for more information.

Install the Native Console App#

The Native Console App communicates with the operating system and any attached Jabra device.

You can install the app via this link.

Install the Chrome Extension#

The Chrome Extension enables communication with the native console app (see previous section).

Install the extension through the Chrome Web Store.

Install the NPM package#

You can do so by running the following command in a terminal:

npm i @gnaudio/jabra-js --save

Importing the NPM package#

There are several ways of including the package in your application. A common approach is to use a module bundler like Webpack and import via the node_modules id, like the example below.

See our guide on Modules Import Strategies to learn more about different import formats.

import { init } from '@gnaudio/jabra-js';

init().then((api) => {
  // Library initialized...
});

If you are using the package directly on your website, point to the "browser-umd" build instead:

<html>
  <head>
    <script src="./node_modules/@gnaudio/jabra-js/browser-umd/index.js"></script>

    <script>
      // The module will be loaded into global scope as `jabra`
      jabra.init().then((api) => {
        // Library initialized...
      });
    </script>
  </head>
</html>

That's it! You can start integrating the Jabra library into your solution.

Next steps#

Create your first app that uses the Jabra library by following the Hello World Guide.