oracle

libraryv0.01jsnpmunverified

The `oracle` package provides an obsolete Node.js driver for Oracle databases. It reached version 0.4.1 before being officially abandoned by its maintainer. This driver is not actively developed, receives no updates, and is not recommended for new projects or existing applications. The project explicitly states it is no longer maintained and directs users to the official `node-oracledb` package, developed and supported by Oracle, as its direct and modern replacement. There is no defined release cadence, and its key differentiator is its historical role as an early community-contributed Oracle driver before Oracle released its own official solution.

database

npm install oracle

github ↗package ↗

INSTALL

IMPORT

SIG · ORACLE

oracle

databasejavascriptvv0.01

Install

—

Import

—

Disk

—

Pass rate

0/ 6

Env Coverage0 / 6

glibc

18–22

musl

18–22

Install & Compatibility

Where this runs

tested against v? · npm install

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

node 18–226 runs

build_error

glibc

node 18–226 runs

build_error

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

oracle

✓ const oracle = require('oracle');

This package is CommonJS-only due to its age (targeting Node.js >=0.6.0). ESM imports are not supported. It is strongly recommended to use `node-oracledb` instead.

connect

✓ const oracle = require('oracle'); oracle.connect( /* ... */ );

The primary interaction pattern was via the `connect` method on the main module export. For `node-oracledb`, the connection pattern is different, typically `oracledb.getConnection`.

Pool

✓ const oracle = require('oracle'); const pool = new oracle.Pool( /* ... */ );

The package likely offered connection pooling, instantiated directly from the main module export. Modern `node-oracledb` provides pooling via `oracledb.createPool`.

This quickstart explicitly states the package is abandoned and directs users to the recommended `node-oracledb` package for any Oracle database interaction.

/* This quickstart is intentionally left blank. The `oracle` package is abandoned and not maintained. It is strongly advised against using this package in any project. Please use the officially supported `oracledb` package instead: npm install oracledb Refer to the `node-oracledb` documentation for its quickstart: https://github.com/oracle/node-oracledb */ // Placeholder to fulfill quickstart requirements, do NOT run this code. // It is likely to fail with modern Node.js versions or require specific Oracle client setups. // const oracle = require('oracle'); // oracle.connect( // { hostname: 'localhost', port: 1521, database: 'ORCL', user: 'hr', password: 'hr' }, // function (err, connection) { // if (err) { // console.error("Error connecting to Oracle database:", err); // return; // } // console.log("Successfully connected to Oracle!"); // connection.execute("SELECT 'Hello World' FROM DUAL", [], function (err, results) { // if (err) { // console.error("Error executing query:", err); // } // console.log("Query result:", results); // connection.close(); // }); // } // );

Debug

Known issues

breakingThis package is explicitly unmaintained and abandoned. It will not receive security patches, bug fixes, or compatibility updates. Using it in production is a significant risk.

fix

Migrate immediately to `node-oracledb` (npm install oracledb). This requires rewriting database interaction code as the APIs are different.

affects: >=0.4.0

gotchaThe `oracle` package is highly unlikely to be compatible with recent versions of Node.js or modern Oracle client libraries without significant effort, if at all.

fix

No fix for this package; switch to `node-oracledb`.

affects: >=0.4.0

deprecatedThe official recommendation from the maintainer is to install and use `node-oracledb` instead. The `oracle` package serves no current purpose.

fix

Remove `oracle` from your project dependencies and install `oracledb` instead: `npm uninstall oracle && npm install oracledb`.

affects: >=0.4.0

Errors

Common errors & fixes

Error: Cannot find module 'oracle'

The package is not installed or the path is incorrect.

fix

Ensure `npm install oracle@0.3.9` was run (though highly discouraged). Prefer `npm install oracledb` instead.

Error: NJS-045: cannot load the Oracle Dynamic Library

Missing or incorrectly configured Oracle Client libraries (e.g., Instant Client). This package often had complex native dependencies.

fix

For the `oracle` package, ensuring proper ORACLE_HOME or LD_LIBRARY_PATH was difficult. For `node-oracledb`, refer to its installation guide for setting up Oracle Instant Client: https://github.com/oracle/node-oracledb/blob/main/INSTALL.md

TypeError: oracle.connect is not a function

The `oracle` module was not successfully required, or an older/corrupted version was installed.

fix

Verify installation. However, this error is a strong indicator to migrate away from this abandoned package to `node-oracledb`.

Upgrade

Version history

v0.01latest on npm

Audit

Dependencies

No dependency data recorded yet.

Agent activity

7 hits · last 30 days

node

Resources

githubhttps://github.com/joeferner/node-oracle ↗

packagehttps://www.npmjs.com/package/oracle ↗