JavaScript
Sentry's SDKs enable automatic reporting of errors and exceptions.
On this page, we get you up and running with Sentry's SDK, so that it will automatically report errors and exceptions in your application.
If you don't already have an account and Sentry project established, head over to sentry.io, then return to this page.
Install
Sentry captures data by using an SDK within your application’s runtime.
# 使用 yarn
yarn add @sentry/browser @sentry/tracing
# 使用 npm
npm install --save @sentry/browser @sentry/tracing
我们还支持其它的安装方法
Configure
Configuration should happen as early as possible in your application's lifecycle.
Once this is done, Sentry's JavaScript SDK captures all unhandled exceptions and transactions.
import * as Sentry from "@sentry/browser";
import { Integrations } from "@sentry/tracing";
Sentry.init({
dsn: "https://examplePublicKey@o0.ingest.sentry.io/0",
// To set your release version
release: "my-project-name@" + process.env.npm_package_version,
integrations: [new Integrations.BrowserTracing()],
// Set tracesSampleRate to 1.0 to capture 100%
// of transactions for performance monitoring.
// We recommend adjusting this value in production
tracesSampleRate: 1.0,
});
Verify
This snippet includes an intentional error, so you can test that everything is working as soon as you set it up:
myUndefinedFunction();
Or, by manually generating an event:
在 JavaScript 中,您可以将错误对象传递给 captureException()
,以将其捕获为事件。可以将字符串作为错误抛出,在这种情况下无法记录回溯。
try {
aFunctionThatMightFail();
} catch (err) {
Sentry.captureException(err);
}
Learn more about manually capturing an error or message, in our Usage documentation.
To view and resolve the recorded error, log into sentry.io and open your project. Clicking on the error's title will open a page where you can see detailed information and mark it as resolved.
- Package:
- npm:@sentry/browser
- Version:
- 6.0.2
- Repository:
- https://github.com/getsentry/sentry-javascript