diff -r 000000000000 -r 6474c204b198 toolkit/components/places/tests/unit/test_utils_setAnnotationsFor.js
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/toolkit/components/places/tests/unit/test_utils_setAnnotationsFor.js	Wed Dec 31 06:09:35 2014 +0100
@@ -0,0 +1,79 @@
+/* -*- Mode: Java; tab-width: 2; indent-tabs-mode: nil; c-basic-offset: 2 -*- */
+/* vim:set ts=2 sw=2 sts=2 et: */
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/. */
+
+ /**
+  * Check for correct functionality of PlacesUtils.setAnnotationsForItem/URI
+  */
+
+var hs = PlacesUtils.history;
+var bs = PlacesUtils.bookmarks;
+var as = PlacesUtils.annotations;
+
+const TEST_URL = "http://test.mozilla.org/";
+
+function run_test() {
+  var testURI = uri(TEST_URL);
+  // add a bookmark
+  var itemId = bs.insertBookmark(bs.unfiledBookmarksFolder, testURI,
+                                 bs.DEFAULT_INDEX, "test");
+
+  // create annotations array
+  var testAnnos = [{ name: "testAnno/test0",
+                     flags: 0,
+                     value: "test0",
+                     expires: Ci.nsIAnnotationService.EXPIRE_NEVER },
+                   { name: "testAnno/test1",
+                     flags: 0,
+                     value: "test1",
+                     expires: Ci.nsIAnnotationService.EXPIRE_NEVER },
+                   { name: "testAnno/test2",
+                     flags: 0,
+                     value: "test2",
+                     expires: Ci.nsIAnnotationService.EXPIRE_NEVER },
+                   { name: "testAnno/test3",
+                     flags: 0,
+                     value: 0,
+                     expires: Ci.nsIAnnotationService.EXPIRE_NEVER }];
+
+  // Add item annotations
+  PlacesUtils.setAnnotationsForItem(itemId, testAnnos);
+  // Check for correct addition
+  testAnnos.forEach(function(anno) {
+    do_check_true(as.itemHasAnnotation(itemId, anno.name));
+    do_check_eq(as.getItemAnnotation(itemId, anno.name), anno.value);
+  });
+
+  // Add page annotations
+  PlacesUtils.setAnnotationsForURI(testURI, testAnnos);
+  // Check for correct addition
+  testAnnos.forEach(function(anno) {
+    do_check_true(as.pageHasAnnotation(testURI, anno.name));
+    do_check_eq(as.getPageAnnotation(testURI, anno.name), anno.value);
+  });
+
+  // To unset annotations we unset their values or set them to
+  //null/undefined
+  testAnnos[0].value = null;
+  testAnnos[1].value = undefined;
+  delete testAnnos[2].value;
+  delete testAnnos[3].value;
+
+  // Unset all item annotations
+  PlacesUtils.setAnnotationsForItem(itemId, testAnnos);
+  // Check for correct removal
+  testAnnos.forEach(function(anno) {
+    do_check_false(as.itemHasAnnotation(itemId, anno.name));
+    // sanity: page annotations should not be removed here
+    do_check_true(as.pageHasAnnotation(testURI, anno.name));
+  });
+
+  // Unset all page annotations
+  PlacesUtils.setAnnotationsForURI(testURI, testAnnos);
+  // Check for correct removal
+  testAnnos.forEach(function(anno) {
+    do_check_false(as.pageHasAnnotation(testURI, anno.name));
+  });
+}