@deephaven/jsapi-bootstrap

@deephaven/jsapi-bootstrap

This is a library to bootstrap load the JS API. It provides functionality to load the API and set it in a context object, or to set it globally to retain legacy behaviour. Will display an error if unable to load the API.

Install

npm install --save @deephaven/jsapi-bootstrap

Usage

Using Context

import { ApiBootstrap, useApi } from '@deephaven/jsapi-bootstrap';

function MyComponent() {
  const api = useApi();

  ...
}

<ApiBootstrap apiUrl={API_URL}>
  <MyComponent />
</ApiBootstrap>;

Using API globally (legacy behaviour)

If you're using the JSAPI shim or relying on the API to be set globally, you'll need to lazily load your component first so the API is set before imports attempt to use it.

// App.tsx
import { ApiBootstrap } from '@deephaven/jsapi-bootstrap';

const MyComponent = React.lazy(() => import('./MyComponent'));

<ApiBootstrap apiUrl={API_URL} setGlobally>
    <Suspense fallback={<div>Loading...</div>}>
      <MyComponent />
    </Suspense>
</ApiBootstrap>;

// MyComponent.tsx
import dh from '@deephaven/jsapi-shim';
function MyComponent() {
  const client = new dh.CoreClient(...);

  ...
}

Changelog

1.2.0 (2025-07-16)

Features

• add dhPivotTable, dhAlignLeft, dhAlignCenter, dhAlignRight icons (#2488) (43ca391)
• DH-19146: ElementPlugin mapping hook (#2477) (bc16dbd)
• Table plugin support for GridWidgetPlugin (#2478) (d698759)

Bug Fixes

• DH-19882: Render loop occurring in React v18 (#2490) (d51277b)
• DH-19911: Fix initial isLoading state in usePromiseFactory when autoload is true (#2489) (411f648)