Delete individual field feature #975

Author: EddyVerbruggen

demo-ng/app/tabs/firestore/firestore.component.html

@@ -10,6 +10,7 @@
     <Button text="Update" (tap)="firestoreUpdate()" class="button"></Button>
     <Button text="Get" (tap)="firestoreGet()" class="button"></Button>
     <Button text="Get nested" (tap)="firestoreGetNested()" class="button"></Button>
+    <Button text="deleteFields" (tap)="deleteFields()" class="button"></Button>
     <Button text="arrayUnion" (tap)="arrayUnion()" class="button"></Button>
     <Button text="arrayRemove" (tap)="arrayRemove()" class="button"></Button>
     <Button text="Document Observable (SF)" (tap)="firestoreDocumentObservable()" class="button"></Button>

demo-ng/app/tabs/firestore/firestore.component.ts

@@ -203,26 +203,53 @@ export class FirestoreComponent {
     });
   }
 
+  deleteFields(): void {
+    const faveDog = firebase.firestore().collection("dogs").doc("fave");
+
+    // let's first add the fields
+    faveDog.update(
+        {
+          field1ToDelete: "foo",
+          field2ToDelete: "bar",
+          updateTs: firebase.firestore().FieldValue().serverTimestamp()
+        })
+        .then(() => {
+          // and now remove them (added a timeout of 2s, so we can check the change in the Firebase console)
+          setTimeout(() => {
+            faveDog.update(
+                {
+                  last: "Updated From 'delete'",
+                  field1ToDelete: firestore.FieldValue.delete(),
+                  field2ToDelete: firestore.FieldValue.delete(),
+                  updateTs: firebase.firestore().FieldValue().serverTimestamp()
+                })
+                .then(() => console.log("Woofie updated from 'delete'"))
+                .catch(err => console.log("Updating Woofie from 'delete' failed, error: " + JSON.stringify(err)));
+          }, 2000);
+        });
+  }
+
   arrayUnion(): void {
     firebase.firestore().collection("dogs").doc("fave")
         .update({
-          last: "Updated From arrayUnion",
+          last: "Updated From 'arrayUnion'",
+          fieldToDelete: firestore.FieldValue.delete(),
           updateTs: firebase.firestore().FieldValue().serverTimestamp(),
           colors: firebase.firestore().FieldValue().arrayUnion(["red", "blue"])
         })
-        .then(() => console.log("Woofie updated from arrayUnion"))
-        .catch(err => console.log("Updating Woofie from arrayUnion failed, error: " + JSON.stringify(err)));
+        .then(() => console.log("Woofie updated from 'arrayUnion'"))
+        .catch(err => console.log("Updating Woofie from 'arrayUnion' failed, error: " + JSON.stringify(err)));
   }
 
   arrayRemove(): void {
     firebase.firestore().collection("dogs").doc("fave")
         .update({
-          last: "Updated From arrayRemove",
+          last: "Updated From 'arrayRemove'",
           updateTs: firebase.firestore().FieldValue().serverTimestamp(),
           colors: firebase.firestore().FieldValue().arrayRemove(["red"])
         })
-        .then(() => console.log("Woofie updated from arrayRemove"))
-        .catch(err => console.log("Updating Woofie from arrayRemove failed, error: " + JSON.stringify(err)));
+        .then(() => console.log("Woofie updated from 'arrayRemove'"))
+        .catch(err => console.log("Updating Woofie from 'arrayRemove' failed, error: " + JSON.stringify(err)));
   }
 
   firestoreDocumentObservable(): void {

demo-ng/package.json

@@ -25,7 +25,6 @@
     "nativescript-angular": "^6.1.0",
     "nativescript-camera": "^4.0.2",
     "nativescript-imagepicker": "~6.0.4",
-    "nativescript-plugin-firebase": "file:../publish/package/nativescript-plugin-firebase-7.1.6.tgz",
     "nativescript-theme-core": "~1.0.4",
     "reflect-metadata": "~0.1.10",
     "rxjs": "~6.0.0 || >=6.1.0",
@@ -43,4 +42,4 @@
     "nativescript-dev-webpack": "^0.15.1",
     "typescript": "~2.7.2"
   }
-}
+}

docs/FIRESTORE.md

@@ -218,6 +218,20 @@ query
     });
 ```
 
+### Deleting specific fields in a document
+To delete one or more fields in a document, do this (showing two flavors, use whatever you fancy):
+
+```typescript
+import { firestore } from "nativescript-plugin-firebase");
+const firebase = require("nativescript-plugin-firebase/app");
+
+firebase.firestore().collection("dogs").doc("fave")
+    .update({
+      field1ToDelete: firestore.FieldValue.delete(),
+      field2ToDelete: firebase.firestore().FieldValue().delete(),
+    });
+```
+
 ### Adding to (`arrayUnion`) and removing from (`arrayRemove`) Arrays
 If your document contains an array field, you can use `arrayUnion()` and `arrayRemove()` to add and remove elements.