JavaScript

On this page, we get you up and running with Sentry's SDK, so that it will automatically report errors and exceptions in your application.

Using a framework? Take a look at our specific guides to get started.

Install

Sentry captures data by using an SDK within your application’s runtime:

Copied
# Using yarn
yarn add @sentry/browser @sentry/tracing
# Using npm
npm install --save @sentry/browser @sentry/tracing

Configure

Configure Sentry as early as possible in your app. Once this is done, the Sentry SDK captures all unhandled exceptions.

This snippet:

  • Uses process.env.npm_package_version to configure the version of your application. Learn more about releases and how they are used with source maps.
  • Instruments your SDK to monitor the performance of browser applications.
Copied
import * as Sentry from "@sentry/browser";
import { Integrations } from "@sentry/tracing";
Sentry.init({
  dsn: "https://examplePublicKey@o0.ingest.sentry.io/0",
  release: "my-project-name@" + process.env.npm_package_version, // To set your release version
  integrations: [new Integrations.BrowserTracing()],
  tracesSampleRate: 1.0, // We recommend adjusting this in production
});

Verify

This snippet includes an intentional error, so you can test that everything is working as soon as you set it up:

Copied
myUndefinedFunction();

To view and resolve the recorded error, log into sentry.io and open your project. Clicking on the error's title will open a page where you can see detailed information and mark it as resolved.

You can edit this page on GitHub.