Experiment Browser SDK

Overview

This is the JavaScript client (web browser) SDK for Experiment, Amplitude's experimentation and feature management platform.

Getting Started

Refer to the Javascript SDK Developer Documentation to get started.

Examples

This repo contains various example applications for getting familiar with the SDK usage. Each example has two applications, one with a basic example, and another with an example for integrating with the amplitude analytics SDK.

• Script Tag (HTML)
  • Basic Example
  • Amplitude Analytics SDK Integration
  • React
  • Basic Example
  • Amplitude Analytics SDK Integration

Browser Compatibility

This SDK works with all major browsers and IE10+. The SDK does make use of Promises, so if you are targeting a browser that does not have native support for Promise (for example, IE), you should include a polyfill for Promise, (for example, es6-promise).

Change Log

All notable changes to this project will be documented in this file. See Conventional Commits for commit guidelines.

1.5.7 (2022-09-26)

Bug Fixes

• #44 ReferenceError: global is not defined (#45) (8722d18)

1.5.6 (2022-09-06)

Bug Fixes

• move isEqual to util, add null check (#42) (f8eec48)

1.5.5 (2022-08-03)

Bug Fixes

• increase timeout for experiment integration to 10 seconds (#39) (1172ccb)

1.5.4 (2022-07-27)

Bug Fixes

• add guard for navigator for use in envs that do no support navigator (#36) (2c8d398)
• update analytics connector dependency (e699a90)

1.5.3 (2022-06-01)

Bug Fixes

• add secondary initial variants as a fallback (7727ba9)
• re-add debug logging (c18dfc9)

1.5.2 (2022-05-28)

Bug Fixes

• polyfill object entries for ie11 (5c318ea)
• polyfill object entries for ie11 (#35) (3d7ab23)

1.5.1 (2022-05-12)

Bug Fixes

• dont use includes to support IE11 (#32) (c9d42d2)
• update analytics connector (0b4a5a6)

1.5.0 (2022-04-30)

Features

• add http client config (#30) (8fa5ea1)

1.4.1 (2022-04-06)

Bug Fixes

• make variant optional in exposure object for segment (#26) (aa29994)
• support script tag installs for analytics connector (#28) (fa6be45)

1.4.0 (2022-02-12)

Bug Fixes

• simplify connector analytics provider (#24) (0aa4eee)

Features

• core package for seamless integration with amplitude analytics (#15) (f62c4cb)
• implement exposure tracking provider (#25) (9fb040c)
• integrate core package into experiment sdk (#16) (7ff0540)
• rename amplitude-core to analytics-connector (#22) (70b3b50)
• update analytics connector to use new exposure event definition (#23) (b76b33c)

1.3.4 (2022-01-24)

Bug Fixes

• remove _logEvent from instance type (#21) (670a2f2)

1.3.3 (2022-01-20)

Bug Fixes

• fix unset user property (#20) (b722506)

1.3.2 (2022-01-20)

Bug Fixes

• revert changes (bee259f)

1.3.1 (2022-01-20)

Bug Fixes

• type issue with global amp instance (#18) (5fcf461)

1.3.0 (2021-10-18)

Features

• unset user properties when variant evaluates to none or is a fallback (#13) (dbab7e8)

1.2.0 (2021-08-12)

Features

• add user properties to analytics events like exposure (#11) (881ab55)

1.1.1 (2021-08-09)

Bug Fixes

• use user provider set by config (3774e3c)

1.1.0 (2021-07-29)

Bug Fixes

• add additional client tests and fixes (#8) (d0d196d)
• don't track exposure to fallbacks and add tests (#9) (bd4917f)
• revert POST to GET request with user in header (#10) (326990c)

Features

• client-side exposure tracking via analytics provider (#7) (30448ab)

1.0.3 (2021-07-19)

Bug Fixes

• use merged ccontext in post body (4ead70a)

1.0.2 (2021-07-16)

Bug Fixes

• use POST instead of GET for fetch request (#6) (5a1c580)

1.0.1 (2021-06-09)

Bug Fixes

• no retry console logging; handle error response (969a5f6)