InboundFilters

允许您根据异常的类型、消息或 URL 忽略特定错误。(默认启用)

Import name: Sentry.inboundFiltersIntegration

此集成默认启用。如果您想修改默认集成,请阅读此文档

此集成允许您根据异常的类型、消息或 URL 忽略特定错误。

默认情况下,它会忽略以 Script errorJavascript error: Script error 开头的错误。

要配置此集成,请直接使用 ignoreErrorsignoreTransactionsdenyUrlsallowUrls SDK 选项。例如:

Copied
Sentry.init({
  ignoreErrors: ["ignore-this-error"],
});

请记住,这些选项应传递给根 Sentry.init 调用,而不是集成!

Type: (string|RegExp)[]

一个字符串或正则表达式模式的列表,用于匹配不应发送到 Sentry 的错误消息。匹配这些字符串或正则表达式的消息在发送到 Sentry 之前将被过滤掉。使用字符串时,部分匹配也会被过滤掉,因此如果需要精确匹配,请使用正则表达式。默认情况下,所有错误都会发送。

Type: (string|RegExp)[]

一个字符串或正则表达式模式的列表,用于匹配不应发送到 Sentry 的事务名称。匹配这些字符串或正则表达式的事务在发送到 Sentry 之前将被过滤掉。使用字符串时,部分匹配也会被过滤掉,因此如果需要精确匹配,请使用正则表达式。默认情况下,典型的 API 健康检查请求所涉及的事务会被过滤掉。

Type: (string|RegExp)[]

一个字符串或正则表达式模式的数组,用于匹配创建错误的脚本的 URL。 只有在这些 URL 上创建的错误才会发送到 Sentry。 如果您使用此选项,只有当顶级堆栈帧文件 URL 包含或匹配 allowUrls 数组中的至少一个条目时,错误才会被发送到 Sentry。 数组中的所有字符串条目将通过 stackFrameUrl.contains(entry) 进行匹配,而所有正则表达式条目将通过 stackFrameUrl.match(entry) 进行匹配。

例如,如果您将 'foo.com' 添加到数组中,那么在 https://bar.com/myfile/foo.com 上创建的错误将被捕获,因为 URL 会通过“包含”逻辑进行匹配,并且 URL 的最后一段包含 foo.com

这种匹配逻辑适用于捕获的异常,而不适用于原始消息事件。默认情况下,所有错误都会发送。

如果您的脚本是从 cdn.example.com 加载的,而您的网站是 example.com,您可以将 allowUrls 设置为以下内容,以仅捕获在这些位置的脚本中创建的错误:

Copied
Sentry.init({
  allowUrls: [/https?:\/\/((cdn|www)\.)?example\.com/],
});

Type: (string|RegExp)[]

一个字符串或正则表达式模式的数组,用于匹配创建错误的脚本的 URL。 在这些 URL 上创建的错误不会发送到 Sentry。 如果您使用此选项,当顶级堆栈帧文件 URL 包含或匹配 denyUrls 数组中的至少一个条目时,错误将不会被发送到 Sentry。 数组中的所有字符串条目将通过 stackFrameUrl.contains(entry) 进行匹配,而所有正则表达式条目将通过 stackFrameUrl.match(entry) 进行匹配。

这种匹配逻辑适用于捕获的异常,而不适用于原始消息事件。默认情况下,所有错误都会发送。