Release Notes for MariaDB Connector/Node.js 3.1.2


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 3.1.2 was released on 2023-05-03. This release is of General Availability (GA) maturity.

Connector/Node.js 3.2 is the successor to Connector/Node.js 3.1 and is fully compatible with Connector/Node.js 3.1. Users of Connector/Node.js 3.1 should shift to Connector/Node.js 3.2.

Notable Changes

  • Connector/Node.js improves compatibility with TypeORM. (CONJS-249)

    • In previous releases, Connector/Node.js does not export the connection.listeners() function, which is required by TypeORM.

    • Starting with this release, Connector/Node.js exports the connection.listeners() function, so TypeORM can be used.

Issues Fixed

  • When the namedPlaceholders connection parameter is enabled and a question mark (?) is used as a placeholder instead of a named parameter, an unclear error message is raised. (CONJS-247)

    • In previous releases, the following error message is raised in this scenario:

      Parameter named undefined is not set
    • Starting with this release, the following error message is raised in this scenario:

      Command expect PARAMETER_EXPECTED_COUNT parameters, but found only PARAMETER_ACTUAL_COUNT named parameters. You probably use question mark in place of named parameters
  • When a new connection is created in a connection pool at the same time that the pool is being closed with pool.end(), errors can be raised due to a race condition. (CONJS-248)

    • In previous releases, the following error message can be raised in this scenario:

      ReferenceError: You are trying to `import` a file after the Jest environment has been torn down. From FILE_NAME.


MariaDB Connector/Node.js 3.1 is fully compatible with MariaDB Connector/Node.js 3.3. As a new fully compatible major version, MariaDB Connector/Node.js 3.3 supersedes MariaDB Connector/Node.js 3.1, and users should upgrade to 3.3.