@optimizely/js-sdk-utils

What is @optimizely/js-sdk-utils?

@optimizely/js-sdk-utils is a utility library for the Optimizely JavaScript SDK. It provides various helper functions and utilities to facilitate the implementation and management of Optimizely experiments and feature flags in JavaScript applications.

What are @optimizely/js-sdk-utils's main functionalities?

Event Dispatcher

The Event Dispatcher utility allows you to create and dispatch events to the Optimizely logging endpoint. This is useful for tracking user interactions and experiment data.

const { createEventDispatcher } = require('@optimizely/js-sdk-utils');

const dispatcher = createEventDispatcher();

const event = {
  url: 'https://logx.optimizely.com/v1/events',
  params: {
    account_id: '12345',
    project_id: '67890',
    visitors: [{
      visitor_id: 'visitor_1',
      attributes: [],
      snapshots: []
    }]
  }
};

dispatcher.dispatchEvent(event).then(response => {
  console.log('Event dispatched successfully:', response);
}).catch(error => {
  console.error('Error dispatching event:', error);
});

Logger

The Logger utility provides a simple logging mechanism that can be configured with different log levels. This helps in debugging and monitoring the SDK's behavior.

const { createLogger } = require('@optimizely/js-sdk-utils');

const logger = createLogger({ logLevel: 'info' });

logger.log('info', 'This is an info message');
logger.log('error', 'This is an error message');

Error Handler

The Error Handler utility provides a standardized way to handle errors within the Optimizely SDK. It can be used to catch and process errors, ensuring that they are logged and managed appropriately.

const { createErrorHandler } = require('@optimizely/js-sdk-utils');

const errorHandler = createErrorHandler();

try {
  throw new Error('Something went wrong');
} catch (error) {
  errorHandler.handleError(error);
}

Other packages similar to @optimizely/js-sdk-utils

launchdarkly-js-client-sdk

The LaunchDarkly JavaScript SDK provides similar functionality for managing feature flags and experiments. It includes utilities for event tracking, logging, and error handling, making it a comparable alternative to @optimizely/js-sdk-utils.

unleash-client

Unleash is an open-source feature management solution. The unleash-client package offers utilities for feature toggles, event tracking, and logging, similar to the functionalities provided by @optimizely/js-sdk-utils.

splitio

Split.io's JavaScript SDK offers feature flagging and experimentation capabilities. It includes utilities for event dispatching, logging, and error handling, making it a viable alternative to @optimizely/js-sdk-utils.

README

@optimizely/js-sdk-utils

A collection of utility functions shared between components of the Javascript SDK.

To test

npm test