oracledb 6.8.0 → 6.10.0

package/lib/errors.js

@@ -175,6 +175,11 @@ const ERR_DB_FETCH_TYPE_HANDLER_CONVERTER = 166;
 const ERR_DB_FETCH_TYPE_HANDLER_RETURN_VALUE = 167;
 const ERR_ACCESS_TOKEN = 168;
 const ERR_CALLOUT_FN = 169;
+const ERR_SESSIONLESS_DIFFERING_METHODS = 170;
+const ERR_SESSIONLESS_ALREADY_ACTIVE = 171;
+const ERR_SESSIONLESS_INACTIVE = 172;
+const ERR_INVALID_SERVER_RESPONSE = 173;
+const ERR_PAYLOAD_CANNOT_BE_ENQUEUED = 174;
 
 // Oracle Net layer errors start from 500
 const ERR_CONNECTION_CLOSED = 500;
@@ -198,19 +203,15 @@ const ERR_INVALID_SERVICE_NAME = 518;
 const ERR_INVALID_SID = 519;
 const ERR_TNS_NAMES_FILE_MISSING = 520;
 const ERR_CONNECTION_EOF = 521;
-const ERR_AZURE_CONFIG_PROVIDER_AUTH_FAILED = 522;
 const ERR_CONFIG_PROVIDER_FAILED_TO_RETRIEVE_CONFIG = 523;
-const ERR_CONFIG_PROVIDER_NOT_SUPPORTED = 524;
-const ERR_CONFIG_PROVIDER_LOAD_FAILED = 525;
-const ERR_OCIOBJECT_CONFIG_PROVIDER_AUTH_FAILED = 526;
-const ERR_AZURE_VAULT_AUTH_FAILED = 527;
-const ERR_AZURE_SERVICE_PRINCIPAL_AUTH_FAILED = 528;
+const ERR_REGISTER_HOOKFN_CONFIGPROVIDER = 524;
 const ERR_WALLET_TYPE_NOT_SUPPORTED = 529;
 const ERR_HOST_NOT_FOUND = 530;
 const ERR_ANO_PACKET = 531;
 const ERR_ANO_STATUS = 532;
 const ERR_ANO_NEGOTIATION = 533;
 const ERR_DATA_COMPRESSION = 534;
+const ERR_CONFIG_PROVIDER_PARAM_TYPE = 535;
 
 // Oracle SUCCESS_WITH_INFO warning start from 700
 const WRN_COMPILATION_CREATE = 700;
@@ -228,11 +229,40 @@ adjustErrorXref.set("DPI-1080", ERR_CONNECTION_CLOSED);
 adjustErrorXref.set("OCI-22303", [ERR_INVALID_OBJECT_TYPE_NAME, 'type "([^"]*"."[^"]*)"']);
 adjustErrorXref.set("OCI-22164", ERR_DELETE_ELEMENTS_OF_VARRAY);
 adjustErrorXref.set("OCI-22165", [ERR_INVALID_COLL_INDEX_SET, /index \[([0-9]+)\] must be in the range of \[([0-9]+)\] to \[([0-9]+)\]/]);
+adjustErrorXref.set("ORA-00022", ERR_CONNECTION_CLOSED);
 adjustErrorXref.set("ORA-00028", ERR_CONNECTION_CLOSED);
+adjustErrorXref.set("ORA-00031", ERR_CONNECTION_CLOSED);
+adjustErrorXref.set("ORA-00045", ERR_CONNECTION_CLOSED);
+adjustErrorXref.set("ORA-00378", ERR_CONNECTION_CLOSED);
 adjustErrorXref.set("ORA-00600", ERR_CONNECTION_CLOSED);
