Skip to main content

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 the server_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 to regexp.exec. (NODE-3766)

  • Assess in production environments now changes the assess.stacktraces configuration to SINK. (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 and agentify 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 and fastify-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 or rewrite.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 with cmd_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)

See also

Node.js agent release note archive