Add tests and documentation for the final release

Author: sharadraju

doc/src/api_manual/connection.rst

@@ -1350,7 +1350,12 @@ Connection Methods
             If all values in all records for a particular bind variable are null, the type of that bind is ``oracledb.STRING`` with a maximum size of 1.
 
             The maximum sizes of strings and buffers are determined by scanning all records unless a :ref:`bindDefs <executemanyoptbinddefs>` property is used. This property explicitly specifies the characteristics of each bind variable.
-        * - options
+        * - ``numIterations``
+          - Number
+          - .. _executemanynumiterations:
+
+            If there are no bind values, or values have previously been bound, then you can set the ``numIterations`` parameter to an integer value that specifies the number of iterations. See :ref:`plsqlexecutemany` for an example of using this parameter.
+        * - ``options``
           - Object
           - .. _executemanyoptions:
 

doc/src/api_manual/oracledb.rst

@@ -3292,10 +3292,10 @@ Oracledb Methods
 
         promise = getNetworkServiceNames(String configDir);
 
-    Returns a list of network service names that is defined in the
-    :ref:`tnsnames.ora <tnsadmin>` file which is inside the directory that
-    is specified in the ``configDir`` property or the ``TNS_ADMIN``
-    environment variable if ``configDir`` is not specified. If a
+    Returns a list of TNS Aliases, also known as Network Service Names,
+    defined in the :ref:`tnsnames.ora <tnsadmin>` file which is inside the
+    directory that is specified in the ``configDir`` property or the
+    ``TNS_ADMIN`` environment variable if ``configDir`` is not specified. If a
     ``tnsnames.ora`` file does not exist, then an exception is raised.
 
     The parameters of the ``oracledb.getNetworkServiceNames()`` method are:

doc/src/conf.py

@@ -46,8 +46,8 @@
 # from the other)
 #
 # The short X.Y version.
-version = '6.6'
-release = '6.6.0'
+version = '6.7'
+release = '6.7.0'
 
 # There are two options for replacing |today|: either, you set today to some
 # non-false value, then it is used:

doc/src/release_notes.rst

@@ -5,44 +5,46 @@
 node-oracledb Release Notes
 ===========================
 
-For deprecated and desupported features, see :ref:`Deprecations and desupported features <deprecations>`.
+For deprecated and desupported features, see
+:ref:`Deprecations and desupported features <deprecations>`.
 
 node-oracledb `v6.7.0 <https://github.com/oracle/node-oracledb/compare/v6.6.0...v6.7.0>`__ (TBD)
 ---------------------------------------------------------------------------------------------------------
 
 Common Changes
 ++++++++++++++
 
-#)  Added tracing functionality for OpenTelemetry support.
+#)  Added :ref:`tracing functionality <tracehandlerinterface>` for
+    OpenTelemetry support.
 
 #)  Changed default values of ``transportConnectTimeout`` and
     ``retryDelay`` properties to *20* seconds and *1* second respectively in
     :meth:`oracledb.getConnection()` and :meth:`oracledb.createPool()` for
     consistency with other Oracle Database drivers.
 
 #)  Added method :meth:`oracledb.getNetworkServiceNames()` to support fetching
-    the list of network service names from the ``tnsnames.ora`` file.
+    the list of TNS Aliases from the ``tnsnames.ora`` file.
 
-#) Improvements to Centralized Configuration Providers support:
+#)  Improvements to Centralized Configuration Providers support:
 
-   - Added support to connect to Oracle Database via the centralized
-     configuration providers using wallets stored in Azure Key Vault and
-     OCI Vault.
+    - Added support to connect to Oracle Database via the centralized
+      configuration providers using wallets stored in Azure Key Vault and
+      OCI Vault.
 
-   - Added ability to cache the configuration information retrieved from
-     :ref:`Azure App Configuration <conninfocacheazure>` and
-     :ref:`OCI Object Storage <conninfocacheoci>` centralized configuration
-     providers.
+    - Added ability to cache the configuration information retrieved from
+      :ref:`Azure App Configuration <conninfocacheazure>` and
+      :ref:`OCI Object Storage <conninfocacheoci>` centralized configuration
+      providers.
 
-   - Ensure that the password stored in OCI vault and retrieved in
-     base64-encoded format is decoded correctly.
+    - Ensure that the password stored in OCI vault and retrieved in
+      base64-encoded format is decoded correctly.
 
-   - Added internal code changes to validate the updated OCI centralized
-     configuration provider URL syntax.
+    - Added internal code changes to validate the updated OCI centralized
+      configuration provider URL syntax.
 
-   - Changed the password type parameter values from `vault-oci` and
-     `vault-azure` to `ocivault` and `azurevault` respectively for consistency
-     with other Oracle Database drivers.
+    - Changed the password type parameter values from `vault-oci` and
+      `vault-azure` to `ocivault` and `azurevault` respectively for consistency
+      with other Oracle Database drivers.
 
 #)  Remove the 'Critical Dependency' warning from webpack builds.
     See `Issue #1678 <https://github.com/oracle/node-oracledb/issues/1678>`__.

doc/src/user_guide/batch_statement.rst

@@ -189,6 +189,8 @@ Output is::
       [ [ 'AAAmI9AAMAAAAnVAAB' ] ],
       [ [ 'AAAmI9AAMAAAAnVAAC' ] ] ]
 
+.. _plsqlexecutemany:
+
 Calling PL/SQL with ``executeMany()``
 =====================================
 

doc/src/user_guide/migrate.rst

@@ -4,6 +4,38 @@
 Upgrading to the Latest node-oracledb Releases
 **********************************************
 
+.. _upgradev66v67:
+
+Upgrading from node-oracledb 6.6 to 6.7
+=======================================
+
+- Review the :ref:`releasenotes` and take advantage of new features.
+
+- Using the new :meth:`oracledb.getNetworkServiceNames()` method, you can
+  fetch the list of TNS Aliases from the ``tnsnames.ora`` file.
+
+- With :ref:`Centralized Configuration Providers <configurationprovider>`, you
+  can now:
+
+  - Connect to Oracle Database using wallets stored in Azure Key Vault and OCI
+    vault.
+
+  - Cache the configuration information retrieved from
+    :ref:`Azure App Configuration <conninfocacheazure>` and
+    :ref:`OCI Object Storage <conninfocacheoci>` centralized configuration
+    providers.
+
+- In node-oracledb Thin mode, you can use the attributes
+  :attr:`oracledb.driverName`, :attr:`oracledb.machine`,
+  :attr:`oracledb.osUser`, :attr:`oracledb.program`, and
+  :attr:`oracledb.terminal` to set information about the driver name, machine
+  name, operating system user, program name, and terminal name respectively.
+
+- In node-oracledb Thick mode, the new ``regId`` property of the
+  :ref:`message object parameter <messageparam>` in the CQN subscription
+  :ref:`callback <consubscribeoptcallback>` function returns a unique
+  identifier during registration.
+
 .. _upgradev65v66:
 
 Upgrading from node-oracledb 6.5 to 6.6

