Documentation update for the new getNetworkServiceNames() metjod and minor update for npmignore

Author: sharadraju

.npmignore

@@ -4,6 +4,7 @@
 .gitmodules
 .eslintrc
 .readthedocs.yaml
+.gitlab-ci.yml
 INSTALL.md
 CONTRIBUTING.md
 Makefile

doc/src/api_manual/oracledb.rst

@@ -3039,6 +3039,44 @@ Oracledb Methods
         * - Connection ``connection``
           - The newly created connection. If ``getConnection()`` fails, connection will be NULL. See :ref:`Connection class <connectionclass>` for more details.
 
+.. method:: oracledb.getNetworkServiceNames()
+
+    .. versionadded:: 6.7
+
+    .. code-block:: javascript
+
+        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
+    ``tnsnames.ora`` file does not exist, then an exception is raised.
+
+    The parameters of the ``oracledb.getNetworkServiceNames()`` method are:
+
+    .. _getnetworkservicenameattrs:
+
+    .. list-table-with-summary:: oracledb.getNetworkServiceNames() Parameters
+        :header-rows: 1
+        :class: wy-table-responsive
+        :align: center
+        :widths: 10 10 30
+        :summary: The first column displays the parameter. The second column
+         displays the data type of the parameter. The third column displays
+         the description of the parameter.
+
+        * - Parameter
+          - Data Type
+          - Description
+        * - ``configDir``
+          - String
+          - The directory in which the :ref:`tnsnames.ora <tnsadmin>` file resides.
+
+            If ``configDir`` is not specified, then the ``tnsnames.ora`` file is searched for in the directory specified in the ``TNS_ADMIN`` Oracle environment variable.
+
+    See :ref:`tnsnames`.
+
 .. method:: oracledb.getPool()
 
     .. code-block:: javascript

doc/src/user_guide/connection_handling.rst

@@ -237,6 +237,42 @@ dblatest&id=GUID-7F967CE5-5498-427C-9390-4A5C6767ADAA>`__.
         not be automatically located. The file's directory must be explicitly
         specified when connecting.
 
+You can retrieve the network service names that are defined in the
+:ref:`tnsnames.ora <tnsadmin>` file using
+:meth:`oracledb.getNetworkServiceNames()`. The directory that contains the
+``tnsnames.ora`` file can be specified in the ``configDir`` property of
+:meth:`~oracledb.getNetworkServiceNames()`. For example, if the
+``tnsnames.ora`` file is stored in the ``/opt/oracle/config`` directory and
+contains the following network service names::
+
+    sales =
+      (DESCRIPTION =
+        (ADDRESS = (PROTOCOL = TCP)(HOST = mymachine.example.com)(PORT = 1521))
+        (CONNECT_DATA =
+          (SERVER = DEDICATED)
+          (SERVICE_NAME = ORCL)
+        )
+      )
+
+    finance =
+      (DESCRIPTION =
+        (ADDRESS = (PROTOCOL = TCP)(HOST = mydbmachine.example.com)(PORT = 1521))
+        (CONNECT_DATA =
+          (SERVER = DEDICATED)
+          (SERVICE_NAME = ORCLPDB1)
+        )
+      )
+
+To retrieve the network service names from the above ``tnsnames.ora`` file,
+you can use:
+
+.. code-block:: javascript
+
+    const serviceNames = await oracledb.getNetworkServiceNames("/opt/oracle/config");
+    console.log(serviceNames);
+
+This prints ``['sales', 'finance']`` as the output.
+
 .. _notjdbc:
 
 JDBC and Oracle SQL Developer Connection Strings