DOCSP-46884 Abort signal support (#979)

Author: stephmarie17

source/code-snippets/crud/cursor.js

@@ -68,6 +68,28 @@ async function close(myColl) {
   await cursor.close();
   // end close cursor example
 }
+// Abort in-progress operations
+async function abort(myColl) {
+  // start abort cursor example
+  const controller = new AbortController();
+  const { signal } = controller;
+
+  process.on('SIGINT', () => controller.abort(new Error('^C pressed')));
+
+  try {
+    const cursor = myColl.find({}, { signal });
+    for await (const doc of cursor) {
+      console.log(doc);
+    }
+  } catch (error) {
+    if (error === signal.reason) {
+      console.error('Operation aborted:', error);
+    } else {
+      console.error('Unexpected error:', error);
+    }
+  }
+  // end abort cursor example
+}
 
 async function run() {
   try {
@@ -81,6 +103,7 @@ async function run() {
     await fetchAll(orders);
     await rewind(orders);
     await count(orders);
+    await abort(orders);
   } finally {
     await client.close();
   }

source/fundamentals/crud/read-operations/cursor.txt

@@ -165,3 +165,36 @@ and the {+mdb-server+}:
    :language: javascript
    :start-after: start close cursor example
    :end-before: end close cursor example
+
+Abort
+~~~~~
+
+You can cancel cursor operations by using an `abort signal
+<{+api+}/types/Abortable.html>`__.  This can help you manage your resources by
+releasing memory and network resources used by the cursor if they're no longer
+needed.
+
+.. note::
+   
+   This feature is experimental. Aborting a signal closes a connection, which 
+   might cause unnecessary connection reestablishment.
+
+You can pass the ``signal`` command to the following methods:
+
+- ``collection.find()``
+- ``collection.findOne()``
+- ``collection.aggregate()``
+- ``collection.countDocuments()``
+- ``db.listCollections()``
+- ``db.command()``
+
+To use an abort signal, create an ``AbortController`` instance and extract the
+``signal`` from the controller. In this code example, the process listens for a
+``SIGINT`` (``Ctrl+C``) to trigger the ``abort()`` method. You can pass the
+``signal`` option to the ``find()`` method to abort the cursor operation if the
+signal triggers, as shown in the following example:
+
+.. literalinclude:: /code-snippets/crud/cursor.js
+   :language: javascript
+   :start-after: start abort cursor example
+   :end-before: end abort cursor example