Skip to content

3.0.0 - Breadcrumbs, hooks, filtering, and expanded engine support

Latest
Latest

Choose a tag to compare

View all tags
@TheRealAgentK TheRealAgentK released this 21 Jul 06:32
3.0.0
60ead93
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

Raygun4CFML 3.0.0 is now available on ForgeBox.

box install raygun4cfml@3.0.0

3.0.0 (July 21, 2026)

New Features:

  • Breadcrumbs: Record a trail of events leading up to an error via recordBreadcrumb() and clearBreadcrumbs(). Breadcrumbs are automatically included in subsequent send()/sendAsync() calls with timestamp, level, type, category, message, className, methodName, lineNumber, and customData fields (#46).
  • onBeforeSend hook: Register a callback via constructor or setOnBeforeSend() to inspect, mutate, or cancel payloads before sending. Return false to cancel, return a modified struct to mutate, or throw to proceed with the original payload.
  • Ignore exceptions list: Skip specific exception types via ignoreExceptions constructor argument or setIgnoreExceptions(). Case-insensitive matching (e.g. ["MissingInclude", "AbortException"]).
  • Wildcard content filter keys: RaygunContentFilter now supports glob-style * wildcards in filter patterns (e.g. "pass*" matches password, passphrase, passCode). Exact-match filters continue to work as before.
  • Payload size enforcement: Payloads exceeding 128KB are automatically reduced by progressively stripping expendable fields (rawData, userCustomData, CGI data, headers, form). Form field values are truncated to 256 characters.
  • Configurable API endpoint: Set a custom Raygun API endpoint via RaygunSettings.apiEndpoint (default: https://api.raygun.com/entries).
  • HTTP timeout: All API requests now have a configurable timeout via RaygunSettings.httpTimeout (default: 10 seconds).
  • Automatic retry: Failed HTTP requests are retried with configurable RaygunSettings.maxRetries (default: 2) and RaygunSettings.retryDelay (default: 1 second). Set maxRetries=0 to disable.
  • Additional environment fields: processorCount, locale, and utcOffset are now captured in every error report.
  • Sample API key configuration: Samples now load the Raygun API key automatically from samples/.env.json (gitignored) or the RAYGUN_API_KEY environment variable — no more manual copy-paste into each file.

Bug Fixes:

  • Fixed settings not propagating to RaygunRequestMessage and RaygunResponseMessage
  • Fixed empty stackTrace when Java stack trace is empty but CFML tag context is available
  • Fixed case-sensitive exception type checks (e.g. "database" vs "Database")
  • Fixed unsafe CGI scope access in RaygunRequestMessage and RaygunMessageDetails
  • Fixed sync/async HTTP error handling inconsistency in RaygunClient
  • Fixed thread name typo in async sending
  • Fixed typed property defaults (default="" on non-string typed properties)
  • Added isNull() guards on getSettings()/getContentFilter() to prevent NPE on strict engines
  • Fixed RaygunContentFilter initialization on Adobe ColdFusion 2025 Update 11, where the engine's built-in setFilter() function collided with the generated property setter

Code Quality:

  • Centralized all magic strings and constants in RaygunConfig (API endpoint, log file name, content types, HTTP methods, size limits, timeout/retry defaults)
  • Replaced isClosure() with isCustomFunction() for cross-engine compatibility
  • 174 test specs (up from 70), covering all components
  • Expanded the test matrix to 20 engines, including Lucee 8 Alpha and matching Lucee Light configurations for every supported Lucee line

Full Changelog: 2.1.0...3.0.0

Assets 2
Loading