Download | Release Notes | Changelog |

Release date: 24 Feb 2021

MariaDB Connector/Node.js 2.5.3 is a Stable (GA) release.

Notable Changes

• [CONJS-157] Batch error when setting maxAllowedPacket less than an insert parameter value

• [] use BigInt constructor in place of literal to ensure maximum compatibility

• [] Wrong definition for typescript PoolConnection.release

• [] test 10.6 server latest build

For a complete list of changes made in this release, with links to detailed information on each push, see the .

_{This page is: Copyright © 2025 MariaDB. All rights reserved.}

Download | Release Notes | Changelog |

Release date: 17 Feb 2022

MariaDB Connector/Node.js 2.5.6 is a Stable (GA) release.

Notable Changes

• [CONJS-181] Local infile file validation doesn't take in account escaped value

• [] change default connection timeout value 1 second to permit pools to send correct error

• correct character_set_client unexpect error parsing OK_Packet

For a complete list of changes made in this release, with links to detailed information on each push, see the .

_{This page is: Copyright © 2025 MariaDB. All rights reserved.}

Download | Release Notes | Changelog |

Release date: 26 May 2020

MariaDB Connector/Node.js 2.4.0 is a Stable (GA) release.

This version removes compatibility with Node.js 6, needing 10+ version!

• CONJS-86 - Support extension type format

• - Error when using multipleStatements with metaAsArray

• - Support 10.5 pluggable type

• - checkDuplicate option is indicated in error when having dupplicate

• - performance improvement

• - typescript SqlError interface

For a complete list of changes made in this release, with links to detailed information on each push, see the .

_{This page is: Copyright © 2025 MariaDB. All rights reserved.}

| | |

Release date: 15 Nov 2018

MariaDB Connector/Node.js 2.0.1 is a release.

• (Bug) Commit not executed when in transaction and autocommit is enabled

| | |

Release date: 2 Jul 2020

MariaDB Connector/Node.js 2.4.1 is a (GA) release.

• - pool.getConnection() might not timeout even with acquireTimeout set

| | |

Release date: 17 Oct 2019

MariaDB Connector/Node.js 2.1.2 is a (GA) release.

Implemented enhancements:

• [] Escape functions API

| | |

Release date: 23 Jul 2020

MariaDB Connector/Node.js 2.4.2 is a (GA) release.

• - Number parsing loss of precision

For a complete list of changes made in this release, with links to detailed information on each push, see the .

| | |

Release date: 20 Mar 2020

MariaDB Connector/Node.js 2.3.1 is a (GA) release.

Corrective release of 2.3.0, changing new connection option timeout to queryTimeout to avoid any confusion.

For a complete list of changes made in this release, with links to detailed information on each push, see the .

| | |

Release date: 2 Dec 2019

MariaDB Connector/Node.js 2.1.4 is a (GA) release.

• use pool reset only for corrected COM_RESET_CONNECTION

| | |

Release date: 8 Jan 2020

MariaDB Connector/Node.js 2.1.5 is a (GA) release.

• Batch improvement

| | |

Release date: 14 Jun 2021

MariaDB Connector/Node.js 2.5.4 is a (GA) release.

• [] Authentication plugin failing doesn't always return error

| | |

Release date: 25 Sep 2018

MariaDB Connector/Node.js 2.0.0 is an release.

• : check other connections in pool when an unexpected connection error occur

| | |

Release date: 4 Dec 2020

MariaDB Connector/Node.js 2.5.2 is a (GA) release.

• [] bulk batch error (parameter truncation) #137

| | |

Release date: 31 Jan 2019

MariaDB Connector/Node.js 2.0.3 is a (GA) release.

• [] TypeError: Cannot read property 'totalConnections' of undefined

| | |

Release date: 26 Oct 2020

MariaDB Connector/Node.js 2.5.1 is a (GA) release.

• - Support of the new node.js version v15

For a complete list of changes made in this release, with links to detailed information on each push, see the .

| | |

Release date: 10 May 2019

MariaDB Connector/Node.js 2.0.4 is a (GA) release.

This version is a has been corrected with version, since TypeScript definition wasn't published on npm.

Please use this new 2.0.5 version.

For a complete list of changes made in this release, with links to detailed information on each push, see the .

_{This page is: Copyright © 2025 MariaDB. All rights reserved.}

Download | Release Notes | Changelog |

Release date: 19 Nov 2019

MariaDB Connector/Node.js 2.1.3 is a Stable (GA) release.

Notable Changes

• CONJS-109 Missing mysql only collation definition

• typescript escape/escapeId definition

• Change user callback function not called when no option is set and changing collation only if collation option is correct

• properly escape boolean parameter false

• Typecast provided date function erroneous parsing

• Pam authentication must permit to provide multiple passwords

PAM authentication with multiple steps can be achieved using password as array:

• better cluster error when pool is full

• adding test coverage

_{This page is: Copyright © 2025 MariaDB. All rights reserved.}

Download | Release Notes | Changelog |

Release date: 20 Mar 2020

MariaDB Connector/Node.js 2.3.0 is a Stable (GA) release.

2.3.0 has been deprecated to 2.3.1: changing new connection option timeout to queryTimeout to avoid any confusion.

• - Resultset with same identifier skip data. Now an error will be thrown.

• - permit setting session query timeout per option

