This is a read-only copy of the MariaDB Knowledgebase generated on 2024-12-18. For the latest, interactive version please visit https://mariadb.com/kb/.

About MariaDB Connector/Node.js

MariaDB Connector/Node.js is used to connect applications developed on Node.js to MariaDB and MySQL databases. The library is LGPL licensed.

 Date  Release  Status  Min. Node.js Compat.  Release Notes  Changelog 
24 Oct 20243.4.0Stable (GA)Node 10+Release NotesChangelog
18 Sep 20243.3.2Stable (GA)Node 10+Release NotesChangelog
5 Jun 20243.3.1Stable (GA)Node 10+Release NotesChangelog
21 Mar 20243.3.0Stable (GA)Node 10+Release NotesChangelog

see all Connector/Node.js releases

About MariaDB Connector/Node.js

MariaDB Connector/Node.js is a native Javascript driver.

Obtaining the Driver

The required files can be downloaded from: https://mariadb.com/downloads/connector

The source code is available on GitHub: https://github.com/MariaDB/mariadb-connector-nodejs

MariaDB Connector/Node.js on npm, the package manager for JavaScript: https://www.npmjs.com/package/mariadb

Installing the Driver

The driver can be installed using npm:

npm install mariadb

Choosing a Version

Driver versions are compatible with all MariaDB servers and MySQL 5.x (>= 5.5.3). Tested with MariaDB server versions 5.5, 10.0, 10.1, 10.2, 10.3 and 10.4 with Node.js 6 to 12 (see travis results for unix or appveyor results on windows).

Requirements

MariaDB Connector/Node.js requires Node.js 6 or above, since it is based on Promise.

License

GNU Lesser General Public License as published by the Free Software Foundation; either version 2.1 of the License, or (at your option) any later version.

Using the Driver

The MariaDB Connector can use different APIs on the back-end: Promise and Callback API. The default API is Promise. The callback API is provided for compatibility with the mysql and mysql2 APIs.

Content reproduced on this site is the property of its respective owners, and this content is not reviewed in advance by MariaDB. The views, information and opinions expressed by this content do not necessarily represent those of MariaDB or any other party.