Download Release Notes Changelog

Release date: 3 Jul 2025

For the highlights of this release, see the release notes.

The revision number links will take you to the revision's page on GitHub. On GitHub you can view more details of the revision and view diffs of the code modified in that revision.

• Revision #831fd11 bump 3.4.4

• [] TypeScript types/share.d.ts and types/callback.d.ts are not published

Download | Release Notes | Changelog |

Release date: 19 Dec 2023

For the highlights of this release, see the release notes.

The revision number links will take you to the revision's page on GitHub. On GitHub you can view more details of the revision and view diffs of the code modified in that revision.

• Revision #d0d55dc Merge branch 'develop'

• Revision #8e20d41 [misc] add missing change log

• [] Add support for connection redirection

• Bump 3.2.3

• [misc] makes one CI test with server ssl disabled

• [misc] using common default servers test suite

• [misc] test stability improvement

• [misc] precise LGPL-2.1-or-later, not just LGPL-2.1

• [] Error doesn't always have parameters according to option logParam

• [] permit disabling BULK insert for one batch

• [misc] help freeing memory in case of timeout

• [misc] test correction

• [misc] remove EOL servers

• [misc] remove EOL servers

• [misc] documentation correction of insert id when multi insert #261

• [] Bulk insert error when last bunch of parameters is reaching max_allowed_packet #258

• [misc] JSON test correction

• [misc] JSON test correction

• [] wrong binary decoding of 00:00:00 TIME values #262

• [misc] timeout test correction

• [misc] JSON test correction

• Merge branch 'develop'

• [misc] ensure test stability depending on server supporting extended capabilities or not

• [misc] remove skysql testing

• [misc] test stability correction : debug size taking care of having 'set names utf8mb4' additional command

• [misc] test stability correction : connection attributes + maxscale sending session tracking info on handshake response makes handshake bigger

• [misc] test stability correction

• [misc] restrict capabilities to server capabilities

• Merge tag '3.2.2' into develop

Release date: 2 Jul 2025

For the highlights of this release, see the .

The revision number links will take you to the revision's page on GitHub. On you can view more details of the revision and view diffs of the code modified in that revision.

• [misc] update CHANGELOG

| | |

Release date: 2 Apr 2025

For the highlights of this release, see the .

The revision number links will take you to the revision's page on GitHub. On you can view more details of the revision and view diffs of the code modified in that revision.

• bump 3.4.1 version

• [misc] pool throwing first error of connection/reconnection loop, to avoid having minimal timeout of last try

Download | Release Notes | Changelog |

Release date: 30 Jun 2021

For the highlights of this release, see the release notes.

The revision number links will take you to the revision's page on GitHub. On GitHub you can view more details of the revision and view diffs of the code modified in that revision.

• Revision #66f82b1 [misc] exact number implementation compatibility correction

• Revision #f65e0ea [misc] travis mariadb enterprise test

• Merge branch 'develop' into maintenance/3.x

• [misc] documentation change

• [misc] typecast new methods tiny/short/datetime

• [] Custom logging implementation

• [] Restrict authentication plugin list by option

• Merge branch 'feature/' into maintenance/3.x

• [] binary protocol support

| | |

Release date: 16 Oct 2023

For the highlights of this release, see the .

The revision number links will take you to the revision's page on GitHub. On you can view more details of the revision and view diffs of the code modified in that revision.

• - [misc] restrict capabilities to server capabilities

• - Merge tag '3.2.2' into develop

| | |

Release date: 3 May 2023

For the highlights of this release, see the .

The revision number links will take you to the revision's page on GitHub. On you can view more details of the revision and view diffs of the code modified in that revision.

• - Merge tag '3.1.2' into develop

• - Merge branch 'release/3.1.2'

Download | Release Notes | Changelog |

Release date: 17 Mar 2023

For the highlights of this release, see the release notes.

The revision number links will take you to the revision's page on GitHub. On GitHub you can view more details of the revision and view diffs of the code modified in that revision.

• Revision #8dcad1a Merge tag '3.1.1' into develop

• Revision #c00e0f1 Merge branch 'release/3.1.1'

• Bump 3.1.1 version

• [] pool not listening to 'error' event might exit application on error #180

• [] batch not talking in account metaAsArray option when not using bulk

• [] batch failing when using bulk and metaAsArray #235

• [] correction for node.js 12 compatibility

• [] test correction

• [] following up correction, emptying prepare statement cache on pool connection reset

• Merge branch 'master' into develop

• Fix eslint warnings

• Fix test-execute.js

• [misc] xpand 6.1 testing

• Merge tag '3.1.0' into develop

Download | Release Notes | Changelog |

Release date: 25 Apr 2025

For the highlights of this release, see the release notes.

The revision number links will take you to the revision's page on GitHub. On GitHub you can view more details of the revision and view diffs of the code modified in that revision.

