DOCSP-27527 Remove callbacks (#493)

Author: jordan-smith721

source/code-snippets/transactions/txn-callback.js

@@ -1,8 +1,8 @@
-.. _node-promises-and-callbacks:
+.. _node-promises:
 
-======================
-Promises and Callbacks
-======================
+========
+Promises
+========
 
 .. default-domain:: mongodb
 
@@ -25,8 +25,7 @@ executing long-running operations. For more information about asynchronous
 Javascript, see the MDN web documentation on
 `Asynchronous Javascript <https://developer.mozilla.org/en-US/docs/Learn/JavaScript/Asynchronous>`_.
 
-This section describes two features of asynchronous Javascript --
-``Promises`` and ``Callbacks`` -- that you can use with the Node.js driver to
+This section describes ``Promises`` that you can use with the Node.js driver to
 access the results of your method calls to your MongoDB cluster.
 
 Promises
@@ -125,52 +124,6 @@ chaining example.
 For additional information, see the MDN documentation on
 :mdn:`await <Web/JavaScript/Reference/Operators/await>`.
 
-
-Callbacks (Deprecated)
-----------------------
-
-.. important::
-
-    Callbacks are deprecated in the {+driver-short+} version 4.10 and will
-    be removed in a future release. We recommend that you use Promises
-    or Async/Await instead.
-
-    If your application requires the use of callbacks, you can use the
-    {+node-legacy+}, which wraps the {+driver-short+} and provides
-    optional callback support.
-
-A callback is a method that gets called after another method has
-finished executing. This allows the enclosing method to continue to execute
-other commands until the original operation completes. Callbacks are often
-used to enforce the order of processing commands.
-
-In the MongoDB Node.js driver, you can optionally declare a callback method to
-async operations that normally return Promises. Once the operation completes
-execution, the callback method executes as shown in the following code
-snippet:
-
-.. code-block:: js
-
-   collection.findOneAndUpdate(
-     { name: "Barronette Peak" },
-     { $set: { name: "Baronette Peak" } },
-     {},
-     function(error, result) {
-       if (!error) {
-         console.log(`Operation completed successfully: ${result.ok}`);
-       } else {
-         console.log(`An error occurred: ${error}`);
-       }
-     },
-   );
-
-For more information on the callback method signature for the specific
-driver method, see the `API documentation <{+api+}>`__.
-
-.. note::
-
-    If you specify a callback, the method *does not* return a Promise.
-
 Operational Considerations
 --------------------------
 
@@ -248,9 +201,3 @@ in the following code:
        console.log(await cursor.next());
      }
    }
-
-.. note::
-
-   For additional information on using Promises and Callbacks with the MongoDB
-   Node.js driver, see this MongoDB University course video on `asynchronous
-   Javascript programming <https://youtu.be/R4AEyKehpss>`_.

source/fundamentals/promises.txt

@@ -64,10 +64,8 @@ MongoDB in the following sections of this guide:
 Transaction APIs
 ----------------
 
-To implement a transaction with the driver, you can use either the
-**Core API** or the **Callback API**. To use the Core API, you declare the
-start and commit points of the transaction. To use the Callback API, you pass
-a callback function that contains the logic you want to run as a transaction.
+Use the **Core API** to implement a transaction with the driver. To use the Core
+API, you declare the start and commit points of the transaction.
 
 Core API
 ~~~~~~~~
@@ -93,34 +91,6 @@ method on the ``Session`` object:
 See the :ref:`Core API example <nodejs-transaction-core-api-example>` for
 a sample transaction implementation.
 