doc/src/user_guide/tracing.rst

@@ -159,21 +159,23 @@ node-oracledb.
 
 Node-oracledb applications that call PL/SQL can step through that PL/SQL code
 using JDWP in a debugger. This allows Node.js and PL/SQL code to be debugged
-in the same debugger environment. You can enable PL/SQL debugging in the
-node-oracledb modes as follows:
+in the same debugger environment. You can enable PL/SQL debugging in
+node-oracledb as follows:
 
-- If you are using node-oracledb Thick mode, set the ``ORA_DEBUG_JDWP``
+- In node-oracledb Thin or Thick modes, set the ``ORA_DEBUG_JDWP``
   environment variable to `host=hostname;port=portnum` indicating where the
   PL/SQL debugger is running. Then run the application.
 
-- In node-oracledb Thin mode, you can additionally set the connection
+- In node-oracledb Thin mode, you can alternatively set the connection
   parameter ``debugJdwp`` during connection. This variable defaults to the
   value of the ``ORA_DEBUG_JDWP`` environment variable.
 
-See `DBMS_DEBUG_JDWP <https://docs.oracle.com/en/database/oracle/oracle-
-database/19/arpls/DBMS_DEBUG_JDWP.html>`_ and `Debugging PL/SQL from ASP.NET
-and Visual Studio <http://cshay.blogspot.com/2006/10/debugging-plsql-from-
-aspnet-and-visual.html>`_.
+See the documentation on `DBMS_DEBUG_JDWP <https://www.oracle.com/pls/topic/
+lookup?ctx=dblatest&id=GUID-AFF566A0-9E90-4218-B5C6-A74C3BF1CE14>`_, the video
+`PL/SQL debugging with Visual Studio and Visual Studio Code <https://www.
+youtube.com/watch?v=wk-3hLe30kk>`_, and the blog post `Debugging PL/SQL with
+Visual Studio Code (and more) <https://medium.com/oracledevs/debugging-pl-sql-
+with-visual-studio-code-and-more-45631f3952cf>`_.
 
 .. _tracingsql:
 

test/aq9.js