• Revision #d8fc60a only run benchmark on the master branch to speed up tests

• Revision #bb093c6 bump 3.4.2 version

• [] enable the permitRedirect option by default only when SSL is enabled

• [misc] micro optimization

• [misc] text decoder small improvement

• [misc] column parsing improvements

• [misc] Revised the buffer reading methods to increment this.pos once per function call when possible

• [misc] Replaces repetitive query[i]

• [] Repeated named placeholders causes "Placeholder is not defined" #311

| | |

Release date: 18 Sep 2024

For the highlights of this release, see the .

The revision number links will take you to the revision's page on GitHub. On you can view more details of the revision and view diffs of the code modified in that revision.

• [misc] adding missing changelog issue

• bump version to 3.3.2

Download | Release Notes | Changelog |

Release date: 24 Oct 2024

For the highlights of this release, see the release notes.

The revision number links will take you to the revision's page on GitHub. On GitHub you can view more details of the revision and view diffs of the code modified in that revision.

• Revision #d089e89 - bump 3.4.0 version

• Revision #31e3913 - [CONJS-295] add mysql2 option jsonStrings option to return MySQL Json field as string

• - [] Add option enableKeepAlive / keepAliveInitialDelay alias for keepAliveDelay

• - Merge branch 'develop' of into develop

• - Merge branch 'parsec' into develop

• - Merge branch 'master' into develop

• - Merge pull request #295

• - Update tests for ephemeral certificates in MaxScale

• - [misc] adding gclib for node 20

• - [misc] improve test stability

• - Merge branch 'master' into develop

• - [] DMLs are not returning any output when streaming #293

• - [] Parsec authentication implementation

Download | Release Notes | Changelog |

Release date: 20 Oct 2021

For the highlights of this release, see the release notes.

The revision number links will take you to the revision's page on GitHub. On GitHub you can view more details of the revision and view diffs of the code modified in that revision.

• Revision #d78ba3b [CONJS-180] compatibility: support mysql2 stream option #173

• Merge branch 'features/' into maintenance/3.x

• [] Update code to recent node.js version

• [] Update code to recent node.js version

• [] Update code to recent node.js version

• [misc] benchmark output result correction

• [] better pool option resetAfterUse default value

• [] Update code to recent node.js version

• [] Update code to recent node.js version

• [misc] code style length change to 120

• [misc] Error code simplification + pool timeout handler simplification

• [misc] promise documentation improvement

• [] test correction for mysql

• [] document retrieving stored procedure's output parameters #90

• [] Missing leakDetectionTimeout option in Typescript description #169

• [misc] correct changelog

• [misc] test reliability improvement

• [] Pool.query/execute/batch(undefined) never release connection

• [] Change Pool cluster default option removeNodeErrorCount value to Infinity

• [misc] documentation link correction

• [misc] Normalize all the line endings

• [] permit using batch with returning clause

• Merge branch 'develop' into maintenance/3.x

• [misc] travis correction

• [misc] ensuring PR test suite runs correctly

• [misc] ensuring PR test suite runs correctly

• [] permitting providing null as a value without an array

• [] permitting providing null as a value without an array

• bump 3.0.1-rc version

• [misc] benchmark commenting graph command

• [misc] benchmark improvement and update to recent version of mysql compatible drivers

• [misc] collation default setting improvement

• [misc] benchmark addition: query using pool

• [] performance improvement. * using mutable Packet object to avoid creating a new Object for each packet. * set column data on creation, to avoid resolving data type parsing for each data. * BIGINT parsing improvement, avoiding parsing data as text * ensure using execute command option * using undefined in place of 'utf8' to parse String when using node.js, avoiding name resolution

• [misc] ensure testing on PR runs standard test

• [misc] documentation addition for non supported experimental ?? syntax

• [] correct stream backpressure

• [misc] ensure test reliability on windows

• [misc] permit prettier fixing

• [misc] ensure test reliability

• Merge branch 'develop'

• [misc] ensure test reliability

• [misc] ensure test reliability with maxscale/skysql ha

• Merge branch 'master' into develop

• [misc] ensure PR travis test

• [misc] ensure PR travis test

• Merge tag '2.5.4' into develop

• Merge branch 'release/2.5.4'

• [misc] travis test on node.js v16

Download | Release Notes | Changelog |

Release date: 1 Mar 2022

For the highlights of this release, see the release notes.

The revision number links will take you to the revision's page on GitHub. On GitHub you can view more details of the revision and view diffs of the code modified in that revision.

• Revision #42e503f bump 2.5.6

• Revision #f0cd822 misc - test reliability improvement

• misc - test reliability improvement

• Merge branch 'develop' into maintenance/3.x

• misc - test reliability improvement

• misc - 2.5.6 correction merge

• Merge branch 'develop' into maintenance/3.x

