About node-oracledb

The node-oracledb driver for Node.js powers high performance Oracle Database applications written in JavaScript or TypeScript.

Node-oracledb is a pure JavaScript module that can connect directly to Oracle Database. Some additional features are available in an optional 'Thick' mode that uses Oracle Client libraries to connect to the database.

Node-oracledb supports basic and advanced features of Oracle Database.

The node-oracledb module is open source and maintained by Oracle Corp. It is stable, well documented, and has a comprehensive test suite.

Getting Started

See Getting Started with Node-oracledb.


See the examples directory. Start with examples/example.js.


See Documentation for the Oracle Database Node.js Add-on and Release Notes.

You can use assistive technology products, such as screen readers, while you work with the documentation. You can also use the keyboard instead of the mouse.


Questions can be asked on GitHub Discussions or Slack (link to join Slack). Identified issues can be raised as GitHub Issues.


To run the test suite see test/README.

Source code

Source code is on github.com/oracle/node-oracledb.


Node-oracledb is an open source project. See CONTRIBUTING for details.

Oracle gratefully acknowledges the contributions to node-oracledb that have been made by the community.

Node-oracledb Features:

We are actively working on supporting the best Oracle Database features, and on functionality requests from users involved in the project.


Copyright (c) 2015, 2024, Oracle and/or its affiliates. All rights reserved.

This software is dual-licensed to you under the Universal Permissive License (UPL) 1.0 as shown at https://oss.oracle.com/licenses/upl and Apache License 2.0 as shown at https://www.apache.org/licenses/LICENSE-2.0. You may choose either license.

If you elect to accept the software under the Apache License, Version 2.0, the following applies:

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.