(DOCSP 17936) Replace One TS (#239)

Co-authored-by: Chris Bush <chris.bush@10gen.com>
Co-authored-by: Daria Pardue <81593090+dariakp@users.noreply.github.com>

Author: 3 people

source/code-snippets/usage-examples/replaceOne.js

@@ -14,35 +14,14 @@ async function run() {
     const movies = database.collection("movies");
 
     // create a query for a movie to update
-    const query = { title: "Blacksmith Scene" };
-    const options = {
-      // create a document if no documents match the query
-      upsert: true,
-    };
+    const query = { title: { $regex: "The Cat from" } };
     // create a new document that will be used to replace the existing document
     const replacement = {
-      title: "Sandcastles in the Sand",
-      plot:
-        "Robin Sparkles mourns for a relationship with a mall rat at an idyllic beach.",
+      title: `The Cat from Sector ${Math.floor(Math.random() * 1000) + 1}`,
     };
 
-    const result = await movies.replaceOne(query, replacement, options);
-
-    if (result.modifiedCount === 0 && result.upsertedCount === 0) {
-      console.log("No changes made to the collection.");
-    } else {
-      if (result.matchedCount === 1) {
-        console.log("Matched " + result.matchedCount + " documents.");
-      }
-      if (result.modifiedCount === 1) {
-        console.log("Updated one document.");
-      }
-      if (result.upsertedCount === 1) {
-        console.log(
-          "Inserted one new document with an _id of " + result.upsertedId._id
-        );
-      }
-    }
+    const result = await movies.replaceOne(query, replacement);
+    console.log(`Modified ${result.modifiedCount} document(s)`);
   } finally {
     await client.close();
   }

source/code-snippets/usage-examples/replaceOne.ts

@@ -0,0 +1,31 @@
+import { MongoClient } from "mongodb";
+
+// Replace the uri string with your MongoDB deployment's connection string.
+const uri =
+  "mongodb+srv://<user>:<password>@<cluster-url>?writeConcern=majority";
+
+const client = new MongoClient(uri);
+
+interface Movie {
+  title: string;
+}
+
+async function run() {
+  try {
+    await client.connect();
+
+    const database = client.db("sample_mflix");
+    const movies = database.collection<Movie>("movies");
+
+    const result = await movies.replaceOne(
+      { title: { $regex: "The Cat from" } },
+      {
+        title: `The Cat from Sector ${Math.floor(Math.random() * 1000) + 1}`,
+      }
+    );
+    console.log(`Modified ${result.modifiedCount} document(s)`);
+  } finally {
+    await client.close();
+  }
+}
+run().catch(console.dir);

source/usage-examples/replaceOne.txt

@@ -43,6 +43,25 @@ Example
 
 .. include:: /includes/connect-guide-note.rst
 
-.. literalinclude:: /code-snippets/usage-examples/replaceOne.js
-  :language: javascript
-  :linenos:
+.. tabs::
+
+  .. tab:: JavaScript
+     :tabid: javascript
+
+     .. literalinclude:: /code-snippets/usage-examples/replaceOne.js
+        :language: javascript
+        :linenos:
+
+  .. tab:: TypeScript
+     :tabid: typescript
+
+     .. literalinclude:: /code-snippets/usage-examples/replaceOne.ts
+        :language: typescript
+        :linenos:
+
+If you run the preceding example, you should see output that resembles the
+following:
+
+.. code-block:: none
+
+   Modified 1 document(s)