• misc - update documentation with for-await-of use #189

• misc - update maxscale test load local infile

• misc - update maxscale test for 6.2.0

• misc - update maxscale test for 6.2.0 add PAM test for maxscale (using dedicated port)

• - consider BIT(1) as boolean option bitOneIsBoolean permit to disable that behavior for compatibility

• misc - pool ensuring multi-request process order

• misc - stored procedure tests async

• misc - documentation improvement indicating that connection.release() is async

• misc - set parser function once per result-set

• misc - correct character_set_client unexpect error parsing OK_Packet #177

• misc - ensure test reliability

• - change default connection timeout value to 1000ms

• misc - ensuring test stream close

• - fix local infile file name validation for windows #183

• misc - ensuring test stream close

• - fix local infile file name validation for windows #183

• Updating documentation and README examples using mostly async/await

• Merge branch 'develop' into maintenance/3.x

• Merge branch 'typescript_fix_missing_event' into develop

• - fix missing event handler #186

• Updating documentation and README examples using mostly async/await

• adding 10.7 test to travis

• Merge branch 'release/2.5.5'

• Merge tag '2.5.5' into develop

• bump 2.5.5 version

• [] Missing leakDetectionTimeout option in Typescript description #169

• [misc] correct changelog

• [misc] test reliability improvement

• [misc] correct travis link

Download | Release Notes | Changelog |

Release date: 19 Jun 2023

For the highlights of this release, see the release notes.

The revision number links will take you to the revision's page on GitHub. On GitHub you can view more details of the revision and view diffs of the code modified in that revision.

• Revision #bb5f90e - [CONJS-259] adding SqlError sqlMessage property alias for text

• Revision #8ca7958 - Merge tag '3.2.0' into develop

• - Merge branch 'release/3.2.0'

• - bump 3.2.0

• - [] All eventEmitters methods are not available on connections #244

• - [misc] skysql2 test stability correction

• - [misc] style correction

• - [misc] test improvement

• - [misc] test improvement

• - [] ensuring importSql stability when using callback that permits using commands during execution

• - [misc] skipping big sql import for xpand

• - [misc] test correction

• - [] permit to import sql file directly #242

• - [misc] ensure using prettier/lint to all js files

• - [] changeUser can lead to error when using multi-authentication and pipelining

• - [misc] multi-authentication correction after

• - [] correct pipeline use in some case even if pipeline option is not sent

• - [] ensuring option connectTimeout is respected

• - [] test correction for node.js 20 support

• - [misc] correct wrong mysql RSA test

• - [misc] adding node.js 20 to CI

• - [] missing deprecated option supportBigNumbers and bigNumberStrings in Typescript #240

• - [] permit Piping results with Streams when using callback implementation

• - [] permit using undefined as parameter like null

• - [misc] correct UTC timezone for auto timezone setting

• - Merge tag '3.1.2' into develop

Download | Release Notes | Changelog |

Release date: 5 Jun 2024

For the highlights of this release, see the release notes.

The revision number links will take you to the revision's page on GitHub. On GitHub you can view more details of the revision and view diffs of the code modified in that revision.

• Revision #26e1521 [misc] code style correction

• Revision #007bfe0 bump 3.3.1

• [] batch with javascript date parameter not in TIMESTAMP range are saved as null #287

• [misc] avoid useless variables

• [misc] sending text parameter fast path, avoiding testing typeof value each time

• [misc] replace math.floor by ~ when possible for better performance

• [misc] avoid static use

• [misc] JSON parameter correction

• [misc] command function now use JSON parameter

• [] ensure String object parameter

• [misc] avoid unnecessary condition verification

• [misc] ensure possible future multi-catalog use

• [misc] execute performance improvement when lots of parameters And some micro improvement: Object.prototype.toString '[object Date]' for testing Date in place of costly instanceof

• [misc] micro perf change on number to string

• [misc] minor perf change

• [] performance reading column definition packet improvement

• [misc] binary number type faster check

• [misc] test correction for supporting MySQL 8.4

• [misc] ensure redirect empty value

• [misc] add node.js 22 to test suite

• [misc] adding pool toString() function

• [] possible ECONRESET when executing batch #281

• [] connection possibly staying in hanging state after batch execution #281

• [misc] cleaning up test code, removing xpand and skysql code

• [misc] ensure test stability

• [misc] test addition

• [] ensure pool timeout error give details #268

• [misc] avoid double-negative variable use correction

• Merge branch 'master' into develop

• Add missing QueryOptions type to prepare function

• [misc] avoid double-negative variable use

• [misc] fix closing of prepared statements

• [misc] check prepare cache is enabled before resetting it

• [misc] changelog update

| | |

Release date: 21 Mar 2024

For the highlights of this release, see the .

The revision number links will take you to the revision's page on GitHub. On you can view more details of the revision and view diffs of the code modified in that revision.

