Node.js agent release notes
Release date: June 17, 2025
Language versions currently supported: 16, 18, 20, and 22 LTS
Important
Contrast will discontinue support for Node.js 16 (LTS) in October 2025. Customers should upgrade to the latest Node.js LTS version, which is currently version 22.16.0 (LTS).
New and improved:
Send up
memory_metrics
to Contrast in theserver_inventory
payload. (NODE-3819)
Release date: June 16, 2025
Language versions currently supported: 16, 18, 20, and 22 LTS
Important
Contrast will discontinue support for Node.js 16 (LTS) in October 2025. Customers should upgrade to the latest Node.js LTS version, which is currently version 22.16.0 (LTS).
New and improved:
Support all Assess-Prod sampling settings. (NODE-3769)
Investigate updating
@swc/core
to improved minification options. (NODE-3785)Collect the maximum memory limit for a Node.js app in a container or virtual server and process. (NODE-3797)
Log the agent reporting instance GUID and AppId GUID on startup at the INFO log level. (NODE-3798)
Release date: May 22, 2025
Language versions currently supported: 16, 18, 20, and 22 LTS
Important
Contrast will discontinue support for Node.js 16 (LTS) in October 2025. Customers should upgrade to the latest Node.js LTS version, which is currently version 22.16.0 (LTS).
New and improved:
Deadzone
@opentelemetry
packages. (NODE-3740)Revise
effective_config
output to match new standard and other agents. (NODE-3782)Update
Contrast-UI
reporter proxy for better compatibility with firewalls. (NODE-3790)
Bug fixes:
Security bypass semantic rule is not reporting stacktrace or exploit metadata correctly. (NODE-3771)
Fastify instrumentation errors when using
@fastify/websocket
. (NODE-3794)
Release date: May 12, 2025
Language versions currently supported: 16, 18, 20, and 22 LTS
Important
Contrast will discontinue support for Node.js 16 (LTS) in October 2025. Customers should upgrade to the latest Node.js LTS version, which is currently version 22.16.0 (LTS).
Bug fixes:
String replace bug with
regex
and$n
special patterns. (NODE-3788)
Release date: May 7, 2025
Language versions currently supported: 16, 18, 20, and 22 LTS
Important
Contrast will discontinue support for Node.js 16 (LTS) in October 2025. Customers should upgrade to the latest Node.js LTS version, which is currently version 22.16.0 (LTS).
New and improved:
Support Assess sampling
event_detail config
option. (NODE-3752)Update workspaces to use empty immutable objects from
@contrast/common
. (NODE-3754)Update rewriter to lessen the size of generated code artifacts. (NODE-3767)
Refactor nested propagators out of url
propagatorsBug
. (NODE-3770)
Bug fixes:
Masked attack vectors should be masked in HTTP request details. (NODE-3774)
Assess Fastify preValidation handler does not call done callback if source context
missingTask
. (NODE-3787)
Release date: April 17, 2025
Language versions currently supported: 16, 18, 20, and 22 LTS
New and improved:
Added support for the Fastify 5 framework. (NODE-3622)
Release date: April 14, 2025
Language versions currently supported: 16, 18, 20, and 22 LTS
New and improved:
Refactored
string.prototype.replace
to lock instrumentation when it calls through toregexp.exec
. (NODE-3766)Assess in production environments now changes the
assess.stacktraces
configuration toSINK
. (NODE-3768)
Release date: April 4, 2025
Language versions currently supported: 16, 18, 20, and 22 LTS
New and improved:
Implemented the option to instrument all modes for ADR. (NODE-3736)
Completed implementation of HTTP spans. (NODE-3744)
Refactored the
String.prototype.split
propagator so that it doesn't force propagation in order to calculate tag ranges. (NODE-3749)
Release date: April 1, 2025
Language versions currently supported: 16, 18, 20, and 22 LTS
New and improved:
Updated
agent
andagentify
to ensure the agent is using Inversion of Control (IoC). (NODE-3757)
Bug fixes:
The agent now handles undefined args in
util.format
. (NODE-3759)
Release date: March 13, 2025
Language versions currently supported: 16, 18, 20, and 22 LTS
New and improved:
Configure agent operator to provide a writable cache directory. (NODE-3728)
Added certificate configuration options. (NODE-3738)
Refactor event factory methods with performance improvements. (NODE-3753)
Bug fixes:
Fix unnecessary propagation that can occur in
String.prototype.concat
. (NODE-3746)Do not check for propagation context in
send
andfastify-send
propagators. (NODE-3747)
Release date: March 4, 2025
Language versions currently supported: 16, 18, 20, and 22 LTS
New and improved:
Programmatic deadzones for winston logging module. (NODE-3437)
Programmatic deadzones for pino logging module. (NODE-3438)
Make Protect response-blocker a class. (NODE-3604)
Protect path-traversal should not report for static file-serving libs. (NODE-3717)
Remediate perf bug - do not flag GUIDs as suspicious (bumped
agent-lib
to version 9.1.0). (NODE-3739)
Bug fixes:
Assess source instrumentation for hapi can break onRequest hooks. (NODE-3745)
Release date: February 21, 2025
Language versions currently supported: 16, 18, 20, and 22 LTS
New and improved:
Research latency performance issue experienced by a customer, fix or create tickets to fix causes. Our test case improved by 50%. (NODE-3731)
Bug fixes:
get-source-context
not checking the propagation count correctly. (NODE-3734)
Release date: February 19, 2025
Language versions currently supported: 16, 18, 20, and 22 LTS
Bug fixes:
Some telemetry still enabled when opted out. (NODE-3732)
New
@swc/core
check does not properly handle nested dependencies. (NODE-3733)
Release date: February 6, 2025
Language versions currently supported: 16, 18, 20, and 22 LTS
Bug fixes:
Check for empty strings when determining configuration defaults. (NODE-3725)
Release date: January 31, 2025
Language versions currently supported: 16, 18, 20, and 22 LTS
New and improved:
Provide a clear error message when the install environment is different from the execution environment. (NODE-3381)
Allow rewrite hooks when either
rewrite.enable
orrewrite.cache.enable
are true. (NODE-3720)New
agent-lib@9.0.0
fixes a Protect CMD injection false positive. (NODE-3721)
Release date: January 24, 2025
Language versions currently supported: 16, 18, 20, and 22 LTS
Note
This release now provides GraphQL support for Apollo, Yoga, and graph-ql HTTP libraries.
New and improved:
Instrument
graphql-http
as a source. (NODE-3394)GraphQL Detailed Route Reporting and Coverage. (NODE-3409)
Update licenses to 2025. (NODE-3714)
Release date: January 17, 2025
Language versions currently supported: 16, 18, 20, and 22 LTS
New and improved:
CLI rewriter should skip
rewrite-deadzoned
package files. (NODE-3434)Improve logging to
stderr
when installation fails with TS error. (NODE-3677)Augment Perf feature to watch event processing. (NODE-3684)
Bug fixes:
dep-hooks
return value not used when target lib is imported. (NODE-3561)Clear traces endpoint's
hashSet
periodically so vulns can properly update last seen. (NODE-3709)
Release date: January 9, 2025
Language versions currently supported: 16, 18, 20, and 22 LTS
New and improved:
NEW: Build ID / Artifact Hash generation and reporting to Contrast. (NODE-3314)
NEW: Support for Express 5 Framework has been added. (NODE-3623)
NEW: Preview Release of the Contrast Node agent's GraphQL support.
Investigate automating and reporting sessions and build ID generation. (NODE-3315)
Research and implement the new
node --run
command incompatible withcmd_ignore_list
. (NODE-3540)Refactor route coverage to support Express 5. (NODE-3650)
Add remainder of architecture component integration tests. (NODE-3666)
Instrument GraphQL for route coverage. (NODE-3671)
Replace pino transport with multi-stream. (NODE-3678)
Bug fixes:
Fixed memory issue in reporter. (NODE-3705)
Release date: April 16, 2024
Language versions currently supported: 14, 16, 18, and 20 LTS
Important
Contrast Protect is deprecated as of release 5.20.6.
New and improved:
Updated v4 and v5 pipelines for K8s agent-operator.
Deprecated
@contrast/protect-agent
.Added v4 section to README.
Bug fixes:
UI reporter v1 routes do not respect proxy configuration. (NODE-3338)
Update test bench Dockerfiles. (NODE-3350)