+adjustErrorXref.set("ORA-00602", ERR_CONNECTION_CLOSED);
+adjustErrorXref.set("ORA-00603", ERR_CONNECTION_CLOSED);
+adjustErrorXref.set("ORA-00609", ERR_CONNECTION_CLOSED);
+adjustErrorXref.set("ORA-01012", ERR_CONNECTION_CLOSED);
+adjustErrorXref.set("ORA-01041", ERR_CONNECTION_CLOSED);
+adjustErrorXref.set("ORA-01043", ERR_CONNECTION_CLOSED);
+adjustErrorXref.set("ORA-01089", ERR_CONNECTION_CLOSED);
+adjustErrorXref.set("ORA-01092", ERR_CONNECTION_CLOSED);
+adjustErrorXref.set("ORA-02396", ERR_CONNECTION_CLOSED);
+adjustErrorXref.set("ORA-03113", ERR_CONNECTION_CLOSED);
+adjustErrorXref.set("ORA-03114", ERR_CONNECTION_CLOSED);
+adjustErrorXref.set("ORA-03122", ERR_CONNECTION_CLOSED);
+adjustErrorXref.set("ORA-03135", ERR_CONNECTION_CLOSED);
+adjustErrorXref.set("ORA-12153", ERR_CONNECTION_CLOSED);
+adjustErrorXref.set("ORA-12537", ERR_CONNECTION_CLOSED);
+adjustErrorXref.set("ORA-12547", ERR_CONNECTION_CLOSED);
+adjustErrorXref.set("ORA-12570", ERR_CONNECTION_CLOSED);
+adjustErrorXref.set("ORA-12583", ERR_CONNECTION_CLOSED);
+adjustErrorXref.set("ORA-27146", ERR_CONNECTION_CLOSED);
+adjustErrorXref.set("ORA-28511", ERR_CONNECTION_CLOSED);
+adjustErrorXref.set("ORA-56600", ERR_CONNECTION_CLOSED);
 adjustErrorXref.set("ORA-24338", ERR_INVALID_REF_CURSOR);
 adjustErrorXref.set("ORA-25708", ERR_TOKEN_HAS_EXPIRED);
 adjustErrorXref.set("ORA-24344", WRN_COMPILATION_CREATE);
+adjustErrorXref.set("ORA-26202", ERR_SESSIONLESS_INACTIVE);
+adjustErrorXref.set("ORA-26211", ERR_SESSIONLESS_DIFFERING_METHODS);
+adjustErrorXref.set("ORA-26216", ERR_SESSIONLESS_ALREADY_ACTIVE);
+adjustErrorXref.set("DPI-1071", ERR_PAYLOAD_CANNOT_BE_ENQUEUED);
 
 // define mapping for error messages
 const messages = new Map();
@@ -247,7 +277,7 @@ messages.set(ERR_INVALID_PARAMETER_VALUE,               // NJS-005
 messages.set(ERR_INVALID_PROPERTY_VALUE_IN_PARAM,       // NJS-007
   'invalid value for "%s" in parameter %d');
 messages.set(ERR_INVALID_NUMBER_OF_PARAMETERS,          // NJS-009
-  'invalid number of parameters');
+  'invalid number of function parameters: %d provided but expected between %d and %d');
 // used in C -- keep synchronized!
 messages.set(ERR_UNSUPPORTED_DATA_TYPE,                 // NJS-010
   'unsupported data type %d in column %d');