• - [misc] changelog update

• - Merge branch 'master' into develop

Release date: 25 Jul 2025

For the highlights of this release, see the .

The revision number links will take you to the revision's page on GitHub. On you can view more details of the revision and view diffs of the code modified in that revision.

• bump 3.4.5

Download | Release Notes | Changelog |

Release date: 27 Oct 2022

For the highlights of this release, see the release notes.

The revision number links will take you to the revision's page on GitHub. On GitHub you can view more details of the revision and view diffs of the code modified in that revision.

• Revision #7e8696f [misc] code coverage correction

• Revision #b30f203 Merge branch 'release/3.0.2'

• bump 3.0.2 version

• [] permit streaming prepare statement result

• [] improving prepare cache performance

• Merge branch 'master' into release/3.0.2

• Allow setting idleTimeout to 0

• [] add missing metaAsArray documentation and typescript option

• [misc] ensure test reliability

• Merge branch 'types-checknumberrange' into develop

• [] prepare cache doesn't limit cache size to prepareCacheLength #207

• add checkNumberRange type defs

• [misc] adding parenthesis test

• [misc] adding documentation for connection release #211

• [] Metadata column name gets sporadic corrupted #215

• [misc] merging #214

• Merge branch 'patch-1' into develop

• [misc] adding missing documentation about debugLen and logParam options

• Update connection-options.md

• [misc] remove erroneous benchmark dependencies

• Merge branch 'master' into develop

• [misc] MariaDB benchmark common test suite implementation

• [] ensure Pam authentication when using pam_use_cleartext_plugin and multiple password

• [] merge from 2.x

• Merge branch 'maintenance/2.x' into develop

• [] MySQL caching_sha2_password never succeed using FAST AUTHENTICATION

• [misc] bump dependencies and version 3.0.2

• [misc] adding codecov configuration

• [] remove please-upgrade-node dependency

• [] Executing after prepare close throw a wrong error

• [] add missing pool.closed typescript definition

• [misc] add code coverage

• [misc] add typescript test coverage

• [] return type for batch() is wrong on typescript #194

• [misc] test stability improvement

• Merge branch 'maintenance/2.x' into develop

• [] pool reset test correction for mysql

• [] pool reset initial command result

• [] pool reset initial command result

• [] code style correction

• [] regression causing error "Cannot read properties of null (reading 'leaked')" #206

• [misc] correcting benchmark description

• [misc] improving changelog for 3.0.1 release

• [] update error codes with recent mariadb version

• [] regression causing error "Cannot read properties of null (reading 'leaked')" #206

• [misc] correcting benchmark description

Download | Release Notes | Changelog |

Release date: 14 Sep 2023

For the highlights of this release, see the release notes.

The revision number links will take you to the revision's page on GitHub. On GitHub you can view more details of the revision and view diffs of the code modified in that revision.

• Revision #2b012a6 Merge tag '3.2.1' into develop

• Revision #ab2774b Merge branch 'release/3.2.1'

• bump 3.2.1

• bump dependencies

• Merge branch 'master' into develop

• [misc] code style correction

• [] Option infileStreamFactory addition for compatibility

• [misc] correct travis environment

• [misc] remove useless template literals

• [misc] test stability improvement

• [misc] test stability improvement

• [misc] updating to jammy, permitting to correct docker issues with test suite

• [] permit configuration of console warning message #249

• [misc] maxscale testing improvement

• [misc] update ES test from 23.07 to 23.08

• [misc] update ES test from 23.06 to 23.07

• [misc] adding mariadb server ES23.06 testing

• [misc] adding mariadb server 11.1 testing

• [misc] ensure maxscale test stability

• [misc] temporary disable skysql testing as mandator

• [] ensure respecting server collation when no charset/collation is set

• [misc] ensure ssl test suite for all server version

• [misc] ensure test suite for any max_allowed_packet server

• [misc] benchmark fair comparison between text and binary

• [] Binary result-set parsing performance improvement

• [misc] test correction

• [misc] test addition in order to test namedPlaceholders array parameters

• [] TypeScript missing logParam connection option #247

• [misc] setting copyright header

• [misc] updating supported MariaDB servers in test suite

• [misc] documentation correction for cluster load-balancing parameter

| | |

Release date: 26 Jul 2022

For the highlights of this release, see the .

The revision number links will take you to the revision's page on GitHub. On you can view more details of the revision and view diffs of the code modified in that revision.

• - [misc] improving changelog for 3.0.1 release

• - [misc] updating changelog for 3.0.1 release

| | |

Release date: 15 Feb 2023

For the highlights of this release, see the .

The revision number links will take you to the revision's page on GitHub. On you can view more details of the revision and view diffs of the code modified in that revision.

• Merge branch 'release/3.1.0'

• [misc] changelog update