@@ -45,16 +45,12 @@ describe('301. aq9.js', function() {
   const ORDER_TYP   = `${AQ_USER}.ORDER_TYP`;
 
   before(async function() {
-    const userConfig = {
-      user: dbConfig.user,
-      password: dbConfig.password,
-      connectString: dbConfig.connectString
-    };
-    const initConn = await oracledb.getConnection(userConfig);
+    const initConn = await oracledb.getConnection(dbConfig);
     const dbVersion = initConn.oracleServerVersion;
     await initConn.close();
 
-    if (!dbConfig.test.DBA_PRIVILEGE || oracledb.thin || dbVersion < 1900000000) {
+    if (!dbConfig.test.DBA_PRIVILEGE || oracledb.thin || dbVersion < 1900000000
+      || testsUtil.getClientVersion() < 2306000000) {
       isRunnable = false;
     }
 

test/columnMetadata.js

@@ -1,4 +1,4 @@
-/* Copyright (c) 2015, 2023, Oracle and/or its affiliates. */
+/* Copyright (c) 2015, 2024, Oracle and/or its affiliates. */
 
 /******************************************************************************
  *
@@ -241,7 +241,7 @@ describe('9. columnMetadata.js', function() {
       await connection.execute(sqlDrop);
     });
 
-    it('9.10 works with a large number of columns', async function() {
+    it('9.3.1 works with a large number of columns', async function() {
       const column_size = 300;
       columns_string = genColumns(column_size, " NUMBER");
 
@@ -269,7 +269,7 @@ describe('9. columnMetadata.js', function() {
       await connection.execute(sqlDrop);
     });
 
-    it('9.11 works with re-executes with multiple packet response', async function() {
+    it('9.3.2 works with re-executes with multiple packet response', async function() {
       const column_size = 50;
       const numRows = 5;
       oracledb.fetchAsString = [oracledb.CLOB];

test/connection.js

@@ -1,4 +1,4 @@
-/* Copyright (c) 2015, 2023, Oracle and/or its affiliates. */
+/* Copyright (c) 2015, 2024, Oracle and/or its affiliates. */
 
 /******************************************************************************
  *
@@ -762,7 +762,14 @@ describe('1. connection.js', function() {
       }
 
       res = await conn2.execute(sqlDriverName);
-      assert.deepStrictEqual(res.rows[0][0], 'mydriver1');
+      /*
+        In Oracle 12.1 DB, The driver name (CLIENT_DRIVER column in V$SESSION_CONNECT_INFO view)
+        can be set only upto 8 characters.
+      */
+      let serverVersion = conn2.oracleServerVersion;
+      if (serverVersion < 1202000000)
+        assert.deepStrictEqual(res.rows[0][0], 'mydriver');
+      else assert.deepStrictEqual(res.rows[0][0], 'mydriver1');
 
       // Generate random values for the third connection
       const randomPgm3 = random.getRandomLengthString(16);
@@ -794,7 +801,14 @@ describe('1. connection.js', function() {
       }
 
       res = await conn3.execute(sqlDriverName);
-      assert.deepStrictEqual(res.rows[0][0], 'mydriver3');
+      /*
+        In Oracle 12.1 DB, The driver name (CLIENT_DRIVER column in V$SESSION_CONNECT_INFO view)
+        can be set only upto 8 characters.
+      */
+      serverVersion = conn2.oracleServerVersion;
+      if (serverVersion < 1202000000)
+        assert.deepStrictEqual(res.rows[0][0], 'mydriver');
+      else assert.deepStrictEqual(res.rows[0][0], 'mydriver3');
 
       // Cleanup
       await conn1.close();
@@ -817,7 +831,9 @@ describe('1. connection.js', function() {
       assert.strictEqual(res.rows[0][0], os.hostname());
       assert.strictEqual(res.rows[0][1], os.userInfo().username);
       assert.strictEqual(res.rows[0][2], 'unknown');
-      assert.strictEqual(res.rows[0][3], process.argv0);
+      // Whitespaces, ( and ) are replaced by ? for the program name
+      // in V$SESSION
+      assert.strictEqual(res.rows[0][3], process.argv0.replace(/[\s()]/g, '?'));
 
       if (dbConfig.test.drcp) {
         const bindParams = {
@@ -828,11 +844,20 @@ describe('1. connection.js', function() {
         res = await conn.execute(sqlDRCPSessionDetails, bindParams);
         assert.deepStrictEqual(res.rows[0][0], os.hostname());
         assert.deepStrictEqual(res.rows[0][1], 'unknown');
-        assert.deepStrictEqual(res.rows[0][2], process.argv0);
+        // Whitespaces, ( and ) are replaced by ? for the program name
+        // in V$SESSION
+        assert.deepStrictEqual(res.rows[0][2], process.argv0.replace(/[\s()]/g, '?'));
       }
 
       res = await conn.execute(sqlDriverName);
-      assert.strictEqual(res.rows[0][0], "node-oracledb : " + oracledb.versionString + " thn");
+      /*
+        In Oracle 12.1 DB, The driver name (CLIENT_DRIVER column in V$SESSION_CONNECT_INFO view)
+        can be set only upto 8 characters.
+      */
+      const serverVersion = conn.oracleServerVersion;
+      if (serverVersion < 1202000000)
+        assert.strictEqual(res.rows[0][0], "node-ora");
+      else assert.strictEqual(res.rows[0][0], "node-oracledb : " + oracledb.versionString + " thn");
 
       await conn.close();
     }); // 1.18.3

test/dataTypeDate.js

@@ -186,7 +186,7 @@ describe('32. dataTypeDate.js', function() {
 
       // Add an assert statement to check the result
       assert.deepStrictEqual(result.rows,
-        [['01/01/1900 00:00:00']]);
+        [[new Date('01-01-1900').toLocaleString('fr')]]);
     });
 
     it('32.4.3 Negative - Invalid Year -4713', async function() {

test/dataTypeUrowid.js

@@ -1,4 +1,4 @@
-/* Copyright (c) 2017, 2023, Oracle and/or its affiliates. */
+/* Copyright (c) 2017, 2024, Oracle and/or its affiliates. */
 
 /******************************************************************************
  *
@@ -143,7 +143,7 @@ describe('113. dataTypeUrowid.js', function() {
         const resultVal = rows[i].CONTENT;
         assert(resultVal);
       }
-      return fetchRowsFromRS(rs);
+      return await fetchRowsFromRS(rs);
     } else {
       await rs.close();
     }
@@ -185,7 +185,7 @@ describe('113. dataTypeUrowid.js', function() {
         assert(typeof resultVal, "string");
         await verifyFetchValues(connection, rsrows[i].NUM, rsrows[i].CONTENT, tableName);
       }
-      return fetchRowsFromRS_fetchas(rs);
+      return await fetchRowsFromRS_fetchas(rs);
     } else {
       await rs.close();
     }

test/dataTypeVector1.js

@@ -1289,7 +1289,8 @@ describe('294. dataTypeVector1.js', function() {
   }); // 294.51
 
   it('294.52 executeMany with positional args in vector binary flex column', async function() {
-    if (!isVectorBinaryRunnable) this.skip();
+    const serverVersion = connection.oracleServerVersion;
+    if (serverVersion <= 2306000000 || !isVectorBinaryRunnable) this.skip();
 
     const rows = [
       [1, [1, 2]],

test/dataTypeVector4.js

@@ -184,7 +184,7 @@ describe('298. dataTypeVector4.js', function() {
     `);
 
     assert.strictEqual(result.rows.length, 1);
-    assert.deepStrictEqual(result.rows, [[0.10298221668758012]]);
+    assert.deepStrictEqual(result.rows[0][0].toFixed(6), '0.102982');
   }); // 298.4
 
   it('298.5 insert and select Max vector distance function', async function() {
@@ -214,7 +214,7 @@ describe('298. dataTypeVector4.js', function() {
     `);
 
     assert.strictEqual(result.rows.length, 1);
-    assert.deepStrictEqual(result.rows, [[0.28645724726349675]]);
+    assert.deepStrictEqual(result.rows[0][0].toFixed(6), '0.286457');
   }); // 298.5
 
   it('298.6 sum vector distance function vector columns with parallel execution', async function() {
@@ -299,10 +299,12 @@ describe('298. dataTypeVector4.js', function() {
 
     const clientVersion = testsUtil.getClientVersion();
     const serverVersion = connection.oracleServerVersion;
+    const majorServerVersion = Math.floor(serverVersion / 1000000);
+    const majorClientVersion = Math.floor(clientVersion / 1000000);
 
-    // Aggregate functions on vector columns is available from 23.6 onwards
-    if (serverVersion >= 2306000000 &&
-      (oracledb.thin || clientVersion >= 2306000000)) {
+    // Aggregate functions on vector columns are not implemented in Oracle Database 23.6 or earlier versions
+    if (majorServerVersion > 2306 &&
+      (oracledb.thin || majorClientVersion > 2306)) {
       const result = await connection.execute(`
       SELECT /*+ parallel(4) */ sum(VectorCol)
       FROM ${tableName}

test/dataTypeVector5.js

@@ -221,7 +221,7 @@ describe('305. dataTypeVector5.js', function() {
         [`SELECT VECTOR_DISTANCE(VectorInt8Col1, VectorInt8Col2, EUCLIDEAN_SQUARED) from ${tableName}`, '10405.0000'],
         [`SELECT VECTOR_DISTANCE(VectorInt8Col1, VECTOR('[30, 40]', 2, INT8), EUCLIDEAN_SQUARED) from ${tableName}`, '16441.0000'],
         [`SELECT VECTOR_DISTANCE(Vector32Col1, Vector32Col2, EUCLIDEAN_SQUARED) from ${tableName}`, '11.9213'],
-        [`SELECT VECTOR_DISTANCE(Vector32Col1, VECTOR('[30, 40]', 2, FLOAT32), EUCLIDEAN_SQUARED) from ${tableName}`, '1778.7235'],
+        [`SELECT VECTOR_DISTANCE(Vector32Col1, VECTOR('[30, 40]', 2, FLOAT32), EUCLIDEAN_SQUARED) from ${tableName}`, '1778.7236'],
         [`SELECT VECTOR_DISTANCE(Vector64Col1, Vector64Col2, EUCLIDEAN_SQUARED) from ${tableName}`, '846400010320.4973'],
         [`SELECT VECTOR_DISTANCE(Vector64Col1, VECTOR('[30, 40]', 2, FLOAT64), EUCLIDEAN_SQUARED) from ${tableName}`, '864954547855.4663']
       ]);
@@ -251,7 +251,7 @@ describe('305. dataTypeVector5.js', function() {
             (VectorInt8Col1 <=> VectorInt8Col2) from ${tableName}
           `);
       assert.deepStrictEqual(result.rows[0].toString(),
-        '143,102.00489807128906,102.00489807128906,0.014268875122070312,-13545,13545,0.014268875122070312');
+        '143,102.00490184299969,102.00490184299969,0.014268875320571528,-13545,13545,0.014268875320571528');
 
       result = await connection.execute(`
             SELECT L1_DISTANCE(Vector32Col1, Vector32Col2),
@@ -263,8 +263,8 @@ describe('305. dataTypeVector5.js', function() {
             (Vector32Col1 <=> Vector32Col2) from ${tableName}
       `);
       assert.deepStrictEqual(result.rows[0],
-        [4.650000095367432, 3.452723741531372, 3.452723741531372, 0.05660730600357056,
-          -37.957801818847656, 37.95780015678406, 0.05660730600357056]);
+        [4.650000095367432, 3.4527236567155133, 3.4527236567155133, 0.056607300796886584,
+          -37.95780086517334, 37.95780086517334, 0.056607300796886584]);
 
       result = await connection.execute(`
             SELECT L1_DISTANCE(Vector64Col1, Vector64Col2),

test/dataTypeXML.js

@@ -1,4 +1,4 @@
-/* Copyright (c) 2018, 2022, Oracle and/or its affiliates. */
+/* Copyright (c) 2018, 2024, Oracle and/or its affiliates. */
 
 /******************************************************************************
  *
@@ -36,7 +36,7 @@ const assert   = require('assert');
 const dbConfig = require('./dbconfig.js');
 
 describe('181. dataTypeXML.js', function() {
-
+  let conn;
   const tableName = "nodb_tab_xml";
   const testRowID = 1;
   const testXMLData =
@@ -58,7 +58,7 @@ describe('181. dataTypeXML.js', function() {
     // Storing XMLType column as clob is disallowed in Oracle ADB.
     if (dbConfig.test.isCloudService) this.skip();
 
-    const connection = await oracledb.getConnection(dbConfig);
+    const connCreate = await oracledb.getConnection(dbConfig);
 
     let sql =
       "BEGIN \n" +
@@ -79,19 +79,19 @@ describe('181. dataTypeXML.js', function() {
       "        ) XMLTYPE embedLOBXML STORE AS CLOB\n" +
       "    '); \n" +
       "END; ";
-    await connection.execute(sql);
-    await connection.commit();
-    await connection.close();
+    await connCreate.execute(sql);
+    await connCreate.commit();
+    await connCreate.close();
 
-    const conn = await oracledb.getConnection(dbConfig);
+    const connInsert = await oracledb.getConnection(dbConfig);
 
     sql = "insert into " + tableName + " ( num, content ) values ( :id, XMLType(:bv) )";
     const bindValues = { id: testRowID, bv: testXMLData };
-    const result = await conn.execute(sql, bindValues);
+    const result = await connInsert.execute(sql, bindValues);
     assert.strictEqual(result.rowsAffected, 1);
 
-    await conn.commit();
-    await conn.close();
+    await connInsert.commit();
+    await connInsert.close();
 
   }); // before
 
@@ -107,8 +107,15 @@ describe('181. dataTypeXML.js', function() {
     await connection.close();
   }); // after
 
+  beforeEach('create conn', async () => {
+    conn = await oracledb.getConnection(dbConfig);
+  });
+
+  afterEach('close conn', async () => {
+    await conn.close();
+  });
+
   it('181.1 basic case, insert XML data and query back', async () => {
-    const conn = await oracledb.getConnection(dbConfig);
     const sql = "select content from " + tableName + " where num = :id";
     const bindVar = { id: testRowID };
     const options = { outFormat: oracledb.OUT_FORMAT_OBJECT };
@@ -120,13 +127,9 @@ describe('181. dataTypeXML.js', function() {
       assert.strictEqual(result.metaData[0].dbType, oracledb.DB_TYPE_XMLTYPE);
       assert.strictEqual(result.metaData[0].fetchType, oracledb.DB_TYPE_XMLTYPE);
     }
-
-    await conn.close();
   }); // 181.1
 
   it('181.2 query XML data as CLOB', async () => {
-    const conn = await oracledb.getConnection(dbConfig);
-
     const sql = "select xmltype.getclobval(content) as mycontent from " + tableName + " where num = :id";
     const bindVar = { id: testRowID };
     const options = {
@@ -135,12 +138,9 @@ describe('181. dataTypeXML.js', function() {
     };
     const result = await conn.execute(sql, bindVar, options);
     assert.strictEqual(result.rows[0].MYCONTENT, testXMLData);
-
-    await conn.close();
   }); // 181.2
 
   it('181.3 another query as CLOB syntax', async function() {
-    const conn = await oracledb.getConnection(dbConfig);
     if (conn.oracleServerVersion < 1200000000) {
       await conn.close();
       this.skip();
@@ -155,13 +155,11 @@ describe('181. dataTypeXML.js', function() {
     };
     const result = await conn.execute(sql, bindVar, options);
     assert.strictEqual(result.rows[0].MYCONTENT, testXMLData);
-    await conn.close();
   }); // 181.3
 
   it('181.4 Negative - try to insert Null', async () => {
     const ID = 20;
     const XML = '';
-    const conn = await oracledb.getConnection(dbConfig);
 
     const sql = "insert into " + tableName + " ( num, content ) values ( :id, XMLType(:bv) )";
     const bindValues = { id: ID, bv: XML };
@@ -181,17 +179,19 @@ describe('181. dataTypeXML.js', function() {
     }
 
     await conn.commit();
-    await conn.close();
   }); // 181.4
 
-  it('181.5 inserts data that is larger than 4K', async () => {
+  it('181.5 inserts data that is larger than 4K', async function() {
+
+    // Insert of LONG data > 4K is not allowed in Oracle Database 12.1
+    // It throws an ORA-01461 error
+    if (conn.oracleServerVersion < 1202000000) this.skip();
+
     const ID = 50;
     const str = 'a'.repeat(31 * 1024);
     const head = '<data>', tail = '</data>\n';
     const xml = head.concat(str).concat(tail);
 
-    const conn = await oracledb.getConnection(dbConfig);
-
     let sql = "insert into " + tableName + " ( num, content ) values ( :id, XMLType(:bv) )";
     const bindValues = { id: ID, bv: xml };
     let result = await conn.execute(sql, bindValues);
@@ -211,7 +211,6 @@ describe('181. dataTypeXML.js', function() {
       assert.strictEqual(result.rows[0].OBJ, xml);
     }
     await conn.commit();
-    await conn.close();
   }); // 181.5
 
   it('181.6 Insert and Verify Embedded LOB locator inside XML', async () => {
@@ -222,7 +221,6 @@ describe('181. dataTypeXML.js', function() {
     const xml = head.concat(smallstr).concat(tail);
     const largexml = head.concat(largestr).concat(tail);
 
-    const conn = await oracledb.getConnection(dbConfig);
     const lob = await conn.createLob(oracledb.CLOB);
     await lob.write(largexml);
 
@@ -250,7 +248,6 @@ describe('181. dataTypeXML.js', function() {
       lob.destroy();
     });
     await conn.commit();
-    await conn.close();
   }); // 181.6
 
 });

test/dbObject20.js

@@ -1273,7 +1273,7 @@ describe('290. dbObject20.js', () => {
     let pool, sysDBAConn, sid;
     const TYPE1 = 'NODB_TYP_NODB_MASTER_ID_ARR';
 
-    before(async () => {
+    before(async function() {
       if (!dbConfig.test.DBA_PRIVILEGE) this.skip();
 
       const dbaConfig = {

test/fetchArraySize2.js

@@ -1,4 +1,4 @@
-/* Copyright (c) 2017, 2023, Oracle and/or its affiliates. */
+/* Copyright (c) 2017, 2024, Oracle and/or its affiliates. */
 
 /******************************************************************************
  *
@@ -255,7 +255,7 @@ describe("149. fetchArraySize2.js", function() {
         { outFormat: oracledb.OUT_FORMAT_OBJECT }
       );
       const rowCount = 0;
-      fetchRowsFromRS(result.outBinds[0], numRowsVal, rowCount);
+      await fetchRowsFromRS(result.outBinds[0], numRowsVal, rowCount);
 
       await connection.execute(drop_ref);
     };
@@ -269,7 +269,7 @@ describe("149. fetchArraySize2.js", function() {
           assert.strictEqual(rows[i].ID, rowCount);
           assert.strictEqual(rows[i].CONTENT, rowCount.toString());
         }
-        return fetchRowsFromRS(rs, numRowsVal, rowCount);
+        return await fetchRowsFromRS(rs, numRowsVal, rowCount);
       } else {
         assert.strictEqual(rowCount, tableSize);
         await rs.close();

test/inBandNotification.js

@@ -0,0 +1,262 @@
+/* Copyright (c) 2024, Oracle and/or its affiliates. */
+
+/******************************************************************************
+ *
+ * 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
+ *
+ *    https://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.
+ *
+ * NAME
+ *  308. inBandNotification.js
+ *  No special setup is required but the test makes use of debugging packages
+ *  that are not intended for normal use.
+ *  dbms_tg_dbg.set_session_drainable, here debug package (dbms_tg_dbg) is used to simulate an inband notification.
+ */
+
+'use strict';
+
+const oracledb = require('oracledb');
+const assert = require('assert');
+const dbConfig = require('./dbconfig.js');
+const testsUtil = require('./testsUtil.js');
+
+describe('308. Inband Notification', function() {
+  let isRunnable = false;
+  const DBA_config = dbConfig.test.DBA_PRIVILEGE ? {
+    user: dbConfig.test.DBA_user,
+    password: dbConfig.test.DBA_password,
+    connectString: dbConfig.connectString,
+    privilege: oracledb.SYSDBA
+  } : null;
+
+  let dbaConn;
+
+  before(async function() {
+    isRunnable = await testsUtil.checkPrerequisites(1800000000, 1800000000);
+    if (!dbConfig.test.DBA_PRIVILEGE || !isRunnable) this.skip();
+    dbaConn = await oracledb.getConnection(DBA_config);
+    await dbaConn.execute(`GRANT EXECUTE ON dbms_tg_dbg TO ${dbConfig.user}`);
+    await dbaConn.execute(`GRANT SELECT ON v_$session TO ${dbConfig.user}`);
+  });
+
+  after(async function() {
+    if (dbConfig.test.DBA_PRIVILEGE && isRunnable) {
+      await dbaConn.execute(`REVOKE EXECUTE ON dbms_tg_dbg FROM ${dbConfig.user}`);
+      await dbaConn.execute(`REVOKE SELECT ON v_$session FROM ${dbConfig.user}`);
+      await dbaConn.close();
+    }
+  });
+
+  describe('308.1 Standalone Connection', function() {
+    let conn;
+
+    beforeEach(async function() {
+      conn = await oracledb.getConnection(dbConfig);
+    });
+
+    afterEach(async function() {
+      await conn.close();
+    });
+
+    it('308.1.1 test standalone connection is marked unhealthy', async function() {
+      assert.strictEqual(conn.isHealthy(), true);
+
+      await conn.execute("BEGIN dbms_tg_dbg.set_session_drainable; END;");
+      const result = await conn.execute("SELECT user FROM dual");
+      assert.strictEqual(result.rows[0][0], dbConfig.user.toUpperCase());
+
+      assert.strictEqual(conn.isHealthy(), false);
+    }); // 308.1.1
+
+    it('308.1.2 test connection health after executing a long-running query', async function() {
+      assert.strictEqual(conn.isHealthy(), true);
+
+      const majorDBVersion = await testsUtil.getMajorDBVersion();
+
+      // Appropriate sleep procedure based on the database version
+      const sleepProc = (majorDBVersion >= 18) ? 'dbms_session.sleep' : 'dbms_lock.sleep';
+
+      await conn.execute(`
+          BEGIN
+              ${sleepProc}(5);
+          END;
+      `);
+
+      assert.strictEqual(conn.isHealthy(), true);
+
+      await conn.execute("BEGIN dbms_tg_dbg.set_session_drainable; END;");
+      assert.strictEqual(conn.isHealthy(), false);
+    }); // 308.1.2
+
+    it('308.1.3 test connection health after a PL/SQL error', async function() {
+      assert.strictEqual(conn.isHealthy(), true);
+
+      await assert.rejects(
+        async () => await conn.execute(`
+              BEGIN
+                  RAISE_APPLICATION_ERROR(-20001, 'Test error');
+              END;
+          `),
+        /ORA-20001/ // Test error
+      );
+
+      assert.strictEqual(conn.isHealthy(), true);
+
+      await conn.execute("BEGIN dbms_tg_dbg.set_session_drainable; END;");
+      assert.strictEqual(conn.isHealthy(), false);
+    }); // 308.1.3
+
+    it('308.1.4 test connection health after setting session drainable multiple times', async function() {
+      assert.strictEqual(conn.isHealthy(), true);
+
+      await conn.execute("BEGIN dbms_tg_dbg.set_session_drainable; END;");
+      assert.strictEqual(conn.isHealthy(), false);
+
+      await conn.execute("BEGIN dbms_tg_dbg.set_session_drainable; END;");
+      assert.strictEqual(conn.isHealthy(), false);
+    }); // 308.1.4
+
+    it('308.1.5 test connection health after ORA-00001 unique constraint error', async function() {
+      const tableName = 'emp';
+      const sql = `CREATE TABLE ${tableName} (
+                    id NUMBER primary key,
+                    VALUE varchar(30)
+                )`;
+      await conn.execute(testsUtil.sqlCreateTable(tableName, sql));
+
+      await assert.rejects(
+        async () => await conn.execute(`
+          BEGIN
+            INSERT INTO ${tableName} (id, value) VALUES (1, 'test');
+            INSERT INTO ${tableName} (id, value) VALUES (1, 'test'); -- Will cause ORA-00001
+          END;
+        `),
+        /ORA-00001/
+      );
+
+      assert.strictEqual(conn.isHealthy(), true);
+
+      await conn.execute("BEGIN dbms_tg_dbg.set_session_drainable; END;");
+      assert.strictEqual(conn.isHealthy(), false);
+    }); // 308.1.5
+
+    it('308.1.6 test connection health after multiple drainable sessions in quick succession', async function() {
+      assert.strictEqual(conn.isHealthy(), true);
+
+      for (let i = 0; i < 5; i++) {
+        await conn.execute("BEGIN dbms_tg_dbg.set_session_drainable; END;");
+        assert.strictEqual(conn.isHealthy(), false);
+      }
+    }); // 308.1.6
+  });
+
+  describe('308.2 Pooled Connection', function() {
+    let pool;
+
+    before(async function() {
+      pool = await oracledb.createPool({
+        ...dbConfig,
+        poolMin: 1,
+        poolMax: 2,
+        poolIncrement: 1
+      });
+    });
+
+    after(async function() {
+      await pool.close(0);
+    });
+
+    it('308.2.1 test pooled connection that is marked unhealthy', async function() {
+      /* Skip this test for clients before 23.1 due to inconsistent behavior
+         of OCI_ATTR_SERVER_STATUS on subsequent calls.
+      */
+      if (!oracledb.thin && testsUtil.getClientVersion() < 2301000000)
+        this.skip();
+      const conn1 = await pool.getConnection();
+      assert.strictEqual(conn1.isHealthy(), true);
+
+      await conn1.execute("BEGIN dbms_tg_dbg.set_session_drainable; END;");
+      const info = await getSidSerial(conn1);
+      assert.strictEqual(conn1.isHealthy(), false);
+      await conn1.close();
+
+      const conn2 = await pool.getConnection();
+      assert.strictEqual(conn2.isHealthy(), true);
+      const newInfo = await getSidSerial(conn2);
+      assert.notStrictEqual(newInfo, info);
+      await conn2.close();
+    }); // 308.2.1
+
+    it('308.2.2 test multiple connections in a pool with inband notifications', async function() {
+      const conn1 = await pool.getConnection();
+      const conn2 = await pool.getConnection();
+
+      assert.strictEqual(conn1.isHealthy(), true);
+      assert.strictEqual(conn2.isHealthy(), true);
+
+      await conn1.execute("BEGIN dbms_tg_dbg.set_session_drainable; END;");
+      assert.strictEqual(conn1.isHealthy(), false);
+      assert.strictEqual(conn2.isHealthy(), true);
+
+      await conn1.close();
+      await conn2.close();
+    }); // 308.2.2
+
+    it('308.2.3 test connection reuse after marking unhealthy', async function() {
+      const conn1 = await pool.getConnection();
+      assert.strictEqual(conn1.isHealthy(), true);
+
+      await conn1.execute("BEGIN dbms_tg_dbg.set_session_drainable; END;");
+      assert.strictEqual(conn1.isHealthy(), false);
+      await conn1.close();
+
+      const conn2 = await pool.getConnection();
+      assert.strictEqual(conn2.isHealthy(), true);
+      await conn2.close();
+    }); // 308.2.3
+
+    it('308.2.4 test pool draining with multiple sessions', async function() {
+      const conn1 = await pool.getConnection();
+      const conn2 = await pool.getConnection();
+
+      assert.strictEqual(conn1.isHealthy(), true);
+      assert.strictEqual(conn2.isHealthy(), true);
+
+      await conn1.execute("BEGIN dbms_tg_dbg.set_session_drainable; END;");
+      assert.strictEqual(conn1.isHealthy(), false);
+
+      await conn2.execute("BEGIN dbms_tg_dbg.set_session_drainable; END;");
+      assert.strictEqual(conn2.isHealthy(), false);
+
+      await conn1.close();
+      await conn2.close();
+
+      const conn3 = await pool.getConnection();
+      assert.strictEqual(conn3.isHealthy(), true);
+      await conn3.close();
+    }); // 308.2.4
+  });
+
+  async function getSidSerial(conn) {
+    const result = await conn.execute(
+      "SELECT sid || ',' || serial# AS info FROM v$session WHERE audsid = SYS_CONTEXT('USERENV', 'SESSIONID')"
+    );
+    return result.rows[0][0];
+  }
+});

test/jsonDualityViews2.js

@@ -188,7 +188,7 @@ describe('273. jsonDualityView2.js', function() {
     await connection.execute(testsUtil.sqlDropTable(`student`));
   });
 
-  it('273.6 Specify DELETE, NODELETE both, BUG number : 34657745', async function() {
+  it('273.6 Specify DELETE, NODELETE both', async function() {
     await connection.execute(testsUtil.sqlCreateTable('student', sqlCreateTableStudent));
 
     // insert data into student table
@@ -198,14 +198,7 @@ describe('273. jsonDualityView2.js', function() {
 
     // commit the transaction
     await connection.execute(`COMMIT`);
-    await assert.rejects(
-      async () => await connection.execute(`CREATE OR REPLACE JSON RELATIONAL DUALITY VIEW student_ov
-                    AS
-                    Student
-                    {StudentId: stuid @NODELETE, StudentName: name}`),
-      /ORA-40934:/ //ORA-40934: Cannot create JSON Relational Duality View 'STUDENT_OV':
-      //Invalid or conflicting annotations in the WITH clause.
-    );
+
     await assert.rejects(
       async () => await connection.execute(`CREATE OR REPLACE JSON RELATIONAL DUALITY VIEW student_ov
                     AS

test/jsonDualityViews4.js

@@ -353,7 +353,7 @@ describe('275. jsonDualityView4.js', function() {
       SELECT view_name, view_owner, ROOT_TABLE_NAME
       FROM DBA_JSON_DUALITY_VIEWS
       ORDER BY view_name`);
-    assert.strictEqual(result.rows.length, 1);
+    assert.strictEqual(result.rows[0].length, 3);
 
     // Query 2: select view_owner, view_name, relationship from DBA_JSON_DUALITY_VIEW_TABS
     result = await dbaConn.execute(`
@@ -368,9 +368,8 @@ describe('275. jsonDualityView4.js', function() {
       SELECT COLUMN_NAME, DATA_TYPE
       FROM DBA_JSON_DUALITY_VIEW_TAB_COLS
       ORDER BY COLUMN_NAME`);
-
-    assert.deepStrictEqual(result.rows, [["CLSID", "NUMBER"], ["CLSID", "NUMBER"], ["NAME", "VARCHAR2"],
-      ["NAME", "VARCHAR2"], ["SCID", "NUMBER"], ["STUID", "NUMBER"], ["STUID", "NUMBER"]]);
+    assert.deepStrictEqual(result.rows, [["CLSID", "NUMBER"], ["CLSID", "NUMBER"], ["NAME", "VARCHAR2"], ["NAME", "VARCHAR2"], ["SCID", "NUMBER"],
+      ["STUID", "NUMBER"], ["STUID", "NUMBER"]]);
   });
 
   describe('275.7 Json Duality view with GraphQL', function() {

test/jsonDualityViews5.js

@@ -215,8 +215,12 @@ describe('276. jsonDualityView5.js', function() {
            {StudentClassId : scid,
       Class : class  {ClassId: clsid, Name: name}}}
     `),
-      /ORA-40934:/ /*ORA-40934: Cannot create JSON Relational Duality View 'STUDENT_OV': Invalid or
-                    conflicting annotations in the WITH clause */
+      // Server version < v26.1 will return ORA-40934
+      /ORA-40934|ORA-43411:/
+      /*
+        ORA-40934: Cannot create JSON Relational Duality View 'STUDENT_OV': Invalid or conflicting annotations for the JSON field.
+        ORA-43411: Invalid directive 'del' for the table 'STUDENT'
+      */
     );
 
     await assert.rejects(
@@ -232,8 +236,12 @@ describe('276. jsonDualityView5.js', function() {
            {StudentClassId : scid,
       Class : class  {ClassId: clsid, Name: name}}}
     `),
-      /ORA-40934:/ /*ORA-40934: Cannot create JSON Relational Duality View 'STUDENT_OV': Invalid or
-                    conflicting annotations in the WITH clause */
+      // Server version < v26.1 will return ORA-40934
+      /ORA-40934|ORA-43411:/
+      /*
+        ORA-40934: Cannot create JSON Relational Duality View 'STUDENT_OV': Invalid or conflicting annotations for the JSON field.
+        ORA-43411: Invalid directive 'ins' for the table 'STUDENT'
+      */
     );
 
     await assert.rejects(
@@ -295,8 +303,12 @@ describe('276. jsonDualityView5.js', function() {
            {StudentClassId : scid,
       Class : class  {ClassId: clsid, Name: name}}}
     `),
-      /ORA-40934:/ /*ORA-40934: Cannot create JSON Relational Duality View 'STUDENT_OV': Invalid or
-                    conflicting annotations in the WITH clause */
+      // Server version < v26.1 will return ORA-40934
+      /ORA-40934|ORA-43411:/
+      /*
+        ORA-40934: Cannot create JSON Relational Duality View 'STUDENT_OV': Invalid or conflicting annotations for the JSON field.
+        ORA-43411: Invalid directive 'nodelete' for the table 'STUDENT'
+      */
     );
 
     await assert.rejects(
@@ -328,8 +340,12 @@ describe('276. jsonDualityView5.js', function() {
            {StudentClassId : scid,
       Class : class  {ClassId: clsid, Name: name}}}
     `),
-      /ORA-40934:/ /*ORA-40934: Cannot create JSON Relational Duality View 'STUDENT_OV': Invalid or
-                    conflicting annotations in the WITH clause */
+      // Server version < v26.1 will return ORA-40934
+      /ORA-40934|ORA-43411:/
+      /*
+        ORA-40934: Cannot create JSON Relational Duality View 'STUDENT_OV': Invalid or conflicting annotations for the JSON field.
+        ORA-43411: Invalid directive 'insert' for the table 'STUDENT'
+      */
     );
 
     await connection.execute(`
@@ -424,8 +440,12 @@ describe('276. jsonDualityView5.js', function() {
            {StudentClassId : scid,
       Class : class  {ClassId: clsid, Name: name @NOUPDATE @UPDATE}}}
     `),
-      /ORA-40934:/ /*ORA-40934: Cannot create JSON Relational Duality View 'STUDENT_OV': Invalid or
-                    conflicting annotations in the WITH clause */
+      // Server version < v26.1 will return ORA-40934
+      /ORA-40934|ORA-43411:/
+      /*
+        ORA-40934: Cannot create JSON Relational Duality View 'STUDENT_OV': Invalid or conflicting annotations for the JSON field.
+        ORA-43411: Invalid directive 'nodelete' for the table 'STUDENT'
+      */
     );
 
     await assert.rejects(
@@ -470,8 +490,12 @@ describe('276. jsonDualityView5.js', function() {
            {StudentClassId : scid,
       Class : class  {ClassId: clsid, Name: name}}}
     `),
-      /ORA-40934:/ /*ORA-40934: Cannot create JSON Relational Duality View 'STUDENT_OV': Invalid or
-                    conflicting annotations in the WITH clause */
+      // Server version < v26.1 will return ORA-40934
+      /ORA-40934|ORA-43411:/
+      /*
+        ORA-40934: Cannot create JSON Relational Duality View 'STUDENT_OV': Invalid or conflicting annotations for the JSON field.
+        ORA-43411: Invalid directive 'readonly' for the table 'STUDENT'
+      */
     );
 
     await connection.execute(`
@@ -484,7 +508,7 @@ describe('276. jsonDualityView5.js', function() {
         StudentClass :
         student_class @insert@update@delete
            {StudentClassId : scid,
-      Class : class  {ClassId: clsid, Name: name}}}
+      Class : class  @insert@update {ClassId: clsid, Name: name}}}
     `);
 
     await connection.execute(`
@@ -508,8 +532,12 @@ describe('276. jsonDualityView5.js', function() {
            {StudentClassId : scid,
             Class : class  {ClassId: clsid, Name: name}}}
     `),
-      /ORA-40934:/ /*ORA-40934: Cannot create JSON Relational Duality View 'STUDENT_OV': Invalid or
-                    conflicting annotations in the WITH clause */
+      // Server version < v26.1 will return ORA-40934
+      /ORA-40934|ORA-43411:/
+      /*
+        ORA-40934: Cannot create JSON Relational Duality View 'STUDENT_OV': Invalid or conflicting annotations for the JSON field.
+        ORA-43411: Invalid directive 'read' for the table 'STUDENT'
+      */
     );
 
     await assert.rejects(
@@ -541,8 +569,12 @@ describe('276. jsonDualityView5.js', function() {
            {StudentClassId : scid,
             Class : class  {ClassId: clsid, Name: name}}}
     `),
-      /ORA-40934:/ /*ORA-40934: Cannot create JSON Relational Duality View 'STUDENT_OV': Invalid or
-                    conflicting annotations in the WITH clause */
+      // Server version < v26.1 will return ORA-40934
+      /ORA-40934|ORA-43411:/
+      /*
+        ORA-40934: Cannot create JSON Relational Duality View 'STUDENT_OV': Invalid or conflicting annotations for the JSON field.
+        ORA-43411: Invalid directive 'etag' for the table 'STUDENT'
+      */
     );
 
     await assert.rejects(
@@ -558,8 +590,12 @@ describe('276. jsonDualityView5.js', function() {
            {StudentClassId : scid,
             Class : class {ClassId: clsid, Name: name}}}
     `),
-      /ORA-40934:/ /*ORA-40934: Cannot create JSON Relational Duality View 'STUDENT_OV': Invalid or
-                    conflicting annotations in the WITH clause */
+      // Server version < v26.1 will return ORA-40934
+      /ORA-40934|ORA-43411:/
+      /*
+        ORA-40934: Cannot create JSON Relational Duality View 'STUDENT_OV': Invalid or conflicting annotations for the JSON field.
+        ORA-43411: Invalid directive 'checketag' for the table 'STUDENT'
+      */
     );
 
     await connection.execute(`
@@ -626,8 +662,12 @@ annotation or NOUPDATE annotation specified.*/
            {StudentClassId : scid,
             Class : class  {ClassId: clsid, Name: name}}}
     `),
-      /ORA-40934:/ /*ORA-40934: Cannot create JSON Relational Duality View 'STUDENT_OV': Invalid or
-                    conflicting annotations in the WITH clause */
+      // Server version < v26.1 will return ORA-40934
+      /ORA-40934|ORA-43411:/
+      /*
+        ORA-40934: Cannot create JSON Relational Duality View 'STUDENT_OV': Invalid or conflicting annotations for the JSON field.
+        ORA-43411: Invalid directive 'nest' for the table 'STUDENT'
+      */
     );
 
     await assert.rejects(
@@ -667,7 +707,7 @@ annotation or NOUPDATE annotation specified.*/
         Student @insert@update@delete
       {
         StudentId: stuid,
-        StudentName : student @nest{NULL:name} ,
+        StudentName : student @nest{NULL:name},
         StudentClass :
         student_class @insert@update@delete
            {StudentClassId : scid,

test/jsonDualityViews6.js

@@ -231,8 +231,12 @@ describe('277. jsonDualityView6.js', function() {
                 StudentId:stuid @INSERT
               }
           }`),
-        /ORA-40934:/ /*ORA-40934: Cannot create JSON Relational Duality View 'STUDENT_OV': Invalid or
-          conflicting annotations in the WITH clause.*/
+        // Server version < v26.1 will return ORA-40934
+        /ORA-40934|ORA-43411:/
+      /*
+        ORA-40934: Cannot create JSON Relational Duality View 'STUDENT_OV': Invalid or conflicting annotations for the JSON field.
+        ORA-43411: Invalid directive 'insert' for the table 'STUDENT'
+      */
       );
 
       await assert.rejects(
@@ -250,8 +254,12 @@ describe('277. jsonDualityView6.js', function() {
               StudentId:stuid
             }
           }`),
-        /ORA-40934:/ /*ORA-40934: Cannot create JSON Relational Duality View 'STUDENT_OV': Invalid or
-          conflicting annotations in the WITH clause.*/
+        // Server version < v26.1 will return ORA-40934
+        /ORA-40934|ORA-43411:/
+      /*
+        ORA-40934: Cannot create JSON Relational Duality View 'STUDENT_OV': Invalid or conflicting annotations for the JSON field.
+        ORA-43411: Invalid directive 'insert' for the table 'STUDENT'
+      */
       );
     });
 

test/list.txt

@@ -321,6 +321,7 @@ Overview of node-oracledb functional tests
         9.2.1 works for tables whose column names were created case sensitively
     9.3 Large number of columns
         9.3.1 works with a large number of columns
+        9.3.2 works with re-executes with multiple packet response
     9.4 single character column
         9.4.1 works with column names consisting of single characters
     9.5 duplicate column alias
@@ -5979,3 +5980,17 @@ oracledb.OUT_FORMAT_OBJECT and resultSet =  true
     307.1.3 getConnection behaviour with a custom instance disabling trace
     307.1.4 test getConnection fail behaviour with custom instance enabling trace
     307.1.5 test getConnection fail behaviour with custom instance disabling trace
+
+  308. Inband Notification
+    308.1 Standalone Connection
+      308.1.1 test standalone connection is marked unhealthy
+      308.1.2 test connection health after executing a long-running query
+      308.1.3 test connection health after a PL/SQL error
+      308.1.4 test connection health after setting session drainable multiple times
+      308.1.5 test connection health after ORA-00001 unique constraint error
+      308.1.6 test connection health after multiple drainable sessions in quick succession
+    308.2 Pooled Connection
+      308.2.1 test pooled connection that is marked unhealthy
+      308.2.2 test multiple connections in a pool with inband notifications
+      308.2.3 test connection reuse after marking unhealthy
+      308.2.4 test pool draining with multiple sessions

test/longDMLBind.js

@@ -105,7 +105,7 @@ describe('125. longDMLBind.js', function() {
       await test2(random.getRandomLengthString(65536), random.getRandomLengthString(size), size);
     });
 
-  }); // 125.3
+  }); // 125.2
 
   describe('125.3 RETURNING INTO', function() {
 
@@ -139,7 +139,7 @@ describe('125. longDMLBind.js', function() {
     };
     const result = await connection.execute(sql_query, bindVar);
     assert(result);
-    assert.equal(1, result.rowsAffected);
+    assert.equal(result.rowsAffected, 1);
   };
 
   const update = async function(content, maxsize) {
@@ -150,7 +150,7 @@ describe('125. longDMLBind.js', function() {
     };
     const result = await connection.execute(sql_query, bindVar);
     assert(result);
-    assert.equal(1, result.rowsAffected);
+    assert.equal(result.rowsAffected, 1);
   };
 
   const returning = async function(content) {

test/pool.js

@@ -1,4 +1,4 @@
-/* Copyright (c) 2015, 2023, Oracle and/or its affiliates. */
+/* Copyright (c) 2015, 2024, Oracle and/or its affiliates. */
 
 /******************************************************************************
  *
@@ -1505,7 +1505,14 @@ describe('2. pool.js', function() {
       }
 
       res = await conn.execute(sqlDriverName);
-      assert.strictEqual(res.rows[0][0], prePoolDriver);
+      /*
+        In Oracle 12.1 DB, The driver name (CLIENT_DRIVER column in V$SESSION_CONNECT_INFO view)
+        can be set only upto 8 characters.
+      */
+      const serverVersion = conn.oracleServerVersion;
+      if (serverVersion < 1202000000)
+        assert.strictEqual(res.rows[0][0], "pre_pool");
+      else assert.strictEqual(res.rows[0][0], prePoolDriver);
 
       await conn.close();
       await pool.close(0);

test/urowidDMLBindAsString2.js

@@ -1,4 +1,4 @@
-/* Copyright (c) 2017, 2023, Oracle and/or its affiliates. */
+/* Copyright (c) 2017, 2024, Oracle and/or its affiliates. */
 
 /******************************************************************************
  *
@@ -341,6 +341,9 @@ describe('115. urowidDMLBindAsString2.js', function() {
     } catch (err) {
       if (urowidLen > 4000) {
         assert.strictEqual(err.message, "ORA-01704: string literal too long");
+      } else {
+        // This is a test failure
+        throw err;
       }
     }
     if (urowidLen <= 4000) {