Lazy Loading Sentry

The Loader is a small wrapper around our SDK, which does a few things:

  • Always has the newest recommended stable version of our SDK
  • Captures all global errors and unhandled promise rejections
  • Lazy injects our SDK into your website
  • After you’ve loaded the SDK, the Loader will send everything to Sentry

The loader is less than 1kB gzipped and includes the Sentry.init call with your DSN.


Additional Configuration

In case you want to set additional options, you have to set them like this:

onLoad is a function that only the Loader provides; Loader will call it once it injects the SDK into the website. The Loader init() works a bit differently as well; instead of just setting the options, we merge the options internally, only for convenience, so you don’t have to set the DSN again because the Loader already contains it.

As explained, the Loader lazy loads and injects our SDK into your website, but you can also tell the loader to fetch it immediately instead of only fetching it when you need it. Setting data-lazy to no will tell the Loader to inject the SDK as soon as possible:

  Sentry.onLoad(function() {
    // Use whatever Sentry.* function you want

SDK Version

Go into the Sentry web UI, view Settings -> Projects -> Client Keys (DSN), then press the Configure button. From here, you can view the options to configure your DSN and select which SDK version the Loader should load.

JavaScript Loader Settings

Current limitations

Because we inject our SDK asynchronously, we will only monitor global errors and unhandled promise for you until the SDK is fully loaded. That means that we might miss breadcrumbs during the download.

For example, a user clicking on a button on your website is making an XHR request. We will not miss any errors, only breadcrumbs and only up until the SDK is fully loaded. You can reduce this time by manually calling forceLoad or set data-lazy="no".

If you want to understand the inner workings of the loader itself, you can read the documented source code in all its glory over at the sentry-javascript repository.

You can edit this page on GitHub.