4.0.0

This is the release of our new SDKs, @sentry/browser, @sentry/node. While there are too many changes to list for this release, we will keep a consistent changelog for upcoming new releases. raven-js (our legacy JavaScript/Browser SDK) and raven (our legacy Node.js SDK) will still reside in this repo, but they will receive their own changelog.

We generally guide people to use our new SDKs from this point onward. The migration should be straightforward if you were only using the basic features of our previous SDKs.

raven-js and raven will both still receive bugfixes but all the new features implemented will only work in the new SDKs. The new SDKs are completely written in TypeScript, which means all
functions, classes and properties are typed.

Links

• Official SDK Docs
• TypeDoc

Migration

Here are some examples of how the new SDKs work. Please note that the API for all JavaScript SDKs is the same.

Installation

Old:

Raven.config('___PUBLIC_DSN___', {
  release: '1.3.0',
}).install();

New:

Sentry.init({
  dsn: '___PUBLIC_DSN___',
  release: '1.3.0',
});

Set a global tag

Old:

Raven.setTagsContext({ key: 'value' });

New:

Sentry.configureScope(scope => {
  scope.setTag('key', 'value');
});

Capture custom exception

Old:

try {
  throwingFunction();
} catch (e) {
  Raven.captureException(e, { extra: { debug: false } });
}

New:

try {
  throwingFunction();
} catch (e) {
  Sentry.withScope(scope => {
    scope.setExtra('debug', false);
    Sentry.captureException(e);
  });
}

Capture a message

Old:

Raven.captureMessage('test', 'info', { extra: { debug: false } });

New:

Sentry.withScope(scope => {
  scope.setExtra('debug', false);
  Sentry.captureMessage('test', 'info');
});

Breadcrumbs

Old:

Raven.captureBreadcrumb({
  message: 'Item added to shopping cart',
  category: 'action',
  data: {
    isbn: '978-1617290541',
    cartSize: '3',
  },
});

New:

Sentry.addBreadcrumb({
  message: 'Item added to shopping cart',
  category: 'action',
  data: {
    isbn: '978-1617290541',
    cartSize: '3',
  },
});

raven-node@2.6.4

• fix: Updated uuid module (#1481)

raven-js@3.27.0

• CHANGE: Remove keepalive: true as a default fetch option (reference: getsentry/sentry-docs#310)
• FIX: Use objectMerge util instead of Object.assign for IE10/11
• FIX: Updated setUserContext type definition
• FIX: Updated sanitizeKeys type definition
• FIX: Update license template to use correct license url

raven-js@3.26.4

• FEAT: Add options to customize showReportDialog language

raven-node@2.6.3

• fix: Always pass request through parseRequest for raven-node (#1404)

raven-js@3.26.3

• FIX: Attempt to provide some information for <unlabeled event> (#1397)

3.26.2

FIX: Fallback to handler name in mechanism (#1359)
FIX: check for undefined stacks in isSameStacktrace (#1339)

raven-js - 3.26.1

• FIX: Bower build

3.26.0

• REF: Return location.origin instead of assigning it for IE10
• FEAT: Send exception mechanisms

3.25.2

• REF: Emit transaction instead of culprit (#1330)