Merge pull request #37 from pactumjs/expectjsonlength-enhancement

feat: expectJsonLength enhancement docs

docs/api/assertions/expectJsonLength.md

@@ -14,8 +14,11 @@ Asserts on the length of JSON array objects.
 ```js
 expectJsonLength(length)
 expectJsonLength(path, length)
+expectJsonLength(path, matcher)  // Supports assertions with matcher functions
 ```
 
+* Allowed matcher functions `lt`, `gt`, `lte`, `gte`, `notEquals` from `>=v3.5.1`
+
 ## Usage
 
 ### ✅  Correct Usage
@@ -26,6 +29,12 @@ await spec()
   .expectJsonLength(1);
 ```
 
+```js
+const { lte } = require("pactum-matchers");
+await spec()
+  .get('/api/users')
+  .expectJsonLength('data', lte(6));
+```
 
 ```js
 // bdd style
@@ -43,6 +52,10 @@ Expected json object length.
 
 Json path. See [json-query](https://www.npmjs.com/package/json-query) for more usage details.
 
+#### > matcher function (function) 
+
+Matcher function for comparison assertion - `lt`, `gt`, `lte`, `gte`, `notEquals`
+
 ## Examples
 
 ### Normal
@@ -63,4 +76,24 @@ const { spec } = require('pactum');
 await spec()
   .get('https://reqres.in/api/users')
   .expectJsonLength('data', 6);
+```
+
+### Using Matcher Function
+
+```js
+const { spec } = require('pactum');
+const { gte } = require("pactum-matchers");
+
+await spec()
+  .get('https://jsonplaceholder.typicode.com/users')
+  .expectJsonLength('.', gte(10));
+```
+
+```js
+const { spec } = require('pactum');
+const { lte } = require("pactum-matchers");
+
+await spec()
+  .get('https://reqres.in/api/users')
+  .expectJsonLength('data', lte(6));
 ```