- Enhancement: Add @root filter selector

- npm: Bump to 1.2.0

Author: brettz9

CHANGES.md

@@ -1,5 +1,9 @@
 # CHANGES for jsonpath-plus
 
+## 1.2.0 (October 13, 2019)
+
+- Enhancement: Add `@root` filter selector
+
 ## 1.1.0 (September 26, 2019)
 
 - Enhancement: Add explicit 'any' to `evaluate()` declaration (for use

README.md

@@ -21,7 +21,7 @@ did not spell out.
         * `@other()` usable in conjunction with a user-defined `otherTypeCallback`
         * Non-JSON types that can nevertheless be used when querying
             non-JSON JavaScript objects (`@undefined()`, `@function()`, `@nonFinite()`)
-    * `@path`/`@parent`/`@property`/`@parentProperty` **shorthand selectors** within filters
+    * `@path`/`@parent`/`@property`/`@parentProperty`/`@root` **shorthand selectors** within filters
     * **Escaping**
         * `` ` `` for escaping remaining sequence
         * `@['...']`/`?@['...']` syntax for escaping special characters within
@@ -310,6 +310,7 @@ comparisons or to prevent ambiguity).
 //book/*\[position() != 0]    | $..book\[?(@property !== 0)] | Grabs all books whose property (which, being that we are reaching inside an array, is the numeric index) is not 0 | @property is not present in the original spec
 /store/\*/\*\[name(parent::*) != 'book'] | $.store.*\[?(@parentProperty !== "book")] | Grabs the grandchildren of store whose parent property is not book (i.e., bicycle's children, "color" and "price") | @parentProperty is not present in the original spec
 //book\[count(preceding-sibling::\*) != 0]/\*/text() | $..book.*\[?(@parentProperty !== 0)]  | Get the property values of all book instances whereby the parent property of these values (i.e., the array index holding the book item parent object) is not 0 | @parentProperty is not present in the original spec
+//book\[price = /store/book\[3]/price] | $..book\[?(@.price === @root.store.book\[2].price)] | Filter all books whose price equals the price of the third book | @root is not present in the original spec
 //book/../\*\[. instance of element(\*, xs:decimal)\] (in XPath 2.0) | $..book..\*@number() | Get the numeric values within the book array | @number(), the other basic types (@boolean(), @string()), other low-level derived types (@null(), @object(), @array()), the JSONSchema-added type, @integer(), the compound type @scalar() (which also accepts `undefined` and non-finite numbers for JavaScript objects as well as all of the basic non-object/non-function types), the type, @other(), to be used in conjunction with a user-defined callback (see `otherTypeCallback`) and the following non-JSON types that can nevertheless be used with JSONPath when querying non-JSON JavaScript objects (@undefined(), @function(), @nonFinite()) are not present in the original spec
 | | `` ` `` (e.g., `` `$`` to match a property literally named `$`) | Escapes the entire sequence following (to be treated as a literal) | `` ` `` is not present in the original spec; to get a literal backtick, use an additional backtick to escape
 

dist/index-es.js

@@ -817,6 +817,11 @@ JSONPath.prototype._eval = function (code, _v, _vname, path, parent, parentPropN
     code = code.replace(/@path/g, '_$_path');
   }
 
+  if (code.includes('@root')) {
+    this.currSandbox._$_root = this.json;
+    code = code.replace(/@root/g, '_$_root');
+  }
+
   if (code.match(/@([\t-\r \)\.\[\xA0\u1680\u2000-\u200A\u2028\u2029\u202F\u205F\u3000\uFEFF])/)) {
     this.currSandbox._$_v = _v;
     code = code.replace(/@([\t-\r \)\.\[\xA0\u1680\u2000-\u200A\u2028\u2029\u202F\u205F\u3000\uFEFF])/g, '_$_v$1');

dist/index-es.min.js

@@ -823,6 +823,11 @@
       code = code.replace(/@path/g, '_$_path');
     }
 
+    if (code.includes('@root')) {
+      this.currSandbox._$_root = this.json;
+      code = code.replace(/@root/g, '_$_root');
+    }
+
     if (code.match(/@([\t-\r \)\.\[\xA0\u1680\u2000-\u200A\u2028\u2029\u202F\u205F\u3000\uFEFF])/)) {
       this.currSandbox._$_v = _v;
       code = code.replace(/@([\t-\r \)\.\[\xA0\u1680\u2000-\u200A\u2028\u2029\u202F\u205F\u3000\uFEFF])/g, '_$_v$1');

dist/index-es.min.js.map

@@ -1,7 +1,7 @@
 {
   "author": "Stefan Goessner",
   "name": "jsonpath-plus",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "main": "dist/index-umd.js",
   "module": "dist/index-es.js",
   "types": "./src/jsonpath.d.ts",