Connector/Node.js 3.5.1 Release Notes

Connector/Node.js 3.5.1 is a Stable (GA) release of MariaDB Connector/Node.js, released on 2026-02-18

Download Release Notes Changelog Connector/Node.js Overview

Release date: 18 Feb 2026

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

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

Notable changes

Add asyncDispose support for ConnectionPromise - CONJS-338

ConnectionPromise now implements Symbol.asyncDispose, enabling connections to be used with the await using syntax introduced in ECMAScript 2024 and TypeScript 5.2:

await using conn = await mariadb.createConnection(config);
// conn.end() is called automatically at end of block

This provides deterministic connection cleanup without requiring an explicit try/finally block.

Add generic type parameter for query values in TypeScript definitions - CONJS-339

The query and execute method signatures now accept a generic type parameter for the values array, improving type safety and IDE auto-completion when passing typed parameter arrays:

const rows = await conn.query<ResultType, [number, string]>(
   'SELECT * FROM t WHERE id = ? AND name = ?',
   [1, 'alice']
);

Support charset + collation combination in connection options - CONJS-341

Connection options now support specifying both charset and collation simultaneously. Previously, providing both could lead to ambiguous or ignored configuration. This change ensures the connector correctly applies the requested character set and collation when establishing a session, which is useful when the desired collation is not the default for the given character set.

const conn = await mariadb.createConnection({
   charset: 'utf8mb4',
   collation: 'uca1400_ai_ci'
   //... 
});

Bugs Fixed

• CONJS-331 Handle 0x01 prefix in multi-exchange authentication plugins

• CONJS-332 Permit having No-conf SSL using caching_sha2_password

• CONJS-335 Deno properly closing socket

• CONJS-336 Connection attribute _server_host sends host, but IP resulting of name resolution

• CONJS-337 Missing pingTimeout TypeScript definition

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