Add root() method to Strophe.Builder. Fixes #214

CHANGELOG.md

@@ -8,6 +8,7 @@
   deprecated and will be removed in a future release.
 * #114 Add an error handler for HTTP calls
 * #213 "XHR open failed." in BOSH in IE9
+* #214 Add function to move Strophe.Builder pointer back to the root node
 
 ## Version 1.2.8 - 2016-09-16
 * #200 Fix for webpack

src/core.js

@@ -1076,6 +1076,21 @@ Strophe.Builder.prototype = {
         return this;
     },
 
+    /** Function: root
+     *  Make the root element the new current element.
+     *
+     *  When at a deeply nested element in the tree, this function can be used
+     *  to jump back to the root of the tree, instead of having to repeatedly
+     *  call up().
+     *
+     *  Returns:
+     *    The Stophe.Builder object.
+     */
+    root: function () {
+        this.node = this.nodeTree;
+        return this;
+    },
+
     /** Function: attrs
      *  Add or modify attributes of the current element.
      *

tests/tests.js

@@ -140,6 +140,12 @@ define([
 
 		module("Builder");
 
+        test("The root() method", function () {
+            var builder = new Strophe.Builder('root');
+            var el = builder.c('child').c('grandchild').c('greatgrandchild').root();
+            equal(el.node.nodeName, 'root', 'root() jump back to the root of the tree');
+        });
+
 		test("Correct namespace (#32)", function () {
 			var stanzas = [new Strophe.Builder("message", {foo: "asdf"}).tree(),
 						$build("iq", {}).tree(),