Sourcemap Explorer
Stack · npm package

@amplitude/analytics-browser

Official Amplitude SDK for Web

latest 2.39.2· MIT· 304 versions publishedView on npm

About

Official Amplitude SDK for Web

analyticsamplitude

Live mirror of the GitHub README. Updated whenever the repo's default branch changes.


Amplitude-TypeScript

This is Amplitude's latest version of the JavaScript SDK, written in TypeScript.

Development

If you plan on contributing to this SDK, here's how you can start.

  1. Clone GitHub repo
  2. Install dependencies
  3. Build and link packages
$ git clone git@github.com:amplitude/Amplitude-TypeScript.git
$ nvm use
$ pnpm --version
$ pnpm install
$ pnpm build

Check our guidelines for repo contributions on CONTRIBUTING.md.

Projects

Testing Locally

To test the SDK locally, you can run our test server.

Before running the test server for the first time, copy ".env.example" as ".env" and replace the variables in '.env' with your own variables.

Run pnpm dev to run the test server. It will open up to the home page automatically in your default browser.

For more details visit the Test Server README.md

Troubleshooting

If you ever see an error that looks like this while running an Nx command (pnpm test, pnpm build, etc...):

 Lerna (powered by Nx)   DB transaction operation error: SqliteFailure(Error { code: SystemIoFailure, extended_code: 522 }, Some("disk I/O error"))

Run npx nx reset and try again

Documentation

See our Typescript SDK Reference for a list and description of all available SDK methods.

Quick facts

Latest version2.39.2
LicenseMIT
AuthorAmplitude Inc
Repositorygithub.com/amplitude/Amplitude-TypeScript
Homepagegithub.com/amplitude/Amplitude-TypeScript
Installnpm install @amplitude/analytics-browser
Direct dependencies8

How Sourcemap Explorer detects @amplitude/analytics-browser

We catch @amplitude/analytics-browser from two complementary signals: bundled source paths and the embedded package.json. Modern bundlers (webpack, Vite, esbuild, Rollup, Turbopack) preserve the original node_modules/@amplitude/analytics-browser/ paths inside the JavaScript sourcemap's sources[] array — that's the canonical signal. When the matching package.json is also captured in sourcesContent[], we read the exact version field — patch number included. No regex guessing, no version inference.

  1. 1

    Confirm the site exposes sourcemaps

    In DevTools Network, check the response headers of any application script for `SourceMap` or `X-SourceMap`. Failing that, fetch the script's last 4 KB and look for a `//# sourceMappingURL=` comment.

  2. 2

    Find the package in the bundle

    Open DevTools → Network → reload. Click any application script and look at its sourcemap. Inside, search `sources[]` for entries matching `node_modules/@amplitude/analytics-browser/` — every match confirms the package is bundled. The matching `sourcesContent[i]` for `node_modules/@amplitude/analytics-browser/package.json` gives you the exact installed version.

  3. 3

    Read the version directly from package.json

    Run `jq -r '. as $m | $m.sources | to_entries[] | select(.value | endswith("node_modules/@amplitude/analytics-browser/package.json")) | $m.sourcesContent[.key] | fromjson | .version' bundle.js.map`. Sourcemap Explorer automates the same query in the popup.

Recent versions

Version
Released
0.1.0
—
0.1.1
—
0.2.1
—
0.2.2
—
0.2.3
—
0.2.4
—
0.3.0
—
0.3.1
—

FAQ

What is @amplitude/analytics-browser used for?

Official Amplitude SDK for Web

How can I tell if a website is using @amplitude/analytics-browser?

Open the page in Chrome with the Sourcemap Explorer extension installed and read the Stack tab. We catch `@amplitude/analytics-browser` from two complementary signals: `node_modules/@amplitude/analytics-browser/` paths inside the JavaScript sourcemap, and the embedded `package.json` we read for exact-version detection. Without the extension you can do the same lookup manually in DevTools — the steps are listed in the "How Sourcemap Explorer detects" section above.

What is the latest version of @amplitude/analytics-browser?

2.39.2, as published on the npm registry. The "Recent versions" table on this page lists the most recent 8 releases with their release dates. Sourcemap Explorer reports the version actually bundled into a site, which can lag the latest release by months on real-world deployments.

Where can I read more?

Project homepage: https://github.com/amplitude/Amplitude-TypeScript. Source code: https://github.com/amplitude/Amplitude-TypeScript. Published on npm: https://www.npmjs.com/package/@amplitude/analytics-browser. Licensed as MIT.

Keep reading on Sourcemap Explorer

Practical guides

Alternative tools

Detected by Sourcemap Explorer

When a bundle ships sourcemaps, we read the embedded package.json for @amplitude/analytics-browser and report the precise version. Without sourcemaps, an import / require in the page's scripts is enough to flag it.

Install free on Chrome