@sentry/browser
Sentry-Javascript
- Official Sentry SDKs for JavaScript
- 示例代码
相关示例
denyUrls
allowUrls
ignoreError message
ignoreError type
regularException
captureException
captureMessage
duplicated exception
duplicated message
integration
event hints
breadcrumb hints
官方示例
快速运行示例
# sentry-javascript 项目 yarn yarn build cd packages/browser/examples/ python -m SimpleHTTPServer # Mac 自带的,也可以用你自己喜欢的 http server # Serving HTTP on 0.0.0.0 port 8000 ...
访问:http://localhost:8000/
示例配置详解
Sentry.init({ // Client's DSN. dsn: 'https://363a337c11a64611be4845ad6e24f3ac@sentry.io/297378', // An array of strings or regexps that'll be used to ignore specific errors based on their type/message ignoreErrors: [/PickleRick_\d\d/, 'RangeError'], // An array of strings or regexps that'll be used to ignore specific errors based on their origin url denyUrls: ['external-lib.js'], // An array of strings or regexps that'll be used to allow specific errors based on their origin url allowUrls: ['http://localhost:5000', 'https://browser.sentry-cdn'], // Debug mode with valuable initialization/lifecycle informations. debug: true, // Whether SDK should be enabled or not. enabled: true, // Custom integrations callback integrations(integrations) { return [new HappyIntegration(), ...integrations]; }, // A release identifier. release: '1537345109360', // An environment identifier. environment: 'staging', // Custom event transport that will be used to send things to Sentry transport: HappyTransport, // Method called for every captured event async beforeSend(event, hint) { // Because beforeSend and beforeBreadcrumb are async, user can fetch some data // return a promise, or whatever he wants // Our CustomError defined in errors.js has `someMethodAttachedToOurCustomError` // which can mimick something like a network request to grab more detailed error info or something. // hint is original exception that was triggered, so we check for our CustomError name if (hint.originalException.name === 'CustomError') { const serverData = await hint.originalException.someMethodAttachedToOurCustomError(); event.extra = { ...event.extra, serverData, }; } console.log(event); return event; }, // Method called for every captured breadcrumb beforeBreadcrumb(breadcrumb, hint) { // We ignore our own logger and rest of the buttons just for presentation purposes if (breadcrumb.message.startsWith('Sentry Logger')) return null; if (breadcrumb.category !== 'ui.click' || hint.event.target.id !== 'breadcrumb-hint') return null; // If we have a `ui.click` type of breadcrumb, eg. clicking on a button we defined in index.html // We will extract a `data-label` attribute from it and use it as a part of the message if (breadcrumb.category === 'ui.click') { const label = hint.event.target.dataset.label; if (label) { breadcrumb.message = `User clicked on a button with label "${label}"`; } } console.log(breadcrumb); return breadcrumb; }, });
dsn
:客户端的DSNignoreErrors
:字符串或正则表达式数组,用于根据其type/message
忽略特定错误denyUrls
:字符串或正则表达式数组,将用于根据origin url
忽略特定错误allowUrls
:字符串或正则表达式数组,将用于允许基于其origin url
的特定错误debug
:使用有价值的初始化(initialization
)/生命周期(lifecycle
)信息的调试模式enabled
:是否应该启用SDK
integrations
:自定义集成回调release
:发布版本标识符environment
:发布环境标识符transport
:自定义事件传输,将用于将事物发送到Sentry
beforeSend
:针对每个捕获的事件调用的方法beforeBreadcrumb
:针对每个捕获的面包屑调用的方法