jqgrid_utils 1.2.15 → 1.2.18

package/README.md

@@ -36,21 +36,23 @@ A module for Jqgrid_utils
 
 
 * [Jqgrid_utils](#module_Jqgrid_utils)
-    * [module.exports#set_link(col_model, edit_field, url)](#exp_module_Jqgrid_utils--module.exports+set_link) ⏏
+    * [module.exports#set_link(col_model, edit_field, url)](#exp_module_Jqgrid_utils--module.exports+set_link) ⇒ <code>string</code> ⏏
+    * [module.exports#s_grid_set_caption(_grid, data)](#exp_module_Jqgrid_utils--module.exports+s_grid_set_caption) ⏏
     * [module.exports#grid_set_caption(_grid, data)](#exp_module_Jqgrid_utils--module.exports+grid_set_caption) ⏏
-    * [module.exports#s_resize_saved_cell_width()](#exp_module_Jqgrid_utils--module.exports+s_resize_saved_cell_width) ⏏
+    * [module.exports#s_resize_saved_cell_width(col_model, page, grid)](#exp_module_Jqgrid_utils--module.exports+s_resize_saved_cell_width) ⏏
     * [module.exports#resize_saved_cell_width(col_model, page, grid)](#exp_module_Jqgrid_utils--module.exports+resize_saved_cell_width) ⏏
     * [module.exports#resize_cell(the, column, not)](#exp_module_Jqgrid_utils--module.exports+resize_cell) ⏏
-    * [module.exports#upsert_row()](#exp_module_Jqgrid_utils--module.exports+upsert_row) ⏏
-    * [module.exports#insert_row()](#exp_module_Jqgrid_utils--module.exports+insert_row) ⏏
-    * [module.exports#update_row()](#exp_module_Jqgrid_utils--module.exports+update_row) ⏏
-    * [module.exports#delete_row()](#exp_module_Jqgrid_utils--module.exports+delete_row) ⏏
-    * [module.exports#adelete_api()](#exp_module_Jqgrid_utils--module.exports+adelete_api) ⏏
-    * [module.exports#post_json()](#exp_module_Jqgrid_utils--module.exports+post_json) ⏏
-    * [module.exports#put_json()](#exp_module_Jqgrid_utils--module.exports+put_json) ⏏
+    * [module.exports#upsert_row(row, url, req)](#exp_module_Jqgrid_utils--module.exports+upsert_row) ⇒ <code>object</code> ⏏
+    * [module.exports#insert_row(row, url)](#exp_module_Jqgrid_utils--module.exports+insert_row) ⇒ <code>object</code> ⏏
+    * [module.exports#update_row(row, url, req)](#exp_module_Jqgrid_utils--module.exports+update_row) ⇒ <code>object</code> ⏏
+    * [module.exports#delete_row(_id, url)](#exp_module_Jqgrid_utils--module.exports+delete_row) ⇒ <code>object</code> ⏏
+    * [module.exports#adelete_api(url)](#exp_module_Jqgrid_utils--module.exports+adelete_api) ⇒ <code>object</code> ⏏
+    * [module.exports#post_json(url, data)](#exp_module_Jqgrid_utils--module.exports+post_json) ⇒ <code>object</code> ⏏
+    * [module.exports#put_json(url, data)](#exp_module_Jqgrid_utils--module.exports+put_json) ⇒ <code>object</code> ⏏
+    * [module.exports#s_hide_del_icon()](#exp_module_Jqgrid_utils--module.exports+s_hide_del_icon) ⏏
     * [module.exports#hide_del_icon()](#exp_module_Jqgrid_utils--module.exports+hide_del_icon) ⏏
-    * [module.exports#add_link_details()](#exp_module_Jqgrid_utils--module.exports+add_link_details) ⏏
-    * [module.exports#add_link_details_separator()](#exp_module_Jqgrid_utils--module.exports+add_link_details_separator) ⏏
+    * [module.exports#add_link_details(col_model, url, edit_field, attr, keys)](#exp_module_Jqgrid_utils--module.exports+add_link_details) ⏏
+    * [module.exports#add_link_details_separator(col_model, url, edit_field, attr, keys)](#exp_module_Jqgrid_utils--module.exports+add_link_details_separator) ⏏
     * [module.exports#__cell_format()](#exp_module_Jqgrid_utils--module.exports+__cell_format) ⏏
     * [module.exports#subgrid(_id, id, data_url, col_model, caption)](#exp_module_Jqgrid_utils--module.exports+subgrid) ⏏
     * [module.exports#add_image(col_model, edit_field, size, link)](#exp_module_Jqgrid_utils--module.exports+add_image) ⏏
@@ -59,11 +61,11 @@ A module for Jqgrid_utils
 
 <a name="exp_module_Jqgrid_utils--module.exports+set_link"></a>
 
-### module.exports#set\_link(col_model, edit_field, url) ⏏
+### module.exports#set\_link(col_model, edit_field, url) ⇒ <code>string</code> ⏏
 Add an URL from the data to a specific cell/column
 
 **Kind**: Exported function  
-**Result**: https://foo.bar.com/av0_code/bar  
+**Returns**: <code>string</code> - https://foo.bar.com/av0_code/bar  
 
 | Param | Type | Description |
 | --- | --- | --- |
@@ -73,8 +75,26 @@ Add an URL from the data to a specific cell/column
 
 **Example**  
 ```js
+var jqu = new Jqgrid_utils();
 col_model = await jqu.set_link(col_model,'av0_code','url_code','target="blank"');
 ```
+<a name="exp_module_Jqgrid_utils--module.exports+s_grid_set_caption"></a>
+
+### module.exports#s\_grid\_set\_caption(_grid, data) ⏏
+**Kind**: Exported function  
+
+| Param | Type | Description |
+| --- | --- | --- |
+| _grid | <code>object</code> | gridobject; |
+| data | <code>object</code> | grid data (optional); |
+
+**Example**  
+```js
+var jqu = new Jqgrid_utils();
+loadComplete: function(){
+  jqu.grid_set_caption(this);
+},
+```
 <a name="exp_module_Jqgrid_utils--module.exports+grid_set_caption"></a>
 
 ### module.exports#grid\_set\_caption(_grid, data) ⏏
@@ -89,13 +109,24 @@ col_model = await jqu.set_link(col_model,'av0_code','url_code','target="blank"')
 ```js
 var jqu = new Jqgrid_utils();
 loadComplete: function(){
-  jqu.grid_set_caption(this);
+  await jqu.grid_set_caption(this);
 },
 ```
 <a name="exp_module_Jqgrid_utils--module.exports+s_resize_saved_cell_width"></a>
 
-### module.exports#s\_resize\_saved\_cell\_width() ⏏
+### module.exports#s\_resize\_saved\_cell\_width(col_model, page, grid) ⏏
 **Kind**: Exported function  
+
+| Param | Type | Default | Description |
+| --- | --- | --- | --- |
+| col_model | <code>object</code> |  | the col_model of the grid |
+| page | <code>string</code> | <code>false</code> | the name of the page(optional) |
+| grid | <code>object</code> | <code>false</code> | the grid objec(optional) |
+
+**Example**  
+```js
+col_model = await jqu.resize_saved_cell_width(col_model);
+```
 <a name="exp_module_Jqgrid_utils--module.exports+resize_saved_cell_width"></a>
 
 ### module.exports#resize\_saved\_cell\_width(col_model, page, grid) ⏏
@@ -129,55 +160,218 @@ resizeStop: jqu.resize_cell,
 ```
 <a name="exp_module_Jqgrid_utils--module.exports+upsert_row"></a>
 
-### module.exports#upsert\_row() ⏏
+### module.exports#upsert\_row(row, url, req) ⇒ <code>object</code> ⏏
+Upsert(insert or update) from the grid to an API
+
 **Kind**: Exported function  
+**Returns**: <code>object</code> - {update: 'ok'} or {udpate: 'failed'}  
+
+| Param | Type | Description |
+| --- | --- | --- |
+| row | <code>object</code> | row object |
+| url | <code>string</code> | url of the API |
+| req | <code>string</code> | data oject |
+
+**Example**  
+```js
+var jqu = new Jqgrid_utils();
+afterSetRow: async function(row)
+{
+  let r = await jqu.upsert_row(row, url);
+  console.log(r);
+},
+```
 <a name="exp_module_Jqgrid_utils--module.exports+insert_row"></a>
 
-### module.exports#insert\_row() ⏏
+### module.exports#insert\_row(row, url) ⇒ <code>object</code> ⏏
+Insert from the grid to an API used by the upsert_row function
+
 **Kind**: Exported function  
+**Returns**: <code>object</code> - Object from the the API like {update: 'ok'} or {update: 'failed'}  
+
+| Param | Type | Description |
+| --- | --- | --- |
+| row | <code>object</code> | row object |
+| url | <code>string</code> | url of the API |
+|  | <code>string</code> | data oject |
+
+**Example**  
+```js
+var jqu = new Jqgrid_utils();
+afterSetRow: async function(row)
+{
+  let r = await jqu.upsert_row(row, url);
+  console.log(r);
+},
+```
 <a name="exp_module_Jqgrid_utils--module.exports+update_row"></a>
 
-### module.exports#update\_row() ⏏
+### module.exports#update\_row(row, url, req) ⇒ <code>object</code> ⏏
+Update from the grid to an API used by the upsert_row function
+
 **Kind**: Exported function  
+**Returns**: <code>object</code> - Object from the the API like {update: 'ok'} or {update: 'failed'}  
+
+| Param | Type | Description |
+| --- | --- | --- |
+| row | <code>object</code> | row object |
+| url | <code>string</code> | url of the API |
+| req | <code>string</code> | data oject |
+
+**Example**  
+```js
+var jqu = new Jqgrid_utils();
+afterSetRow: async function(row)
+{
+  let r = await jqu.upsert_row(row, url);
+  console.log(r);
+},
+```
 <a name="exp_module_Jqgrid_utils--module.exports+delete_row"></a>
 
-### module.exports#delete\_row() ⏏
+### module.exports#delete\_row(_id, url) ⇒ <code>object</code> ⏏
+Delete from the grid to an API
+
 **Kind**: Exported function  
+**Returns**: <code>object</code> - @returns {object} Object from the the API like {delete: 'ok'} or {delete: 'failed'}  
+
+| Param | Type | Description |
+| --- | --- | --- |
+| _id | <code>string</code> | row id |
+| url | <code>string</code> | url of the API |
+
+**Example**  
+```js
+var jqu = new Jqgrid_utils();
+afterDelRow: async function(row)
+{
+  const r = await jqu.delete_row(row, url);
+  console.log(r + ' : ' + row + ' - from API');
+},
+```
 <a name="exp_module_Jqgrid_utils--module.exports+adelete_api"></a>
 
-### module.exports#adelete\_api() ⏏
+### module.exports#adelete\_api(url) ⇒ <code>object</code> ⏏
+Async Delete request used by function delete_row
+
 **Kind**: Exported function  
+**Returns**: <code>object</code> - @returns {object} Object from the the API like {delete: 'ok'} or {delete: 'failed'}  
+
+| Param | Type | Description |
+| --- | --- | --- |
+| url | <code>string</code> | url of the API |
+
+**Example**  
+```js
+var jqu = new Jqgrid_utils();
+afterDelRow: async function(row)
+{
+  ret = JSON.parse(await jqu.adelete_api(url));
+},
+```
 <a name="exp_module_Jqgrid_utils--module.exports+post_json"></a>
 
-### module.exports#post\_json() ⏏
+### module.exports#post\_json(url, data) ⇒ <code>object</code> ⏏
+Async Post request used by the update_row function
+
 **Kind**: Exported function  
+**Returns**: <code>object</code> - @returns {object} Object from the the API like {update: 'ok'} or {update: 'failed'}  
+
+| Param | Type | Description |
+| --- | --- | --- |
+| url | <code>string</code> | url of the API |
+| data | <code>object</code> | json object |
+
+**Example**  
+```js
+var jqu = new Jqgrid_utils();
+ret = JSON.parse(await jqu.post_json(url,{'key':value,'key2':'value'}));
+```
 <a name="exp_module_Jqgrid_utils--module.exports+put_json"></a>
 
-### module.exports#put\_json() ⏏
+### module.exports#put\_json(url, data) ⇒ <code>object</code> ⏏
+Async Put request used by the insert_row function
+
 **Kind**: Exported function  
+**Returns**: <code>object</code> - @returns {object} Object from the the API like {insert: 'ok'} or {insert: 'failed'}  
+
+| Param | Type | Description |
+| --- | --- | --- |
+| url | <code>string</code> | url of the API |
+| data | <code>object</code> | json object |
+
+**Example**  
+```js
+var jqu = new Jqgrid_utils();
+ret = JSON.parse(await jqu.put_json(url,{'key':value,'key2':'value2'}));
+```
+<a name="exp_module_Jqgrid_utils--module.exports+s_hide_del_icon"></a>
+
+### module.exports#s\_hide\_del\_icon() ⏏
+Hide the del iconf rom the grid
+
+**Kind**: Exported function  
+**Example**  
+```js
+var jqu = new Jqgrid_utils();
+jqu.hide_del_icon();
+```
 <a name="exp_module_Jqgrid_utils--module.exports+hide_del_icon"></a>
 
 ### module.exports#hide\_del\_icon() ⏏
+Hide the del iconf rom the grid
+
 **Kind**: Exported function  
+**Example**  
+```js
+var jqu = new Jqgrid_utils();
+await jqu.hide_del_icon();
+```
 <a name="exp_module_Jqgrid_utils--module.exports+add_link_details"></a>
 
-### module.exports#add\_link\_details() ⏏
+### module.exports#add\_link\_details(col_model, url, edit_field, attr, keys) ⏏
+Convert a cell into a link/url with data from another cell
+
 **Kind**: Exported function  
+
+| Param | Type | Description |
+| --- | --- | --- |
+| col_model | <code>object</code> | col_model of the grid |
+| url | <code>string</code> | URL string |
+| edit_field | <code>string</code> | Column/Cell to use |
+| attr | <code>string</code> | URL Attributes |
+| keys | <code>object</code> | keys and fields value to use |
+
 **Example**  
 ```js
-example: col_model = await jqu.add_link_details(col_model,'http://foo.bar'' , 'target_field','target="_blank"',{"key":"field1","key":"field2"});
+var jqu = new Jqgrid_utils();
+col_model = await jqu.add_link_details(col_model,'http://foo.bar'' , 'target_field','target="_blank"',{"key":"field1","key":"field2"});
 ```
 <a name="exp_module_Jqgrid_utils--module.exports+add_link_details_separator"></a>
 
-### module.exports#add\_link\_details\_separator() ⏏
+### module.exports#add\_link\_details\_separator(col_model, url, edit_field, attr, keys) ⏏
+Convert a cell into seperated based link/url like https://foo.bar.com/field/value/field/value
+
 **Kind**: Exported function  
+
+| Param | Type | Description |
+| --- | --- | --- |
+| col_model | <code>object</code> | col_model of the grid |
+| url | <code>string</code> | URL string |
+| edit_field | <code>string</code> | Column/Cell to use |
+| attr | <code>string</code> | URL Attributes |
+| keys | <code>object</code> | keys and fields value to use |
+
 **Example**  
 ```js
+var jqu = new Jqgrid_utils();
 col_model = await jqu.add_link_details_separator(col_model, 'https://foo.com' , 'couchdb','target="_blank"',{"mykey":"myval"});
 ```
 <a name="exp_module_Jqgrid_utils--module.exports+__cell_format"></a>
 
 ### module.exports#\_\_cell\_format() ⏏
+Private Function
+
 **Kind**: Exported function  
 <a name="exp_module_Jqgrid_utils--module.exports+subgrid"></a>
 

package/dist/jqgrid_utils.js

@@ -33,10 +33,10 @@ module.exports = class Vanilla_website_utils
 @param {object} - col_model of the grid
 @param {string} - name of the column what should get convert to the url
 @param {string} - the used url of the data 
+@returns {string} https://foo.bar.com/av0_code/bar 
 @example
+var jqu = new Jqgrid_utils();
 col_model = await jqu.set_link(col_model,'av0_code','url_code','target="blank"');
-@result
-* https://foo.bar.com/av0_code/bar 
 */
   async set_link(col_model, edit_field, url ,attr='')
   {
@@ -53,6 +53,16 @@ col_model = await jqu.set_link(col_model,'av0_code','url_code','target="blank"')
     return col_model;
   }
 
+/**
+@alias module:Jqgrid_utils
+@param {object} - gridobject;
+@param {object} - grid data (optional);
+@example 
+var jqu = new Jqgrid_utils();
+loadComplete: function(){
+  jqu.grid_set_caption(this);
+},
+*/
 
   s_grid_set_caption(_grid, data=[])
   {
@@ -66,7 +76,7 @@ col_model = await jqu.set_link(col_model,'av0_code','url_code','target="blank"')
 @example 
 var jqu = new Jqgrid_utils();
 loadComplete: function(){
-  jqu.grid_set_caption(this);
+  await jqu.grid_set_caption(this);
 },
 */
   async grid_set_caption(_grid, data=[])
@@ -89,6 +99,11 @@ loadComplete: function(){
 
 /**
 @alias module:Jqgrid_utils
+@param {object} - the col_model of the grid
+@param {string} - the name of the page(optional)
+@param {object} - the grid objec(optional)
+@example 
+col_model = await jqu.resize_saved_cell_width(col_model);
 */
   s_resize_saved_cell_width(col_model, page=false, grid=false)
   {
@@ -155,7 +170,19 @@ col_model = await jqu.resize_saved_cell_width(col_model);
 
 
 /**
+* Upsert(insert or update) from the grid to an API 
 @alias module:Jqgrid_utils
+@param {object} - row object
+@param {string} - url of the API
+@param {string} - data oject 
+@returns {object} {update: 'ok'} or {udpate: 'failed'}
+@example
+var jqu = new Jqgrid_utils();
+afterSetRow: async function(row)
+{
+  let r = await jqu.upsert_row(row, url);
+  console.log(r);
+},
 */
 async upsert_row(row, url, req = {})
 {
@@ -171,8 +198,21 @@ async upsert_row(row, url, req = {})
   }
 }
 
+
 /**
+* Insert from the grid to an API used by the upsert_row function 
 @alias module:Jqgrid_utils
+@param {object} - row object
+@param {string} - url of the API
+@param {string} - data oject 
+@returns {object} Object from the the API like {update: 'ok'} or {update: 'failed'}
+@example
+var jqu = new Jqgrid_utils();
+afterSetRow: async function(row)
+{
+  let r = await jqu.upsert_row(row, url);
+  console.log(r);
+},
 */
 async insert_row(row, url)
 {
@@ -196,8 +236,21 @@ async insert_row(row, url)
 
 
 /**
+* Update from the grid to an API used by the upsert_row function 
 @alias module:Jqgrid_utils
+@param {object} - row object
+@param {string} - url of the API
+@param {string} - data oject 
+@returns {object} Object from the the API like {update: 'ok'} or {update: 'failed'}
+@example
+var jqu = new Jqgrid_utils();
+afterSetRow: async function(row)
+{
+  let r = await jqu.upsert_row(row, url);
+  console.log(r);
+},
 */
+
 async  update_row(row, url, req = {})
 {
   let ret = '';
@@ -219,8 +272,20 @@ async  update_row(row, url, req = {})
 }
 
 /**
+* Delete from the grid to an API 
 @alias module:Jqgrid_utils
+@param {string} - row id
+@param {string} - url of the API
+@returns {object} @returns {object} Object from the the API like {delete: 'ok'} or {delete: 'failed'}
+@example
+var jqu = new Jqgrid_utils();
+afterDelRow: async function(row)
+{
+  const r = await jqu.delete_row(row, url);
+  console.log(r + ' : ' + row + ' - from API');
+},
 */
+
 async delete_row(_id, url)
 {
   let ret = '';
@@ -239,8 +304,18 @@ async delete_row(_id, url)
 
 
 /**
+* Async Delete request used by function delete_row
 @alias module:Jqgrid_utils
+@param {string} - url of the API
+@returns {object} @returns {object} Object from the the API like {delete: 'ok'} or {delete: 'failed'}
+@example
+var jqu = new Jqgrid_utils();
+afterDelRow: async function(row)
+{
+  ret = JSON.parse(await jqu.adelete_api(url));
+},
 */
+
 async adelete_api(url, json = false)
 {
   const ctype = json ? "application/json;charset=UTF-8" : "application/x-www-form-urlencoded";
@@ -256,9 +331,18 @@ async adelete_api(url, json = false)
 }
 
 
+
 /**
+* Async Post request used by the update_row function
 @alias module:Jqgrid_utils
+@param {string} - url of the API
+@param {object} - json object
+@returns {object} @returns {object} Object from the the API like {update: 'ok'} or {update: 'failed'}
+@example
+var jqu = new Jqgrid_utils();
+ret = JSON.parse(await jqu.post_json(url,{'key':value,'key2':'value'}));
 */
+
 async post_json(url, data)
 {
   return new Promise((resolve, reject) =>
@@ -273,7 +357,14 @@ async post_json(url, data)
 }
 
 /**
+* Async Put request used by the insert_row function
 @alias module:Jqgrid_utils
+@param {string} - url of the API
+@param {object} - json object
+@returns {object} @returns {object} Object from the the API like {insert: 'ok'} or {insert: 'failed'}
+@example
+var jqu = new Jqgrid_utils();
+ret = JSON.parse(await jqu.put_json(url,{'key':value,'key2':'value2'}));
 */
 async put_json(url, data)
 {
@@ -288,14 +379,24 @@ async put_json(url, data)
   });
 }
 
-
+/**
+* Hide the del iconf rom the grid
+@alias module:Jqgrid_utils
+@example
+var jqu = new Jqgrid_utils();
+jqu.hide_del_icon();
+*/
 s_hide_del_icon()
 {
   hide_del_icon();   
 }
 
 /**
+* Hide the del iconf rom the grid
 @alias module:Jqgrid_utils
+@example
+var jqu = new Jqgrid_utils();
+await jqu.hide_del_icon();
 */
 async hide_del_icon()
 {
@@ -305,9 +406,16 @@ async hide_del_icon()
 
 
 /**
+* Convert a cell into a link/url with data from another cell
 @alias module:Jqgrid_utils
+@param {object} - col_model of the grid
+@param {string} - URL string 
+@param {string} - Column/Cell to use
+@param {string} - URL Attributes
+@param {object} - keys and fields value to use 
 @example 
-* example: col_model = await jqu.add_link_details(col_model,'http://foo.bar'' , 'target_field','target="_blank"',{"key":"field1","key":"field2"});
+var jqu = new Jqgrid_utils();
+col_model = await jqu.add_link_details(col_model,'http://foo.bar'' , 'target_field','target="_blank"',{"key":"field1","key":"field2"});
 */
 async add_link_details(col_model, url, edit_field, attr = '', keys, format)
 {
@@ -377,9 +485,16 @@ async add_link_details(col_model, url, edit_field, attr = '', keys, format)
 
 
 /**
+* Convert a cell into seperated based link/url like https://foo.bar.com/field/value/field/value
 @alias module:Jqgrid_utils
+@param {object} - col_model of the grid
+@param {string} - URL string 
+@param {string} - Column/Cell to use
+@param {string} - URL Attributes
+@param {object} - keys and fields value to use 
 @example 
-* col_model = await jqu.add_link_details_separator(col_model, 'https://foo.com' , 'couchdb','target="_blank"',{"mykey":"myval"});
+var jqu = new Jqgrid_utils();
+col_model = await jqu.add_link_details_separator(col_model, 'https://foo.com' , 'couchdb','target="_blank"',{"mykey":"myval"});
 */
 async add_link_details_separator(col_model, url, edit_field, attr = '', keys, format)
 {
@@ -444,6 +559,7 @@ async add_link_details_separator(col_model, url, edit_field, attr = '', keys, fo
 
 
 /**
+* Private Function
 @alias module:Jqgrid_utils
 */
 __cell_format(cell_value, format)

package/jqgrid_utils.js

@@ -32,10 +32,10 @@ module.exports = class Vanilla_website_utils
 @param {object} - col_model of the grid
 @param {string} - name of the column what should get convert to the url
 @param {string} - the used url of the data 
+@returns {string} https://foo.bar.com/av0_code/bar 
 @example
+var jqu = new Jqgrid_utils();
 col_model = await jqu.set_link(col_model,'av0_code','url_code','target="blank"');
-@result
-* https://foo.bar.com/av0_code/bar 
 */
   async set_link(col_model, edit_field, url ,attr='')
   {
@@ -52,6 +52,16 @@ col_model = await jqu.set_link(col_model,'av0_code','url_code','target="blank"')
     return col_model;
   }
 
+/**
+@alias module:Jqgrid_utils
+@param {object} - gridobject;
+@param {object} - grid data (optional);
+@example 
+var jqu = new Jqgrid_utils();
+loadComplete: function(){
+  jqu.grid_set_caption(this);
+},
+*/
 
   s_grid_set_caption(_grid, data=[])
   {
@@ -65,7 +75,7 @@ col_model = await jqu.set_link(col_model,'av0_code','url_code','target="blank"')
 @example 
 var jqu = new Jqgrid_utils();
 loadComplete: function(){
-  jqu.grid_set_caption(this);
+  await jqu.grid_set_caption(this);
 },
 */
   async grid_set_caption(_grid, data=[])
@@ -88,6 +98,11 @@ loadComplete: function(){
 
 /**
 @alias module:Jqgrid_utils
+@param {object} - the col_model of the grid
+@param {string} - the name of the page(optional)
+@param {object} - the grid objec(optional)
+@example 
+col_model = await jqu.resize_saved_cell_width(col_model);
 */
   s_resize_saved_cell_width(col_model, page=false, grid=false)
   {
@@ -154,7 +169,19 @@ col_model = await jqu.resize_saved_cell_width(col_model);
 
 
 /**
+* Upsert(insert or update) from the grid to an API 
 @alias module:Jqgrid_utils
+@param {object} - row object
+@param {string} - url of the API
+@param {string} - data oject 
+@returns {object} {update: 'ok'} or {udpate: 'failed'}
+@example
+var jqu = new Jqgrid_utils();
+afterSetRow: async function(row)
+{
+  let r = await jqu.upsert_row(row, url);
+  console.log(r);
+},
 */
 async upsert_row(row, url, req = {})
 {
@@ -170,8 +197,21 @@ async upsert_row(row, url, req = {})
   }
 }
 
+
 /**
+* Insert from the grid to an API used by the upsert_row function 
 @alias module:Jqgrid_utils
+@param {object} - row object
+@param {string} - url of the API
+@param {string} - data oject 
+@returns {object} Object from the the API like {update: 'ok'} or {update: 'failed'}
+@example
+var jqu = new Jqgrid_utils();
+afterSetRow: async function(row)
+{
+  let r = await jqu.upsert_row(row, url);
+  console.log(r);
+},
 */
 async insert_row(row, url)
 {
@@ -195,8 +235,21 @@ async insert_row(row, url)
 
 
 /**
+* Update from the grid to an API used by the upsert_row function 
 @alias module:Jqgrid_utils
+@param {object} - row object
+@param {string} - url of the API
+@param {string} - data oject 
+@returns {object} Object from the the API like {update: 'ok'} or {update: 'failed'}
+@example
+var jqu = new Jqgrid_utils();
+afterSetRow: async function(row)
+{
+  let r = await jqu.upsert_row(row, url);
+  console.log(r);
+},
 */
+
 async  update_row(row, url, req = {})
 {
   let ret = '';
@@ -218,8 +271,20 @@ async  update_row(row, url, req = {})
 }
 
 /**
+* Delete from the grid to an API 
 @alias module:Jqgrid_utils
+@param {string} - row id
+@param {string} - url of the API
+@returns {object} @returns {object} Object from the the API like {delete: 'ok'} or {delete: 'failed'}
+@example
+var jqu = new Jqgrid_utils();
+afterDelRow: async function(row)
+{
+  const r = await jqu.delete_row(row, url);
+  console.log(r + ' : ' + row + ' - from API');
+},
 */
+
 async delete_row(_id, url)
 {
   let ret = '';
@@ -238,8 +303,18 @@ async delete_row(_id, url)
 
 
 /**
+* Async Delete request used by function delete_row
 @alias module:Jqgrid_utils
+@param {string} - url of the API
+@returns {object} @returns {object} Object from the the API like {delete: 'ok'} or {delete: 'failed'}
+@example
+var jqu = new Jqgrid_utils();
+afterDelRow: async function(row)
+{
+  ret = JSON.parse(await jqu.adelete_api(url));
+},
 */
+
 async adelete_api(url, json = false)
 {
   const ctype = json ? "application/json;charset=UTF-8" : "application/x-www-form-urlencoded";
@@ -255,9 +330,18 @@ async adelete_api(url, json = false)
 }
 
 
+
 /**
+* Async Post request used by the update_row function
 @alias module:Jqgrid_utils
+@param {string} - url of the API
+@param {object} - json object
+@returns {object} @returns {object} Object from the the API like {update: 'ok'} or {update: 'failed'}
+@example
+var jqu = new Jqgrid_utils();
+ret = JSON.parse(await jqu.post_json(url,{'key':value,'key2':'value'}));
 */
+
 async post_json(url, data)
 {
   return new Promise((resolve, reject) =>
@@ -272,7 +356,14 @@ async post_json(url, data)
 }
 
 /**
+* Async Put request used by the insert_row function
 @alias module:Jqgrid_utils
+@param {string} - url of the API
+@param {object} - json object
+@returns {object} @returns {object} Object from the the API like {insert: 'ok'} or {insert: 'failed'}
+@example
+var jqu = new Jqgrid_utils();
+ret = JSON.parse(await jqu.put_json(url,{'key':value,'key2':'value2'}));
 */
 async put_json(url, data)
 {
@@ -287,14 +378,24 @@ async put_json(url, data)
   });
 }
 
-
+/**
+* Hide the del iconf rom the grid
+@alias module:Jqgrid_utils
+@example
+var jqu = new Jqgrid_utils();
+jqu.hide_del_icon();
+*/
 s_hide_del_icon()
 {
   hide_del_icon();   
 }
 
 /**
+* Hide the del iconf rom the grid
 @alias module:Jqgrid_utils
+@example
+var jqu = new Jqgrid_utils();
+await jqu.hide_del_icon();
 */
 async hide_del_icon()
 {
@@ -304,9 +405,16 @@ async hide_del_icon()
 
 
 /**
+* Convert a cell into a link/url with data from another cell
 @alias module:Jqgrid_utils
+@param {object} - col_model of the grid
+@param {string} - URL string 
+@param {string} - Column/Cell to use
+@param {string} - URL Attributes
+@param {object} - keys and fields value to use 
 @example 
-* example: col_model = await jqu.add_link_details(col_model,'http://foo.bar'' , 'target_field','target="_blank"',{"key":"field1","key":"field2"});
+var jqu = new Jqgrid_utils();
+col_model = await jqu.add_link_details(col_model,'http://foo.bar'' , 'target_field','target="_blank"',{"key":"field1","key":"field2"});
 */
 async add_link_details(col_model, url, edit_field, attr = '', keys, format)
 {
@@ -376,9 +484,16 @@ async add_link_details(col_model, url, edit_field, attr = '', keys, format)
 
 
 /**
+* Convert a cell into seperated based link/url like https://foo.bar.com/field/value/field/value
 @alias module:Jqgrid_utils
+@param {object} - col_model of the grid
+@param {string} - URL string 
+@param {string} - Column/Cell to use
+@param {string} - URL Attributes
+@param {object} - keys and fields value to use 
 @example 
-* col_model = await jqu.add_link_details_separator(col_model, 'https://foo.com' , 'couchdb','target="_blank"',{"mykey":"myval"});
+var jqu = new Jqgrid_utils();
+col_model = await jqu.add_link_details_separator(col_model, 'https://foo.com' , 'couchdb','target="_blank"',{"mykey":"myval"});
 */
 async add_link_details_separator(col_model, url, edit_field, attr = '', keys, format)
 {
@@ -443,6 +558,7 @@ async add_link_details_separator(col_model, url, edit_field, attr = '', keys, fo
 
 
 /**
+* Private Function
 @alias module:Jqgrid_utils
 */
 __cell_format(cell_value, format)

package/package.json

@@ -29,5 +29,5 @@
   {
     "test": "echo \"Error: no test specified\" && exit 1"
   },
-  "version": "1.2.15"
+  "version": "1.2.18"
 }