danieliu / sentry-javascript

Official Sentry SDKs for JavaScript. We're hiring https://boards.greenhouse.io/sentry

Bad software is everywhere, and we're tired of it. Sentry is on a mission to help developers write better software faster, so we can get back to enjoying technology. If you want to join us Check out our open positions

Official Sentry SDKs for JavaScript

This is the next line of Sentry JavaScript SDKs, comprised in the @sentry/ namespace. It will provide a more convenient interface and improved consistency between various JavaScript environments.

---

Sentry is Hiring!!!

Would you like to work on Open Source software and help maintain this repository? Apply today: https://boards.greenhouse.io/sentry.

---

Links

• 
• 
• 
• 
• 

Contents

• Contributing
• Supported Platforms
• Installation and Usage
• Other Packages

Supported Platforms

For each major JavaScript platform, there is a specific high-level SDK that provides all the tools you need in a single package. Please refer to the README and instructions of those SDKs for more detailed information:

• @sentry/browser: SDK for Browsers
• @sentry/node: SDK for Node including integrations for Express
• @sentry/angular: Browser SDK with Angular integration enabled
• @sentry/ember: Browser SDK with Ember integration enabled
• @sentry/react: Browser SDK with React integration enabled
• @sentry/svelte: Browser SDK with Svelte integration enabled
• @sentry/vue: Browser SDK with Vue integration enabled
• @sentry/gatsby: SDK for Gatsby
• @sentry/nextjs: SDK for Next.js
• @sentry/remix: SDK for Remix
• @sentry/integrations: Pluggable integrations that can be used to enhance JS SDKs
• @sentry/serverless: SDK for Serverless Platforms (AWS, GCP)
• @sentry/electron: SDK for Electron with support for native crashes
• @sentry/react-native: SDK for React Native with support for native crashes
• @sentry/capacitor: SDK for Capacitor Apps and Ionic with support for native crashes

Installation and Usage

To install a SDK, simply add the high-level package, for example:

npm install --save @sentry/browser
yarn add @sentry/browser

Setup and usage of these SDKs always follows the same principle.

import { init, captureMessage } from '@sentry/browser';

init({
  dsn: '__DSN__',
  // ...
});

captureMessage('Hello, world!');

Other Packages

Besides the high-level SDKs, this repository contains shared packages, helpers and configuration used for SDK development. If you're thinking about contributing to or creating a JavaScript-based SDK, have a look at the resources below:

• @sentry/tracing: Provides integrations and extensions for Performance Monitoring / Tracing.
• @sentry/replay: Provides the integration for Session Replay.
• @sentry/core: The base for all JavaScript SDKs with interfaces, type definitions and base classes.
• @sentry/utils: A set of helpers and utility functions useful for various SDKs.
• @sentry/types: Types used in all packages.