Mongo.getDB.txt

=============
Mongo.getDB()
=============

.. default-domain:: mongodb

.. contents:: On this page
   :local:
   :backlinks: none
   :depth: 1
   :class: singlecol

Description
-----------

.. method:: Mongo.getDB(<database>)

   Provides access to database objects from
   :binary:`~bin.mongosh` or from a JavaScript file.

   The :method:`Mongo.getDB()` method has the following parameter:


   .. list-table::
      :header-rows: 1
      :widths: 20 20 80
   
      * - Parameter
   
        - Type
   
        - Description
   
      * - ``database``
   
        - string
   
        - The name of the database to access.
                  
Compatibility
-------------

This method is available in deployments hosted in the following environments: 

.. include:: /includes/fact-environments-atlas-only.rst

.. include:: /includes/fact-environments-onprem-only.rst

Example
-------

The following example instantiates a new connection to the MongoDB
instance running on the localhost interface and returns a reference
to ``"myDatabase"``:

.. code-block:: javascript

   db = new Mongo().getDB("myDatabase");

.. seealso::

   :method:`Mongo()` and :doc:`/reference/method/connect`