Release Notes for MariaDB Connector/Node.js 2.5.0


MariaDB Connector/Node.js is the interface between Node.js applications and MariaDB Server. MariaDB Connector/Node.js enables development of Node.js applications.

MariaDB Connector/Node.js 2.5.0 was released on 2020-10-19. This release is of General Availability (GA) maturity.

Notable Changes

New Connection Options

MariaDB Connector/Node.js 2.5.0 introduces the following new connection options:




Allows client to request public key from the Server.


Sets parentheses to indicate arrays in SQL queries. Permits compatibility with older releases.


Path to Server caching RSA public keys. Requires Node.js 11.6 or later.


Socket keep alive time. (CONJS-148)


Path to Server RSA public key. Requires Node.js 11.6 or later.


Enables JavaScript ES20202 BigInt for BIGINTBIGINT data type. (CONJS-13)

New Authentication Plugin Support

  • Support added for MySQL caching_sha256_password authentication. (CONJS-77)

  • Support added for MySQL sha256_password authentication. (CONJS-76)

Can Result in Unexpected Behavior

  • Changed query format to accept parentheses with IN clause. Use allowParenthesis to revert to previous format. (CONJS-143)

Issues Fixed

  • Batch rewrite errors when packet reach maxAllowedPacket (CONJS-145)

  • Using callback API, batch, avoid return error if connection not established. (CONJS-146)

  • TypeScript type ssl using wrong definitions. (CONJS-144)