-Callback API
-~~~~~~~~~~~~
-
-.. important::
-
-   The Callback API is deprecated in {+driver-short+} version 4.10 and will
-   be removed in a future release. We recommend that you use the
-   :ref:`Core API <nodejs-transaction-core-api-example>`.
-
-The Callback API enables you to run a transaction by passing a callback
-function that encapsulates the series of operations that make up the
-transaction. This API automatically handles certain transaction errors
-returned by the server.
-
-See
-:manual:`TransientTransactionError </core/transactions-in-applications/#std-label-transient-transaction-error>`
-and
-:manual:`UnknownTransactionCommitResult </core/transactions-in-applications/#-unknowntransactioncommitresult->`
-for more information on these errors.
-
-To create a transaction, pass a callback function that encapsulates your
-transaction logic to the ``withTransaction()`` method on a ``Session``
-object. The driver automatically retries the transaction when it encounters
-certain errors reported by the server.
-
-See the :ref:`Callback API example <nodejs-transaction-callback-api-example>`
-for a sample transaction implementation.
-
 .. _nodejs-transaction-settings:
 
 Transaction Settings
@@ -171,21 +141,6 @@ resembles the following:
    };
    session.startTransaction(transactionOptions);
 
-You can specify the transaction options in the Callback API using code that
-resembles the following:
-
-.. code-block:: javascript
-
-   const transactionOptions = {
-     readPreference: 'primary',
-     readConcern: { level: 'local' },
-     writeConcern: { w: 'majority' },
-     maxCommitTimeMS: 1000
-   };
-   await session.withTransaction(
-     async (session) => { /* your transaction here */ },
-     transactionOptions);
-
 .. _nodejs-transaction-examples:
 
 Examples
@@ -313,48 +268,6 @@ See the :ref:`Payment Transaction Result <nodejs-transaction-example-payment-res
 section to see what your collections should contain after you run the
 transaction.
 
-.. _nodejs-transaction-callback-api-example:
-
-Callback API Implementation
-~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-.. important::
-
-   The Callback API is deprecated in {+driver-short+} version 4.10 and will
-   be removed in a future release. We recommend that you use the
-   :ref:`Core API <nodejs-transaction-core-api-example>`.
-
-The code examples in this section show how you can use the Callback API to
-run the multi-document payment transaction in a session.
-
-The following code example shows how you can start the session and pass an
-anonymous callback function that contains the operations you want to run
-as a transaction.
-
-.. literalinclude:: /code-snippets/transactions/txn-callback.js
-   :language: javascript
-   :linenos:
-   :dedent:
-   :emphasize-lines: 1-6,8,10-12,16
-   :start-after: start session
-   :end-before: end session
-
-Rather than pass an anonymous callback function, you can pass a named
-function that returns a Promise. See the following ``placeOrder()``
-example callback function that you can pass to ``withTransaction()`` to run
-as a transaction:
-
-.. literalinclude:: /code-snippets/transactions/txn-callback.js
-   :language: javascript
-   :linenos:
-   :emphasize-lines: 9,22,33,41
-   :start-after: start callback
-   :end-before: end callback
-
-See the :ref:`Payment Transaction Result <nodejs-transaction-example-payment-result>`
-section to see what your collections should contain after you run the
-transaction.
-
 .. _nodejs-transaction-example-payment-result:
 
 Payment Transaction Result

source/fundamentals/transactions.txt

@@ -41,6 +41,18 @@ What's New in 5.0
 
 New features of the 5.0 {+driver-short+} release include:
 
+.. important:: Breaking Change: Removal of Callback Support
+
+   This release removes support for callbacks in favor of a promise-based API.
+   The following list provides some strategies for callback users to adopt this
+   version: 
+
+   - Migrate to the promise-based API (recommended)
+   - Use the promise-based API and ``util.callbackify``
+   - Add ``mongodb-legacy`` to continue using callbacks
+
+   For more information about these strategies, see the `v5 Change Notes <https://github.com/mongodb/node-mongodb-native/blob/main/etc/notes/CHANGES_5.0.0.md>`__.
+
 - By default, the driver no longer checks types referenced in dot notation
   unless the ``StrictFilter`` type annotation is explicitly
   used. To learn more about this change, see the :ref:`Typescript fundamentals