• - Force connection.escapeId to emit backtick #101

• - exporting SqlError class to permit instanceOf checks #100

• - fix undefined localTz with timezone: 'Z' issue #92

• - Connection.escapeId must always quote value to permit reserved words

misc:

• appveyor testing server version upgrade

• better debug logging trace format

• correct ssl test

For a complete list of changes made in this release, with links to detailed information on each push, see the .

_{This page is: Copyright © 2025 MariaDB. All rights reserved.}

Download | Release Notes | Changelog | Connector/Node.js Overview

Release date: 13 Dec 2018

MariaDB Connector/Node.js 2.0.2 is a Release Candidate (RC) release.

Notable Updates

New options:

correction

• using option connectAttributes value _server_host is correctly filled on Performance Schema.

• batch improvement

  • error is now thrown when no values

  • BULK better handling when socket fail during command

  • Object with toSqlString function parameter support

  • null value correction when using BULK

• test coverage improvement

• minor performance improvement

• pool end() now correctly wait for all connections ending

For a complete list of changes made in this release, with links to detailed information on each push, see the .

_{This page is: Copyright © 2025 MariaDB. All rights reserved.}

Download | Release Notes | Changelog |

Release date: 06 Sept 2019

MariaDB Connector/Node.js 2.1.1 is a Stable (GA) release.

Notable Changes

• node.js v12 CI testing

• cluster ordered selector bug fix on failover (thanks to @kkx)

• bump dependencies

• documentation update with node.js v12 minimum TLSv1.2 default support

• connection.reset() error message improvement (and documentation)

• small performance improvement when debug not enable

_{This page is: Copyright © 2025 MariaDB. All rights reserved.}

Download | Release Notes | Changelog |

Release date: 20 Oct 2021

MariaDB Connector/Node.js 2.5.5 is a Stable (GA) release.

Notable Changes

• [CONJS-170] Pool.query(undefined) never release connection

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

• [] Missing leakDetectionTimeout option in Typescript description

For a complete list of changes made in this release, with links to detailed information on each push, see the .

_{This page is: Copyright © 2025 MariaDB. All rights reserved.}

Download | Release Notes | Changelog |

Release date: 12 Jul 2019

MariaDB Connector/Node.js 2.1.0 is a Stable (GA) release.

Notable Changes

• [CONJS-19] Implement Ed25519 plugin

• [] Multiple alternative authentication methods for the same user ()

• [] Permit handling expired password

• [] Implement pool events according to mysql/mysql2 API

• [] Array parameter automatic conversion

• [] Performance improvement on decoding string

• [] Charset collation option separation

• [] Types definition must be string, not byte, when using the option typeCast

• [] Missing import dependencies for typeScript

• [] Read errors while processing LOCAL INFILE can cause a process crash

• [] Add poolCluster 'remove' event

• [] Option restoreNodeTimeout is not respected when removeNodeErrorCount is set

• [] Setting the timezone to the current IANA might provoke the server's automatic retrieval

New Options

The option charset now corresponds to charset, still permitting collation for compatibility, but then a warning is thrown to the console.

Pools now emit events.

Example:

_{This page is: Copyright © 2025 MariaDB. All rights reserved.}

Download | Release Notes | Changelog |

Release date: 4 Feb 2019

MariaDB Connector/Node.js 2.2.0 is a Stable (GA) release.

New option force Server version detection

Azure is using a proxy that will return a MySQL handshake not reflecting real server.

A new option forceVersionCheck is added to permit issuing a new SELECT @@Version command on connection creation,

to retrieve the correct server version. Connector will then act according to that server version.

This option is only permitted for MariaDB server >= 10.1.2, and permits to set a timeout to query operation.

Driver internally use SET STATEMENT max_statement_time=<timeout> FOR <command> permitting to cancel operation when timeout is reached,

Implementation of max_statement_time is engine dependent, so there might be some differences: For example, with Galera engine, a commits will ensure replication to other nodes to be done, possibly then exceeded timeout, to ensure proper server state.

example:

• add mysql_native_password to fast-authentication path

• plugin 'mysql_native_password' is used by default if default server plugin is unknown

• unexpected packet type during handshake result will throw a good error.

A new option leakDetection permits to indicate a timeout to log connection borrowed from pool.

When a connection is borrowed from pool and this timeout is reached, a message will be logged to console indicating a possible connection leak.

Another message will tell if the possible logged leak has been released.

A value of 0 (default) meaning Leak detection is disable

Additionally, some error messages have improved:

• Connection timeout now indicate that this correspond to socket failing to establish

• differentiate timeout error when closing pool to standard connection retrieving timeout

• Permit values in SQL object to permits compatibility with mysql/mysql2

• missing import for Error when asking for connection when pool is closed. Thanks to @WayneMDB

• correcting typescript import of @types/node to version >8 thanks to @SimonSchick

For a complete list of changes made in this release, with links to detailed information on each push, see the .

_{This page is: Copyright © 2025 MariaDB. All rights reserved.}

| | |

Release date: 19 Oct 2020

MariaDB Connector/Node.js 2.5.0 is a (GA) release.

• - permit setting socket keep alive (option keepAliveDelay)

| | |

Release date: 13 May 2019

MariaDB Connector/Node.js 2.0.5 is a (GA) release.

• [] permit set numeric parameter bigger than javascript 2^53-1 limitation