@@ -371,9 +401,9 @@ messages.set(ERR_EXEC_MODE_ONLY_FOR_DML,                // NJS-095
 messages.set(ERR_INVALID_BIND_NAME,                     // NJS-097
   'no bind placeholder named ":%s" was found in the statement text');
 messages.set(ERR_WRONG_NUMBER_OF_BINDS,                 // NJS-098
-  '%s bind placeholders were used in the SQL statement but %s bind values were provided');
+  '%d bind placeholders were used in the SQL statement but %d bind values were provided');
 messages.set(ERR_BUFFER_LENGTH_INSUFFICIENT,            // NJS-099
-  'internal error: buffer of length %s insufficient to hold %s bytes');
+  'internal error: buffer of length %d insufficient to hold %d bytes');
 messages.set(ERR_NCHAR_CS_NOT_SUPPORTED,                // NJS-100
   'national character set id %d is not supported by node-oracledb in Thin mode');
 messages.set(ERR_MISSING_CREDENTIALS,                   // NJS-101
@@ -473,7 +503,7 @@ messages.set(ERR_INVALID_TPC_END_FLAGS,                 // NJS-151
 messages.set(ERR_UNKNOWN_TRANSACTION_STATE,             // NJS-152
   'internal error: unknown transaction state {state} in Two Phase Commit');
 messages.set(ERR_INVALID_TRANSACTION_SIZE,              // NJS-153
-  'size of the transaction ID is %d and cannot exceed 64');
+  'size of the transaction ID must be non-zero and must not exceed 64. Its current size is %d.');
 messages.set(ERR_INVALID_BRANCH_SIZE,                   // NJS-154
   'size of the branch ID is %d and cannot exceed 64');
 messages.set(ERR_OPERATION_NOT_SUPPORTED_ON_BFILE,      // NJS-155
@@ -498,19 +528,30 @@ messages.set(ERR_VECTOR_SPARSE_INVALID_INPUT,           // NJS-164
   'SPARSE VECTOR Invalid Input Data');
 messages.set(ERR_VECTOR_SPARSE_INDICES_ELEM_IS_NOT_VALID,    // NJS-165
   'SPARSE VECTOR indices element at index %d is not valid');
-messages.set(ERR_DB_FETCH_TYPE_HANDLER_CONVERTER,          // NJS-166
+messages.set(ERR_DB_FETCH_TYPE_HANDLER_CONVERTER,       // NJS-166
   'DBFetchTypeHandler return value attribute "converter" must be a function');
-messages.set(ERR_DB_FETCH_TYPE_HANDLER_RETURN_VALUE,       // NJS-167
+messages.set(ERR_DB_FETCH_TYPE_HANDLER_RETURN_VALUE,    // NJS-167
   'DBFetchTypeHandler return value must be an object');
 messages.set(ERR_ACCESS_TOKEN,                          // NJS-168
   'access token function failed.');
-messages.set(ERR_CALLOUT_FN,                         // NJS-169
+messages.set(ERR_CALLOUT_FN,                            // NJS-169
   'External function call failed.');
+messages.set(ERR_SESSIONLESS_DIFFERING_METHODS,         //NJS-170
+  'Different ways to start or suspend sessionless transactions are being used(server procedures and client APIs)');
+messages.set(ERR_SESSIONLESS_ALREADY_ACTIVE,            //NJS-171
+  'Suspend, commit or rollback the currently active sessionless transaction before beginning or resuming another one.');
+messages.set(ERR_SESSIONLESS_INACTIVE,                  //NJS-172
+  'No sessionless transaction is active');
+messages.set(ERR_INVALID_SERVER_RESPONSE,               //NJS-173
+  'Invalid server response to connection request');
+messages.set(ERR_PAYLOAD_CANNOT_BE_ENQUEUED,            // NJS-174
+  "Payload cannot be enqueued since it does not match the payload type supported by the queue");
+
 
 // Oracle Net layer errors
 
 messages.set(ERR_CONNECTION_CLOSED,                     // NJS-500
-  'connection to the Oracle Database was broken');
+  'connection to Oracle Database was closed or broken');
 messages.set(ERR_CONNECTION_LOSTCONTACT,                // NJS-501
   'connection to host %s port %d terminated unexpectedly. (CONNECTION_ID=%s)\n%s');
 messages.set(ERR_CONNECTION_INCOMPLETE,                 // NJS-503
@@ -551,20 +592,10 @@ messages.set(ERR_TNS_NAMES_FILE_MISSING,                // NJS-520
   'cannot connect to Oracle Database. File tnsnames.ora not found in %s');
 messages.set(ERR_CONNECTION_EOF,                        // NJS-521
   'connection to host %s port %d received end-of-file on communication channel. (CONNECTION_ID=%s)');
-messages.set(ERR_AZURE_CONFIG_PROVIDER_AUTH_FAILED,     // NJS-522
-  'Azure Authentication Failed: The authentication parameter value %s may be incorrect');
 messages.set(ERR_CONFIG_PROVIDER_FAILED_TO_RETRIEVE_CONFIG,   // NJS-523
   'Failed to retrieve configuration from Centralized Configuration Provider:\n %s');
-messages.set(ERR_CONFIG_PROVIDER_NOT_SUPPORTED,         // NJS-524
-  'Configuration Provider not supported: %s');
-messages.set(ERR_CONFIG_PROVIDER_LOAD_FAILED,           // NJS-525
-  'Centralized Config Provider failed to load required libraries. Please install the required libraries.\n %s');
-messages.set(ERR_OCIOBJECT_CONFIG_PROVIDER_AUTH_FAILED, // NJS-526
-  'OCI authentication failed: The authentication parameter value %s may be incorrect');
-messages.set(ERR_AZURE_VAULT_AUTH_FAILED,               // NJS-527
-  'Azure Vault: Provide correct Azure Vault authentication details');
-messages.set(ERR_AZURE_SERVICE_PRINCIPAL_AUTH_FAILED,   // NJS-528
-  'Azure service principal authentication requires either a client certificate path or a client secret string');
+messages.set(ERR_REGISTER_HOOKFN_CONFIGPROVIDER,         // NJS-524
+  '%s Configuration provider plugin not registered. Please register the hook function for the same');
 messages.set(ERR_WALLET_TYPE_NOT_SUPPORTED,             // NJS-529
   'Invalid wallet content format. Supported format is PEM');
 messages.set(ERR_HOST_NOT_FOUND,                        // NJS-530
@@ -577,6 +608,8 @@ messages.set(ERR_ANO_NEGOTIATION,                       // NJS-533
   'Advanced Networking Option service negotiation failed. Native Network Encryption and DataIntegrity only supported in node-oracledb thick mode.\nCause: ORA-%s');
 messages.set(ERR_DATA_COMPRESSION, 'Error during data compression/decompression: %s\n'); //NJS-534
 // Oracle SUCCESS_WITH_INFO warning
+messages.set(ERR_CONFIG_PROVIDER_PARAM_TYPE,               // NJS-535
+  'Parameter does not have a valid type: %s\n');
 messages.set(WRN_COMPILATION_CREATE,                    // NJS-700
   'creation succeeded with compilation errors');
 
@@ -601,7 +634,7 @@ function assert(condition) {
 //-----------------------------------------------------------------------------
 function assertArgCount(args, minArgCount, maxArgCount) {
   assert(args.length >= minArgCount && args.length <= maxArgCount,
-    ERR_INVALID_NUMBER_OF_PARAMETERS);
+    ERR_INVALID_NUMBER_OF_PARAMETERS, args.length, minArgCount, maxArgCount);
 }
 
 //-----------------------------------------------------------------------------
@@ -645,8 +678,8 @@ function assertParamPropInt(obj, parameterNum, propName) {
 //-----------------------------------------------------------------------------
 // assertParamPropUnsignedInt()
 //
-// Asserts that the property value of a parameter is a positive integer value
-// (or undefined).
+// Asserts that the property value of a parameter is a non-negative integer
+// value (or undefined).
 //-----------------------------------------------------------------------------
 function assertParamPropUnsignedInt(obj, parameterNum, propName) {
   if (obj[propName] !== undefined) {
@@ -728,6 +761,7 @@ function getErr(errorNum) {
   args[0] = `${code}: ${baseText}`;
   const err = new Error(util.format(...args));
   err.code = code;
+  err.isRecoverable = (errorNum === ERR_CONNECTION_CLOSED);
   Error.captureStackTrace(err, getErr);
   return err;
 }
@@ -904,13 +938,9 @@ module.exports = {
   ERR_NO_CONFIG_DIR,
   ERR_TNS_ENTRY_NOT_FOUND,
   ERR_CONNECTION_EOF,
-  ERR_AZURE_CONFIG_PROVIDER_AUTH_FAILED,
-  ERR_OCIOBJECT_CONFIG_PROVIDER_AUTH_FAILED,
-  ERR_AZURE_VAULT_AUTH_FAILED,
-  ERR_AZURE_SERVICE_PRINCIPAL_AUTH_FAILED,
   ERR_CONFIG_PROVIDER_FAILED_TO_RETRIEVE_CONFIG,
-  ERR_CONFIG_PROVIDER_NOT_SUPPORTED,
-  ERR_CONFIG_PROVIDER_LOAD_FAILED,
+  ERR_CONFIG_PROVIDER_PARAM_TYPE,
+  ERR_REGISTER_HOOKFN_CONFIGPROVIDER,
   ERR_DATA_COMPRESSION,
   ERR_WALLET_TYPE_NOT_SUPPORTED,
   ERR_HOST_NOT_FOUND,
@@ -974,6 +1004,11 @@ module.exports = {
   ERR_UNKNOWN_TRANSACTION_STATE,
   ERR_INVALID_TRANSACTION_SIZE,
   ERR_INVALID_BRANCH_SIZE,
+  ERR_SESSIONLESS_DIFFERING_METHODS,
+  ERR_SESSIONLESS_ALREADY_ACTIVE,
+  ERR_SESSIONLESS_INACTIVE,
+  ERR_INVALID_SERVER_RESPONSE,
+  ERR_PAYLOAD_CANNOT_BE_ENQUEUED,
   ERR_CONNECTION_CLOSED_CODE: `${ERR_PREFIX}-${ERR_CONNECTION_CLOSED}`,
   ERR_OPERATION_NOT_SUPPORTED_ON_BFILE,
   ERR_OPERATION_ONLY_SUPPORTED_ON_BFILE,

package/lib/impl/aqDeqOptions.js

@@ -1,4 +1,4 @@
-// Copyright (c) 2022, Oracle and/or its affiliates.
+// Copyright (c) 2022, 2025, Oracle and/or its affiliates.
 
 //-----------------------------------------------------------------------------
 //
@@ -138,6 +138,15 @@ class AqDeqOptionsImpl {
     errors.throwNotImplemented("setting correlation (dequeue options)");
   }
 
+  //---------------------------------------------------------------------------
+  // setDeliveryMode()
+  //
+  // Sets the delivery mode to use for dequeuing messages.
+  //---------------------------------------------------------------------------
+  setDeliveryMode() {
+    errors.throwNotImplemented("setting deliveryMode (dequeue options)");
+  }
+
   //---------------------------------------------------------------------------
   // setMode()
   //

package/lib/impl/connection.js

@@ -289,6 +289,15 @@ class ConnectionImpl {
     errors.throwNotImplemented("getting the internal name");
   }
 
+  //---------------------------------------------------------------------------
+  // getLTXID()
+  //
+  // Returns the the logical transaction ID for database transactions.
+  //---------------------------------------------------------------------------
+  getLTXID() {
+    errors.throwNotImplemented("getting the logical transaction id");
+  }
+
   //---------------------------------------------------------------------------
   // getMaxIdentifierLength()
   //

package/lib/impl/datahandlers/buffer.js

@@ -397,6 +397,18 @@ class BaseBuffer {
     return buf;
   }
 
+  //---------------------------------------------------------------------------
+  // readBytesAndLength()
+  //
+  // Reads the UB4 length from the buffer and then returns a Buffer containing
+  // the specified number of bytes.
+  //---------------------------------------------------------------------------
+  readBytesAndLength() {
+    const numBytes = this.readUB4();
+    if (numBytes > 0)
+      return this.readBytesWithLength();
+  }
+
   //---------------------------------------------------------------------------
   // readBytesWithLength()
   //
@@ -548,6 +560,17 @@ class BaseBuffer {
     return Buffer.from(buf).swap16().toString('utf16le');
   }
 
+  //---------------------------------------------------------------------------
+  // readStrAndLength()
+  //
+  // Reads a length from the buffer and then, if the length is non-zero, reads
+  // string from the buffer and returns it.
+  //---------------------------------------------------------------------------
+  readStrAndLength() {
+    const buf = this.readBytesAndLength();
+    return buf ? buf.toString() : null;
+  }
+
   //---------------------------------------------------------------------------
   // readUB2()
   //
@@ -997,6 +1020,32 @@ class BaseBuffer {
     this.buf.writeInt32BE(n, pos);
   }
 
+  //---------------------------------------------------------------------------
+  // writeSB4()
+  //
+  // Writes a signed integer (up to 4 bytes in length) in variable length
+  // format to the buffer.
+  //---------------------------------------------------------------------------
+  writeSB4(value) {
+    let sign = 0;
+    if (value < 0) {
+      value = -value;
+      sign = 0x80;
+    }
+    if (value === 0) {
+      this.writeUInt8(0);
+    } else if (value <= 0xff) {
+      this.writeUInt8(1 | sign);
+      this.writeUInt8(value);
+    } else if (value <= 0xffff) {
+      this.writeUInt8(2 | sign);
+      this.writeUInt16BE(value);
+    } else {
+      this.writeUInt8(4 | sign);
+      this.writeUInt32BE(value);
+    }
+  }
+
   //---------------------------------------------------------------------------
   // writeUB4()
   //

package/lib/impl/datahandlers/oson.js

@@ -549,8 +549,13 @@ class OsonTreeSegment extends GrowableBuffer {
 
     // handle numbers
     } else if (typeof value === 'number') {
-      this.writeUInt8(constants.TNS_JSON_TYPE_NUMBER_LENGTH_UINT8);
-      this.writeOracleNumber(value.toString());
+      if (Number.isNaN(value)) {
+        this.writeUInt8(constants.TNS_JSON_TYPE_BINARY_DOUBLE);
+        this.writeBinaryDouble(value);
+      } else {
+        this.writeUInt8(constants.TNS_JSON_TYPE_NUMBER_LENGTH_UINT8);
+        this.writeOracleNumber(value.toString());
+      }
 
     // handle strings
     } else if (typeof value === 'string') {

package/lib/impl/pool.js

@@ -1,4 +1,4 @@
-// Copyright (c) 2022, Oracle and/or its affiliates.
+// Copyright (c) 2022, 2025, Oracle and/or its affiliates.
 
 //-----------------------------------------------------------------------------
 //
@@ -165,6 +165,15 @@ class PoolImpl {
     errors.throwNotImplemented("getting the pool timeout");
   }
 
+  //---------------------------------------------------------------------------
+  // getMaxLifetimeSession()
+  //
+  // Returns the pool max lifetime for a session.
+  //---------------------------------------------------------------------------
+  getMaxLifetimeSession() {
+    errors.throwNotImplemented("getting the pool max lifetime");
+  }
+
   //---------------------------------------------------------------------------
   // getStmtCacheSize()
   //

package/lib/impl/resultset.js

@@ -1,4 +1,4 @@
-// Copyright (c) 2022, 2023, Oracle and/or its affiliates.
+// Copyright (c) 2022, 2025, Oracle and/or its affiliates.
 
 //-----------------------------------------------------------------------------
 //
@@ -43,8 +43,9 @@ class ResultSetImpl extends BaseImpl {
   // _determineFetchType()
   //
   // Determine the fetch type to use for the specified metadata.
+  // Param rowsetMetaData includes metadata of all the columns fetched.
   //---------------------------------------------------------------------------
-  _determineFetchType(metadata, options) {
+  _determineFetchType(metadata, options, rowsetMetaData) {
 
     // clear any previous fetch type and converter functions that may have been
     // retained
@@ -54,7 +55,7 @@ class ResultSetImpl extends BaseImpl {
     // if a fetch type handler is specified, call it; if no value (undefined)
     // is returned, the normal processing takes place
     if (options.fetchTypeHandler) {
-      const result = options.fetchTypeHandler(metadata);
+      const result = options.fetchTypeHandler(metadata, rowsetMetaData);
       if (result !== undefined) {
         errors.assert(typeof result === 'object',
           errors.ERR_FETCH_TYPE_HANDLER_RETURN_VALUE);
@@ -232,7 +233,7 @@ class ResultSetImpl extends BaseImpl {
         info.dbTypeClass = cls;
       }
       nodbUtil.addTypeProperties(info, "dbType");
-      this._determineFetchType(info, options);
+      this._determineFetchType(info, options, metaData);
       if (info.fetchType === types.DB_TYPE_CURSOR) {
         this.nestedCursorIndices.push(i);
       } else if (info.fetchType === types.DB_TYPE_CLOB ||

package/lib/impl/sodaDocument.js

@@ -1,4 +1,4 @@
-// Copyright (c) 2022, 2023, Oracle and/or its affiliates.
+// Copyright (c) 2022, 2025, Oracle and/or its affiliates.
 
 //-----------------------------------------------------------------------------
 //
@@ -31,21 +31,12 @@ const errors = require('../errors.js');
 class SodaDocumentImpl {
 
   //---------------------------------------------------------------------------
-  // getContentAsBuffer()
+  // getContent()
   //
-  // Returns the document content as a Buffer object.
+  // Returns the document content.
   //---------------------------------------------------------------------------
-  getContentAsBuffer() {
-    errors.throwNotImplemented("getting doc content as a buffer");
-  }
-
-  //---------------------------------------------------------------------------
-  // getContentAsString()
-  //
-  // Returns the document content as a string.
-  //---------------------------------------------------------------------------
-  getContentAsString() {
-    errors.throwNotImplemented("getting doc content as a string");
+  getContent() {
+    errors.throwNotImplemented("getting doc content");
   }
 
   //---------------------------------------------------------------------------

package/lib/lob.js

@@ -1,4 +1,4 @@
-// Copyright (c) 2016, 2024, Oracle and/or its affiliates.
+// Copyright (c) 2016, 2025, Oracle and/or its affiliates.
 
 //-----------------------------------------------------------------------------
 //
@@ -246,6 +246,14 @@ class Lob extends Duplex {
     this._checkIsBfile();
     errors.assertArgCount(arguments, 1, 1);
     errors.assertParamValue(nodbUtil.isObject(a1), 1);
+    errors.assertParamValue(Object.hasOwn(a1, "dirName"), 1);
+    errors.assertParamValue(Object.hasOwn(a1, "fileName"), 1);
+    errors.assertPropValue(
+      a1.dirName != "" && a1.dirName != null, "dirName"
+    );
+    errors.assertPropValue(
+      a1.fileName != "" && a1.fileName != null, "fileName"
+    );
     this._impl.setDirFileName(a1);
   }