@yuneta/gobj-js 7.25.4 → 7.25.5

package/README.md

@@ -540,6 +540,14 @@ kw_get_dict_value(gobj, kw, path, default_value, flag)
 //   kw_get_int(gobj, {x: 3.9}, "x", 0, 0)               → 3  (truncated, as C)
 //   kw_get_int(gobj, {x: "12"}, "x", 5, 0)              → 5  (not a number: logged)
 //   kw_get_int(gobj, {x: "0x1F"}, "x", 5, KW_WILD_NUMBER) → 31 (strtoll base 0)
+//   kw_get_bool(gobj, {x: "0x1F"}, "x", true, KW_WILD_NUMBER) → false (atoi: decimal)
+// kw_get_str() logs as C too: a value that is there and is not a
+// string, required or not ("path MUST BE a json str"), never a null
+// value, and with KW_REQUIRED a path that is not there:
+//   kw_get_str(gobj, {x: 5}, "x", "d", 0)              → "d" (logged)
+//   kw_get_str(gobj, {x: null}, "x", "d", KW_REQUIRED) → "d" (not logged)
+// kw_get_dict() / kw_get_list() log a value of another type only with
+// KW_REQUIRED ("path MUST BE a json dict" / "... a json list"), as C.
 // KW_EXTRACT takes out only a value the reader answers with: a value
 // of another type stays in the kw.
 

package/dist/gobj-js.cjs.js

@@ -3032,7 +3032,7 @@ function gobj_stats(gobj, stats, kw, src) {
 *
 *      Licence: MIT (http://www.opensource.org/licenses/mit-license)
 *      Copyright (c) 2014,2024 Niyamaka.
-*      Copyright (c) 2025, ArtGins.
+*      Copyright (c) 2025-2026, ArtGins.
 *********************************************************************************/
 var kw_flag_t = Object.freeze({
 	KW_REQUIRED: 1,
@@ -3608,10 +3608,13 @@ function kw_delete(gobj, kw, path) {
 *  anything else gives the default back, LOGGED ("path MUST BE a
 *  json boolean", required or not) -- unless KW_WILD_NUMBER asks
 *  to read a number (0 is false), a string ("true"/"false" in any
-*  case, else its integer) or null (false); a list or a dict is
-*  then false, logged too. Before gobj-js 7.25.2 the value went
-*  through Boolean(), so "false" was TRUE; before 7.25.3 a value
-*  of the wrong type gave the default back in silence.
+*  case, else its decimal integer as atoi() reads it: "0x1F" is 0,
+*  so false) or null (false); a list or a dict is then false,
+*  logged too. Before gobj-js 7.25.2 the value went through
+*  Boolean(), so "false" was TRUE; before 7.25.3 a value of the
+*  wrong type gave the default back in silence; before 7.25.5 the
+*  string went through parseInt() with no base, which reads hex:
+*  "0x1F" was TRUE.
 ************************************************************/
 function kw_get_bool(gobj, kw, path, default_value, flag) {
 	if (gobj && !is_gobj(gobj)) log_error(`GObj bad instanceof`);
@@ -3637,7 +3640,7 @@ function kw_get_bool(gobj, kw, path, default_value, flag) {
 	else if (wild && is_string(b)) {
 		if (b.toLowerCase() === "true") value = true;
 		else if (b.toLowerCase() === "false") value = false;
-		else value = (parseInt(b) || 0) !== 0;
+		else value = (parseInt(b, 10) || 0) !== 0;
 	} else if (wild && b === null) value = false;
 	else if (wild) {
 		log_error(`${gobj ? gobj_short_name(gobj) + ": " : ""}path MUST BE a simple json element: '${path}'`);
@@ -3766,6 +3769,21 @@ function kw_get_real(gobj, kw, path, default_value, flag) {
 	return value;
 }
 /************************************************************
+*  TRUE when the last key of `path` is a key of its dict, whatever
+*  its value: kw_find_path() answers undefined both for a key that
+*  is not there and for one whose value is undefined.
+************************************************************/
+function kw_path_holds_key(kw, path) {
+	let ss = is_string(path) ? path.split("`") : [];
+	let parent = kw;
+	for (let i = 0; i < ss.length - 1; i++) {
+		if (!(is_object(parent) || is_array(parent))) return false;
+		parent = parent[ss[i]];
+	}
+	if (!(is_object(parent) || is_array(parent)) || ss.length === 0) return false;
+	return Object.prototype.hasOwnProperty.call(parent, ss[ss.length - 1]);
+}
+/************************************************************
 *  The default comes back AS GIVEN, as in the C kw_get_str()
 *  (`const char *default_value`, where 0 is NULL). Turned into
 *  a string, a default of 0 or null was "0" or "null", which is
@@ -3777,6 +3795,12 @@ function kw_get_real(gobj, kw, path, default_value, flag) {
 *  C refuses to extract a string at all ("Cannot extract a
 *  string": its answer would point into the freed json); a JS
 *  string outlives the kw, so here it is taken out.
+*  A value that is there and is not a string gives the default
+*  back, LOGGED ("path MUST BE a json str", required or not), as
+*  C does; a null value is the key saying "no string" and is not
+*  logged, and KW_REQUIRED logs only a path that is not there at
+*  all. Before gobj-js 7.25.5 a value of another type was logged
+*  only with KW_REQUIRED, and then a null one too.
 ************************************************************/
 function kw_get_str(gobj, kw, path, default_value, flag) {
 	if (gobj && !is_gobj(gobj)) log_error(`GObj bad instanceof`);
@@ -3788,16 +3812,16 @@ function kw_get_str(gobj, kw, path, default_value, flag) {
 		if (create) {
 			kw_set_dict_value(gobj, kw, path, is_string(default_value) ? default_value : null);
 			return default_value;
-		} else if (required) {
+		} else if (required && !kw_path_holds_key(kw, path)) {
 			log_error(`path not found: '${path}'`);
 			trace_json(kw);
 		}
 		return default_value;
 	}
 	if (!is_string(v)) {
-		if (required) {
-			log_error(`${gobj_short_name(gobj)}: path value MUST BE a string: ${path}`);
-			trace_msg(kw);
+		if (v !== null) {
+			log_error(`${gobj ? gobj_short_name(gobj) + ": " : ""}path MUST BE a json str: '${path}'`);
+			trace_json(kw);
 		}
 		return default_value;
 	}
@@ -3853,8 +3877,8 @@ function kw_get_dict(gobj, kw, path, default_value, flag) {
 	}
 	if (!is_object(v)) {
 		if (required) {
-			log_error(`${gobj_short_name(gobj)}: path value MUST BE a dict: ${path}`);
-			trace_msg(kw);
+			log_error(`${gobj ? gobj_short_name(gobj) + ": " : ""}path MUST BE a json dict: '${path}'`);
+			trace_json(kw);
 		}
 		return default_value;
 	}
@@ -3911,8 +3935,8 @@ function kw_get_list(gobj, kw, path, default_value, flag) {
 	}
 	if (!is_array(v)) {
 		if (required) {
-			log_error(`${gobj_short_name(gobj)}: path value MUST BE an array: ${path}`);
-			trace_msg(kw);
+			log_error(`${gobj ? gobj_short_name(gobj) + ": " : ""}path MUST BE a json list: '${path}'`);
+			trace_json(kw);
 		}
 		return default_value;
 	}