Connector/Node.js 2.1.0 Release Notes

The most recent release of MariaDB Connector/Node.js is:

Connector/Node.js 3.5.1 Download Now

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

Release date: 12 Jul 2019

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

For an overview of MariaDB Connector/Node.js see the About MariaDB Connector/Node.js page

Notable Changes

• [CONJS-19] Implement Ed25519 plugin

• [CONJS-57] Multiple alternative authentication methods for the same user (MariaDB 10.4)

• [CONJS-61] Permit handling expired password

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

• [CONJS-87] Array parameter automatic conversion

• [CONJS-89] Performance improvement on decoding string

• [CONJS-88] Charset collation option separation

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

• [CONJS-75] Missing import dependencies for typeScript

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

• [CONJS-83] Add poolCluster 'remove' event

• [CONJS-84] Option restoreNodeTimeout is not respected when removeNodeErrorCount is set

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

New Options

Option	Description	Type	Default
collation	(used in replacement of charset) Permit to define the collation used for connection. This will define the charset encoding used for exchanges with the database and define the order used when comparing strings. It's mainly used for micro-optimizations	string	UTF8MB4_UNICODE_CI
permitConnectionWhenExpired	Permit a user with an expired password to connect. Only possible operation in this case will be to change the password ('SET PASSWORD=PASSWORD('XXX')')	boolean	false

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

Pool events

Pools now emit events.

event	Description
acquire	This event indicates that a connection has been acquired from pool.
connection	This event is emitted when a new connection is added to the pool. Has a connection object parameter
enqueue	This event is emitted when a command cannot be satisfied immediately by the pool and is queued.
release	This event is emitted when a connection is released back into the pool. Has a connection object parameter

Example:

pool.on('connection', (conn) => console.log(`connection ${conn.threadId} has been created in pool`);
Pool

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