feat: Browser integrations (#1355)

Author: kamilogorek

packages/browser/karma.config.js

@@ -18,6 +18,7 @@ module.exports = function(config) {
       tsconfig: 'tsconfig.json',
       bundlerOptions: {
         sourceMap: true,
+        transforms: [require('karma-typescript-es6-transform')()],
       },
       include: ['test/**/*.ts'],
       reports: {

packages/browser/package.json

@@ -28,6 +28,7 @@
     "karma-mocha-reporter": "^2.2.5",
     "karma-rollup-preprocessor": "^6.0.0",
     "karma-typescript": "^3.0.12",
+    "karma-typescript-es6-transform": "^1.0.4",
     "npm-run-all": "^4.1.2",
     "prettier": "^1.12.1",
     "prettier-check": "^2.0.0",

packages/browser/src/backend.ts

@@ -63,7 +63,7 @@ export interface BrowserOptions extends Options {
 /** The Sentry Browser SDK Backend. */
 export class BrowserBackend implements Backend {
   /** Creates a new browser backend instance. */
-  public constructor(private readonly options: BrowserOptions) {}
+  public constructor(private readonly options: BrowserOptions = {}) {}
 
   /**
    * @inheritDoc
@@ -79,7 +79,13 @@ export class BrowserBackend implements Backend {
       );
     }
 
-    Raven.config(dsn, this.options).install();
+    Raven.config(dsn, this.options);
+
+    // We need to leave it here for now, as we are skipping `install` call,
+    // due to integrations migration
+    // TODO: Remove it once we fully migrate our code
+    Raven._isRavenInstalled = true;
+    Error.stackTraceLimit = Raven._globalOptions.stackTraceLimit;
 
     // Hook into Raven's breadcrumb mechanism. This allows us to intercept both
     // breadcrumbs created internally by Raven and pass them to the Client

packages/browser/src/integrations/breadcrumbs.ts

@@ -0,0 +1,16 @@
+import { Integration } from '@sentry/types';
+import { Raven } from '../raven';
+
+/** Default Breadcrumbs instrumentations */
+export class Breadcrumbs implements Integration {
+  /**
+   * @inheritDoc
+   */
+  public name: string = 'Breadcrumbs';
+  /**
+   * @inheritDoc
+   */
+  public install(): void {
+    Raven._instrumentBreadcrumbs();
+  }
+}

packages/browser/src/integrations/functiontostring.ts

@@ -0,0 +1,16 @@
+import { Integration } from '@sentry/types';
+import { Raven } from '../raven';
+
+/** Patch toString calls to return proper name for wrapped functions */
+export class FunctionToString implements Integration {
+  /**
+   * @inheritDoc
+   */
+  public name: string = 'FunctionToString';
+  /**
+   * @inheritDoc
+   */
+  public install(): void {
+    Raven._patchFunctionToString();
+  }
+}

packages/browser/src/integrations/index.ts

@@ -0,0 +1,5 @@
+export { OnUnhandledRejection } from './onunhandledrejection';
+export { OnError } from './onerror';
+export { FunctionToString } from './functiontostring';
+export { TryCatch } from './trycatch';
+export { Breadcrumbs } from './breadcrumbs';

packages/browser/src/integrations/onerror.ts

@@ -0,0 +1,24 @@
+import { Integration } from '@sentry/types';
+import { Raven } from '../raven';
+// @ts-ignore
+import { TraceKit } from './tracekit';
+
+/** Global OnError handler */
+export class OnError implements Integration {
+  /**
+   * @inheritDoc
+   */
+  public name: string = 'OnError';
+  /**
+   * @inheritDoc
+   */
+  public handler(...args: any[]): void {
+    Raven._handleOnErrorStackInfo.call(Raven, ...args);
+  }
+  /**
+   * @inheritDoc
+   */
+  public install(): void {
+    TraceKit.report.subscribe(this.handler.bind(this));
+  }
+}

packages/browser/src/integrations/onunhandledrejection.ts

@@ -0,0 +1,32 @@
+import { captureException } from '@sentry/shim';
+import { Integration } from '@sentry/types';
+
+/** onunhandledrejection is not standardized, thus not available on Window type */
+interface PromisifiedWindow extends Window {
+  onunhandledrejection?(event: PromiseRejectionEvent): void;
+}
+
+/** TODO: Change to safe window access, window||global||self||{} */
+const _window: PromisifiedWindow = window;
+
+/** Global Promise Rejection handler */
+export class OnUnhandledRejection implements Integration {
+  /**
+   * @inheritDoc
+   */
+  public name: string = 'OnUnhandledRejection';
+  /**
+   * @inheritDoc
+   */
+  public handler(event: PromiseRejectionEvent): void {
+    captureException(event.reason);
+  }
+  /**
+   * @inheritDoc
+   */
+  public install(): void {
+    _window.addEventListener('unhandledrejection', this.handler.bind(
+      this,
+    ) as EventListener);
+  }
+}