NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
npm, #1093 most downloaded on npm
gRPC Library for Node - pure JS implementation
Latest stable
1.14.7
Last release 24 days ago
29 Oct 2026
Release timing varies
gaps range from 9 days to 5 months
Nearly every release is documented
notes for 60 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
9 years old
202 releases · first in 2018
Drag across the ruler to compare, or tap a release to open it.
Fix a bug causing automatic retries to continue after a call is cancelled ( #3102 contributed by @phyous )
Address remaining instances of advisory GHSA-f596-whhp-79r4
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Fix a bug that caused clients to automatically transmit excessive error details to clients by default ( advisory GHSA-f596-whhp-79r4 )
getAuthContext to return unverified certificates as though they were verified in some configurations (advisory GHSA-m9gg-hp2v-232j)Fix a bug that could cause servers to crash when handling malformed requests ( advisory GHSA-5375-pq7m-f5r2 )
Send halfClose immediately after messages to prevent late halfClose issues with Envoy ( #3031 contributed by @serkanerip )
Fix server keep alive timeout not properly destroying connections ( #3022 contributed by @mattias-wiberg )
safe_regex string matchers to match overly permissively in some cases (advisory GHSA-r7hq-q2xm-6c5m)Fix a bug in RBAC that caused exact path matchers in case insensitive mode to behave as a prefix matcher ( advisory GHSA-88h9-xgvx-hvf2 )
Add getAuthContext method to client and server call classes (more details can be found in gRFC L35)
getAuthContext method to client and server call classes (more details can be found in gRFC L35) (#2920)getConnectionInfo method to the ServerInterceptingCall class (#2922)weighted_round_robin load balancing policy (#2998)round_robin LB policy (#2979)Added:
CHANNEL_ARGS_CONFIG_SELECTOR_KEYStatusOr<T>CallStreamstatusOrFromValuestatusOrFromErrorModified:
ResolverListener#onSuccessfulResolution now has the signature (endpointList: StatusOr<Endpoint[]>, attributes: { [key: string]: unknown }, serviceConfig: StatusOr<ServiceConfig> | null, resolutionNote: string): booleanLoadBalancer#updateAddressList now has the signature `updateAddressList(endpointList: StatusOr<Endpoint[]>,lbConfig: TypedLoadBalancingConfig, channelOptions: ChannelOptions, resolutionNote: string): booleanweighted_round_robin to LB policy registry (#3001) (currently experimental, enabled by the environment variable GRPC_EXPERIMENTAL_XDS_WRR_LB)wrr_locality to LB policy registry (#3003)Address remaining instances of advisory GHSA-f596-whhp-79r4
Fix a bug that caused clients to automatically transmit excessive error details to clients by default ( advisory GHSA-f596-whhp-79r4 )
Fix a bug that could cause servers to crash when handling malformed requests ( advisory GHSA-5375-pq7m-f5r2 )
Fix ability to set SNI with ssl_target_name_override option
ssl_target_name_override option (#2956)Avoid calling http2.getDefaultSettings
http2.getDefaultSettings (#2937)Fix a bug that causes safe_regex string matchers to match overly permissively in some cases ( advisory GHSA-r7hq-q2xm-6c5m )
safe_regex string matchers to match overly permissively in some cases (advisory GHSA-r7hq-q2xm-6c5m)Fix a bug in RBAC that caused exact path matchers in case insensitive mode to behave as a prefix matcher ( advisory GHSA-88h9-xgvx-hvf2 )
node-pre-gyp (#3026 contributed by @robcresswell)rejectUnauthorized channel credentials option to be handled incorrectly (#2926)retryThrottling config was set (#2927)Add support for channel option grpc-node.flow_control_window to control HTTP/2 flow control window size (#2864 contributed by @rickihastings)
grpc-node.flow_control_window to control HTTP/2 flow control window size (#2864 contributed by @rickihastings)no_proxyenvironment variable (#2876 contributed by @melkouri)sendMetadata methods to not be called if the server interceptor did not explicitly send metadata (#2897)Added:
SecureConnectorSecureConnectResultSUBCHANNEL_ARGS_EXCLUDE_KEY_PREFIXServer#experimentalRegisterListenerToChannelz protected methodServerexperimentalUnregisterListenerFromChannelz protected methodServer#experimentalCreateConnectionInjectorWithChannelzRef protected methodModified:
LoadBalancer: Removed the ChannelCredentials constructor argumentLoadBalancer: Removed the ChannelOptions constructor argumentLoadBalancer#updateAddressList: Replaced the attributes argument with one of type ChannelOptions.ChannelControlHelper#createSubchannel: Removed the ChannelCredentials argumentLeafLoadBalancer: Removed the ChannelCredentials constructor argumentring_hash load balancing policy (#2904)Fix a bug that could cause servers to crash when handling malformed requests ( advisory GHSA-5375-pq7m-f5r2 )
Allow garbage collection of IDLE channels
Prioritize HTTP status errors over message decoding errors
Prioritize reporting UNAVAILABLE status when handing connection drops
Core changes:
Report UNAVAILABLE if possible when handling connection drops
Node changes:
fix LrsCallState statsTimer memory leak (#2891 contributed by @gfrancz) (backported in #2898)
util.promisify instead of fs/promises for Node 12 compatibility (#2838)Fix a bug that could cause the client to not receive some resource updates
Node changes:
Core changes:
Provide the method_name for the CallCredentials callback generateMetadata (#2814 contributed by @becoded)
rejectUnauthorized field to the VerifyOptions interface, which can be passed as an argument to credentials.createSsl and createFromSecureContext (#2812 contributed by @vinothsa4891)Added:
CaCertificateUpdateCaCertificateUpdateListenerIdentityCertificateUpdateIdentityCertificateUpdateListenerCertificateProviderFileWatcherCertificateProviderFileWatcherCertificateProviderConfigcreateCertificateProviderChannelCredentialscreateCertificateProviderServerCredentialsModified:
LoadBalancer: The constructor now takes an additional argument of type ChannelCredentials.ChannelControlHelper#createSubchannel: Now takes an additional argument of type ChannelCredentials | null. This should be passed along if overriding this function.LeafLoadBalancer: The constructor now takes an additional argument of type ChannelCredentials.Fix a bug that could cause servers to crash when handling malformed requests ( advisory GHSA-5375-pq7m-f5r2 )
Ensure the client queries the name resolver again after connections drop while using the round_robin load balancing policy
Fix client crash on receiving a custom error code (#2801 contributed by @hastom)
Revert a change that used APIs that were not available in early minor versions of Node 14 (#2799 contributed by @xqin)
Add Server connection injection API as described in gRFC L114
getHost method to server call objects (#2783, #2793)Added:
splitHostPortHostPortcreateServerCredentialsWithInterceptorsFix a bug that could cause servers to crash when handling malformed requests ( advisory GHSA-5375-pq7m-f5r2 )
Fix a bug that caused clients to reconnect unnecessarily while no requests are pending.
Various improvements to handling of keepalive timers (#2760 by @davidfiala)
grpc.max_send_message_length channel option (#2779)Avoid buffering significantly more than grpc.max_receive_message_size per received message.
grpc.max_receive_message_size per received message.Fix a bug that caused channels with unix: targets to not reconnect after the channel goes idle
unix: targets to not reconnect after the channel goes idle (#2750)Improve reporting of HTTP error codes
@grpc/proto-loader to the latest version (#2732)Fix a bug that could cause a server to sometimes send the status early
Resolve exception when Error.stackTraceLimit is undefined (#2701 contributed by @davidfiala)
Error.stackTraceLimit is undefined (#2701 contributed by @davidfiala)checkServerIdentity when grpc.ssl_target_name_override is set (#2704)Fix a bug that caused server interceptors to crash when using partially-populated ResponderBuilder and ListenerBuilder objects
ResponderBuilder and ListenerBuilder objects (#2696)Revert client reconnection changes in #2680
Implement server connection idle timeouts and improve channelz performance (#2677 contributed by @AVVS)
Update dependency on @grpc/proto-loader to the latest version
@grpc/proto-loader to the latest version (#2732)round_robin LB policy to fail to reconnect after a connection drops (#2667)Deprecate Server#start (#2597) (details in gRFC L107)
Server#start (#2597) (details in gRFC L107)Server#unbind (#2612) (details in gRFC L109)Server#drain (#2616) (details in gRFC L111)VerifyOptions (#2637 contributed by @chakhsu)EndpointendpointToStringendpointHasAddressLeafLoadBalancerHealthListenerSubchannelInterface#isHealthySubchannelInterface#addHealthStateWatcherSubchannelInterface#removeHealthStateWatcherSubchannelWrapper#setHealthyselectLbConfigFromListparseLoadBalancingConfigOutlierDetectionRawConfigEndpointMapexperimental namespace:
ServiceConfigMethodConfigLoadBalancingConfig (now a simple raw object type)RetryPolicygetFirstUsableConfigvalidateLoadBalancingConfigOutlierDetectionLoadBalancingConfigLoadBalancer#updateAddressList: The first argument now has type Endpoint[] instead of SubchannelAddress[]ResolverListener#onSuccessfulResolution: The first argument now has type Endpoint[] instead of SubchannelAddress[]registerLoadBalancerType: The second argument, a LoadBalancerConstructor now takes a second argument options: ChannelOptionsConfigSelector: Now accepts an additional argument channelId: numberQueuePicker: The constructor now accepts an additional optional argument childPicker: Picker, which the QueuePicker instance will delegate to if provided.GRPC_XDS_EXPERIMENTAL_ENABLE_RING_HASH=false.pick_first: sticky TRANSIENT_FAILURE and address order randomization (Currently experimental, enabled by environment variable GRPC_EXPERIMENTAL_PICKFIRST_LB_CONFIG) (#2572)Fix a bug that could cause servers to crash when handling malformed requests ( advisory GHSA-5375-pq7m-f5r2 )
Avoid buffering significantly more than grpc.max_receive_message_size per received message.
grpc.max_receive_message_size per received message.Fix a bug that could rarely cause connection leaks
waitForReady (#2643)Fix a bug that could cause the Node process to close early when establishing a connection while a request is pending
Fix a bug that could cause connectivity state information to become stale in some circumstances
Fix a busy loop when recovering from a failure to establish a connection to a unix domain socket address target
Provide the correct port to the proxy when connecting to a target without an explicitly specified port (#2608 contributed by @segevfiner)
Fix a busy loop when recovering from a failure to establish a connection to a fixed IP address target
Fix a memory leak caused by creating and closing multiple clients
Fix a bug that could cause a client to not update name resolution after multiple failed connection attempts
Include more information in most "No connection established" errors
index tracer, and add more information to other trace logs (#2599)Fix a type inconsistency in server-call.ts (#2589 contributed by @rsnullptr)
server-call.ts (#2589 contributed by @rsnullptr)Fix a bug that could cause a client to sometimes incorrectly hold the process open when no longer in use
Make a few improvements to DNS resolving timing
Experimental changes:
grpc.experimental.BackoffTimeout#getEndTimeFix proto file inconsistencies in published package
Fix behavior when channel goes IDLE
Implement channel idle timeout and the channel option grpc.client_idle_timeout_ms
grpc.client_idle_timeout_ms (#2471)pick_first: sticky TRANSIENT_FAILURE and address order randomization (#2511)Http2ServerCallStream handling (#2501 contributed by @CedricKassen)grpc-node.tls_enable_trace to enable Node TLS tracing (#2507)Experimental changes:
grpc.experimental.createResolverAvoid buffering significantly more than grpc.max_receive_message_size per received message.
grpc.max_receive_message_size per received message.One column per quarter.