Freegle / Iznik / 5343

70%

Build Type

push

circleci

Committed by web-flow

Commit Message

fix(sentry): suppress ftUtils.js getPlacementPosition null-document errors (NUXT3-CES) (#229)

Sentry issue NUXT3-CES (6579683231): TypeError "Cannot read properties of
null (reading 'document')" at Object.getPlacementPosition in the Freestar
third-party ad script ftUtils.js. ~13.8k events from 1208 users despite
the existing stack-based suppression added in PR #206 — some events reach
Sentry with a stack that doesn't string-match (e.g. framework-wrapped
exceptions where originalException.stack doesn't carry the ftUtils.js
filename verbatim).

Extends the suppression with a second, more robust filter operating on the
Sentry event's parsed stacktrace frames rather than a string search over
err.stack. Same narrow match criteria as PR #206 / commit 4d99e72d1 for
NUXT3-D2H: a frame whose filename contains '/ftUtils.js' AND whose function
is one of Freestar's known null-property sites (getPlacementPosition or
getInnerDimensions). Won't mask real bugs in our own code — a new bug in
ftUtils.js with a different function name still reports.

We do not control Freestar ad code, so these crashes cannot be fixed from
our side — same justification as prior suppressions.

- composables/useSuppressException.js: new suppressSentryEvent(event)
  helper operating on event.exception.values[].stacktrace.frames[].
- plugins/sentry.client.ts: import and invoke suppressSentryEvent early
  in beforeSend, before the existing hint-based checks.
- tests/unit/composables/useSuppressException.spec.js: 7 new tests
  covering NUXT3-CES getPlacementPosition, NUXT3-D2H getInnerDimensions,
  non-top-frame match, narrow negatives (unknown function in ftUtils.js,
  getPlacementPosition in non-ftUtils file), unrelated events, and
  falsy/empty inputs.

Co-authored-by: Claude Opus 4.7 <noreply@anthropic.com>

Coverage Stats

8880 of 10261 branches covered (86.54%)

Branch coverage included in aggregate %.

31 of 31 new or added lines in 1 file covered. (100.0%)

40 existing lines in 1 file now uncovered.

62393 of 127317 relevant lines covered (49.01%)

9.66 hits per line