From 275935baff6551c6b91140ee6ba0ecf8ebabe860 Mon Sep 17 00:00:00 2001 From: BrainFooLong Date: Thu, 30 Sep 2021 19:59:21 +0200 Subject: [PATCH] updates for upcoming stable release --- README.md | 12 ++++++++---- dist/form-data-json.js | 12 ++++++++---- docs/scripts/form-data-json.js | 12 ++++++++---- src/form-data-json.js | 12 ++++++++---- 4 files changed, 32 insertions(+), 16 deletions(-) diff --git a/README.md b/README.md index 63ad5cc..41ebd41 100644 --- a/README.md +++ b/README.md @@ -100,7 +100,8 @@ You can edit this defaults globally by modifying `FormDataJson.defaultOptionsToJ 'uncheckedValue': undefined, /** - * A function, where first parameter is the input field to check for, that must return true if the field should be included + * A function, where first parameter is the input field to check for + * Must return true if the field should be included * All other return values, as well as no return value, will skip the input field in the progress * @type {function|null} */ @@ -116,7 +117,9 @@ You can edit this defaults globally by modifying `FormDataJson.defaultOptionsToJ /** * If true, than this does skip empty fields from the output - * Empty is considered to be: an empty array (for multiple selects/checkboxes) and an empty input field (length = 0) + * Empty is considered to be: + * An empty array (for multiple selects/checkboxes) + * An empty input field (length = 0) * This does recursively remove keys * Example: {"agb":"1", "user" : [{"name" : ""},{"name" : ""}]} will be {"agb":"1"} * @type {boolean} @@ -124,8 +127,9 @@ You can edit this defaults globally by modifying `FormDataJson.defaultOptionsToJ 'skipEmpty': false, /** - * A function the will be called when all file fields are read as base64 data uri - * Note: If this is given, than the original return value from toJson() is null and the values are passed to this callback as first parameter + * A function that will be called when all file fields are read as base64 data uri + * First passed parameter to this function are the form values including all file data + * Note: If set, the original return value from toJson() returns null * @type {function|null} */ 'filesCallback': null, diff --git a/dist/form-data-json.js b/dist/form-data-json.js index c9481e9..27f2325 100644 --- a/dist/form-data-json.js +++ b/dist/form-data-json.js @@ -757,7 +757,8 @@ FormDataJson.defaultOptionsToJson = { 'uncheckedValue': undefined, /** - * A function, where first parameter is the input field to check for, that must return true if the field should be included + * A function, where first parameter is the input field to check for + * Must return true if the field should be included * All other return values, as well as no return value, will skip the input field in the progress * @type {function|null} */ @@ -773,7 +774,9 @@ FormDataJson.defaultOptionsToJson = { /** * If true, than this does skip empty fields from the output - * Empty is considered to be: an empty array (for multiple selects/checkboxes) and an empty input field (length = 0) + * Empty is considered to be: + * An empty array (for multiple selects/checkboxes) + * An empty input field (length = 0) * This does recursively remove keys * Example: {"agb":"1", "user" : [{"name" : ""},{"name" : ""}]} will be {"agb":"1"} * @type {boolean} @@ -781,8 +784,9 @@ FormDataJson.defaultOptionsToJson = { 'skipEmpty': false, /** - * A function the will be called when all file fields are read as base64 data uri - * Note: If this is given, than the original return value from toJson() is null and the values are passed to this callback as first parameter + * A function that will be called when all file fields are read as base64 data uri + * First passed parameter to this function are the form values including all file data + * Note: If set, the original return value from toJson() returns null * @type {function|null} */ 'filesCallback': null, diff --git a/docs/scripts/form-data-json.js b/docs/scripts/form-data-json.js index c9481e9..27f2325 100644 --- a/docs/scripts/form-data-json.js +++ b/docs/scripts/form-data-json.js @@ -757,7 +757,8 @@ FormDataJson.defaultOptionsToJson = { 'uncheckedValue': undefined, /** - * A function, where first parameter is the input field to check for, that must return true if the field should be included + * A function, where first parameter is the input field to check for + * Must return true if the field should be included * All other return values, as well as no return value, will skip the input field in the progress * @type {function|null} */ @@ -773,7 +774,9 @@ FormDataJson.defaultOptionsToJson = { /** * If true, than this does skip empty fields from the output - * Empty is considered to be: an empty array (for multiple selects/checkboxes) and an empty input field (length = 0) + * Empty is considered to be: + * An empty array (for multiple selects/checkboxes) + * An empty input field (length = 0) * This does recursively remove keys * Example: {"agb":"1", "user" : [{"name" : ""},{"name" : ""}]} will be {"agb":"1"} * @type {boolean} @@ -781,8 +784,9 @@ FormDataJson.defaultOptionsToJson = { 'skipEmpty': false, /** - * A function the will be called when all file fields are read as base64 data uri - * Note: If this is given, than the original return value from toJson() is null and the values are passed to this callback as first parameter + * A function that will be called when all file fields are read as base64 data uri + * First passed parameter to this function are the form values including all file data + * Note: If set, the original return value from toJson() returns null * @type {function|null} */ 'filesCallback': null, diff --git a/src/form-data-json.js b/src/form-data-json.js index a2c6b0f..63105b3 100644 --- a/src/form-data-json.js +++ b/src/form-data-json.js @@ -32,7 +32,8 @@ class FormDataJson { 'uncheckedValue': undefined, /** - * A function, where first parameter is the input field to check for, that must return true if the field should be included + * A function, where first parameter is the input field to check for + * Must return true if the field should be included * All other return values, as well as no return value, will skip the input field in the progress * @type {function|null} */ @@ -48,7 +49,9 @@ class FormDataJson { /** * If true, than this does skip empty fields from the output - * Empty is considered to be: an empty array (for multiple selects/checkboxes) and an empty input field (length = 0) + * Empty is considered to be: + * An empty array (for multiple selects/checkboxes) + * An empty input field (length = 0) * This does recursively remove keys * Example: {"agb":"1", "user" : [{"name" : ""},{"name" : ""}]} will be {"agb":"1"} * @type {boolean} @@ -56,8 +59,9 @@ class FormDataJson { 'skipEmpty': false, /** - * A function the will be called when all file fields are read as base64 data uri - * Note: If this is given, than the original return value from toJson() is null and the values are passed to this callback as first parameter + * A function that will be called when all file fields are read as base64 data uri + * First passed parameter to this function are the form values including all file data + * Note: If set, the original return value from toJson() returns null * @type {function|null} */ 'filesCallback': null,