@sentry/browser
Version:
Official Sentry SDK for browsers
291 lines (263 loc) • 8.7 kB
JavaScript
Object.defineProperty(exports, '__esModule', { value: true });
var core = require('@sentry/core');
var utils = require('@sentry/utils');
var client = require('./client.js');
var flags = require('./flags.js');
var helpers = require('./helpers.js');
require('./integrations/index.js');
var stackParsers = require('./stack-parsers.js');
require('./transports/index.js');
var trycatch = require('./integrations/trycatch.js');
var breadcrumbs = require('./integrations/breadcrumbs.js');
var globalhandlers = require('./integrations/globalhandlers.js');
var linkederrors = require('./integrations/linkederrors.js');
var dedupe = require('./integrations/dedupe.js');
var httpcontext = require('./integrations/httpcontext.js');
var fetch = require('./transports/fetch.js');
var xhr = require('./transports/xhr.js');
var defaultIntegrations = [
new core.Integrations.InboundFilters(),
new core.Integrations.FunctionToString(),
new trycatch.TryCatch(),
new breadcrumbs.Breadcrumbs(),
new globalhandlers.GlobalHandlers(),
new linkederrors.LinkedErrors(),
new dedupe.Dedupe(),
new httpcontext.HttpContext(),
];
/**
* The Sentry Browser SDK Client.
*
* To use this SDK, call the {@link init} function as early as possible when
* loading the web page. To set context information or send manual events, use
* the provided methods.
*
* @example
*
* ```
*
* import { init } from '@sentry/browser';
*
* init({
* dsn: '__DSN__',
* // ...
* });
* ```
*
* @example
* ```
*
* import { configureScope } from '@sentry/browser';
* configureScope((scope: Scope) => {
* scope.setExtra({ battery: 0.7 });
* scope.setTag({ user_mode: 'admin' });
* scope.setUser({ id: '4711' });
* });
* ```
*
* @example
* ```
*
* import { addBreadcrumb } from '@sentry/browser';
* addBreadcrumb({
* message: 'My Breadcrumb',
* // ...
* });
* ```
*
* @example
*
* ```
*
* import * as Sentry from '@sentry/browser';
* Sentry.captureMessage('Hello, world!');
* Sentry.captureException(new Error('Good bye'));
* Sentry.captureEvent({
* message: 'Manual',
* stacktrace: [
* // ...
* ],
* });
* ```
*
* @see {@link BrowserOptions} for documentation on configuration options.
*/
function init(options = {}) {
if (options.defaultIntegrations === undefined) {
options.defaultIntegrations = defaultIntegrations;
}
if (options.release === undefined) {
var window = utils.getGlobalObject();
// This supports the variable that sentry-webpack-plugin injects
if (window.SENTRY_RELEASE && window.SENTRY_RELEASE.id) {
options.release = window.SENTRY_RELEASE.id;
}
}
if (options.autoSessionTracking === undefined) {
options.autoSessionTracking = true;
}
if (options.sendClientReports === undefined) {
options.sendClientReports = true;
}
var clientOptions = {
...options,
stackParser: utils.stackParserFromStackParserOptions(options.stackParser || stackParsers.defaultStackParser),
integrations: core.getIntegrationsToSetup(options),
transport: options.transport || (utils.supportsFetch() ? fetch.makeFetchTransport : xhr.makeXHRTransport),
};
core.initAndBind(client.BrowserClient, clientOptions);
if (options.autoSessionTracking) {
startSessionTracking();
}
}
/**
* Present the user with a report dialog.
*
* @param options Everything is optional, we try to fetch all info need from the global scope.
*/
function showReportDialog(options = {}, hub = core.getCurrentHub()) {
// doesn't work without a document (React Native)
var global = utils.getGlobalObject();
if (!global.document) {
flags.IS_DEBUG_BUILD && utils.logger.error('Global document not defined in showReportDialog call');
return;
}
const { client, scope } = hub.getStackTop();
var dsn = options.dsn || (client && client.getDsn());
if (!dsn) {
flags.IS_DEBUG_BUILD && utils.logger.error('DSN not configured for showReportDialog call');
return;
}
if (scope) {
options.user = {
...scope.getUser(),
...options.user,
};
}
if (!options.eventId) {
options.eventId = hub.lastEventId();
}
var script = global.document.createElement('script');
script.async = true;
script.src = core.getReportDialogEndpoint(dsn, options);
if (options.onLoad) {
script.onload = options.onLoad;
}
var injectionPoint = global.document.head || global.document.body;
if (injectionPoint) {
injectionPoint.appendChild(script);
} else {
flags.IS_DEBUG_BUILD && utils.logger.error('Not injecting report dialog. No injection point found in HTML');
}
}
/**
* This is the getter for lastEventId.
*
* @returns The last event id of a captured event.
*/
function lastEventId() {
return core.getCurrentHub().lastEventId();
}
/**
* This function is here to be API compatible with the loader.
* @hidden
*/
function forceLoad() {
// Noop
}
/**
* This function is here to be API compatible with the loader.
* @hidden
*/
function onLoad(callback) {
callback();
}
/**
* Call `flush()` on the current client, if there is one. See {@link Client.flush}.
*
* @param timeout Maximum time in ms the client should wait to flush its event queue. Omitting this parameter will cause
* the client to wait until all events are sent before resolving the promise.
* @returns A promise which resolves to `true` if the queue successfully drains before the timeout, or `false` if it
* doesn't (or if there's no client defined).
*/
function flush(timeout) {
var client = core.getCurrentHub().getClient();
if (client) {
return client.flush(timeout);
}
flags.IS_DEBUG_BUILD && utils.logger.warn('Cannot flush events. No client defined.');
return utils.resolvedSyncPromise(false);
}
/**
* Call `close()` on the current client, if there is one. See {@link Client.close}.
*
* @param timeout Maximum time in ms the client should wait to flush its event queue before shutting down. Omitting this
* parameter will cause the client to wait until all events are sent before disabling itself.
* @returns A promise which resolves to `true` if the queue successfully drains before the timeout, or `false` if it
* doesn't (or if there's no client defined).
*/
function close(timeout) {
var client = core.getCurrentHub().getClient();
if (client) {
return client.close(timeout);
}
flags.IS_DEBUG_BUILD && utils.logger.warn('Cannot flush events and disable SDK. No client defined.');
return utils.resolvedSyncPromise(false);
}
/**
* Wrap code within a try/catch block so the SDK is able to capture errors.
*
* @param fn A function to wrap.
*
* @returns The result of wrapped function call.
*/
function wrap(fn) {
return helpers.wrap(fn)();
}
function startSessionOnHub(hub) {
hub.startSession({ ignoreDuration: true });
hub.captureSession();
}
/**
* Enable automatic Session Tracking for the initial page load.
*/
function startSessionTracking() {
var window = utils.getGlobalObject();
var document = window.document;
if (typeof document === 'undefined') {
flags.IS_DEBUG_BUILD && utils.logger.warn('Session tracking in non-browser environment with @sentry/browser is not supported.');
return;
}
var hub = core.getCurrentHub();
// The only way for this to be false is for there to be a version mismatch between @sentry/browser (>= 6.0.0) and
// @sentry/hub (< 5.27.0). In the simple case, there won't ever be such a mismatch, because the two packages are
// pinned at the same version in package.json, but there are edge cases where it's possible. See
// https://github.com/getsentry/sentry-javascript/issues/3207 and
// https://github.com/getsentry/sentry-javascript/issues/3234 and
// https://github.com/getsentry/sentry-javascript/issues/3278.
if (!hub.captureSession) {
return;
}
// The session duration for browser sessions does not track a meaningful
// concept that can be used as a metric.
// Automatically captured sessions are akin to page views, and thus we
// discard their duration.
startSessionOnHub(hub);
// We want to create a session for every navigation as well
utils.addInstrumentationHandler('history', ({ from, to }) => {
// Don't create an additional session for the initial route or if the location did not change
if (!(from === undefined || from === to)) {
startSessionOnHub(core.getCurrentHub());
}
});
}
exports.close = close;
exports.defaultIntegrations = defaultIntegrations;
exports.flush = flush;
exports.forceLoad = forceLoad;
exports.init = init;
exports.lastEventId = lastEventId;
exports.onLoad = onLoad;
exports.showReportDialog = showReportDialog;
exports.wrap = wrap;
//# sourceMappingURL=sdk.js.map