@yuneta/gobj-js 7.13.5 → 7.13.6

package/README.md

@@ -589,6 +589,10 @@ set_log_callback(fn)                      // fn(level, message)
 
 // Gate the DIRECT browser-console writes of all the functions above
 set_console_log_enabled(enabled)          // default: true (unchanged behaviour)
+
+// ...and a per-LINE say over them, on top of that switch (7.13.6)
+set_console_log_filter(fn)                // fn(level, msg) -> true to print
+set_console_log_filter(null)              // default: everything prints
 ```
 
 **Three independent output paths.** `set_console_log_enabled(false)` silences
@@ -598,6 +602,15 @@ a GUI route framework output — **including the automata/FSM trace, which arriv
 as `debug`** — into its own monitor window while keeping the browser console
 clean (gobj-ui's dev-window "Output" selector does exactly this).
 
+**Why a filter and not just the switch.** The console write happens **before**
+the sink is called, so nothing downstream can un-print a line: a consumer that
+wants one CLASS of lines kept off the console — the dev monitor hiding the
+`machine` trace's timer traffic, two `EV_TIMEOUT` lines a second for ever — can
+only say so here. The filter decides the **console alone**: the sink still
+receives every line, so a monitor keeps a complete record and decides
+separately what to show. The master switch still wins, and a filter that
+**throws** is ignored — a broken one must never be able to silence the log.
+
 ### Tracing: the `machine` trace, and the levels around it
 
 The FSM is where things happen, so the trace of the FSM **is** the execution

package/dist/gobj-js.cjs.js

@@ -3016,6 +3016,19 @@ var __console_output_enabled__ = true;
 function set_console_log_enabled(enabled) {
 	__console_output_enabled__ = enabled ? true : false;
 }
+var __console_log_filter__ = null;
+function set_console_log_filter(fn) {
+	__console_log_filter__ = typeof fn === "function" ? fn : null;
+}
+function console_wants(level, msg) {
+	if (!__console_output_enabled__) return false;
+	if (!__console_log_filter__) return true;
+	try {
+		return __console_log_filter__(level, msg) ? true : false;
+	} catch (e) {
+		return true;
+	}
+}
 var __in_log_callback__ = false;
 function emit_log_callback(level, msg, hora) {
 	if (__log_callback__ && !__in_log_callback__) {
@@ -3063,9 +3076,9 @@ function log_error(format) {
 	let hora = current_timestamp();
 	if (f_error) {
 		if (f_error === _console.error) {
-			if (__console_output_enabled__) f_error("%c" + hora + " ERROR: " + String(msg), "color:red");
+			if (console_wants("error", msg)) f_error("%c" + hora + " ERROR: " + String(msg), "color:red");
 		} else {
-			if (__console_output_enabled__) _console.error("%c" + hora + " ERROR: " + String(msg), "color:red");
+			if (console_wants("error", msg)) _console.error("%c" + hora + " ERROR: " + String(msg), "color:red");
 			f_error(`${hora} ERROR: ${String(msg)}`);
 		}
 	}
@@ -3076,9 +3089,9 @@ function log_warning(format) {
 	let hora = current_timestamp();
 	if (f_warning) {
 		if (f_warning === _console.warn) {
-			if (__console_output_enabled__) f_warning("%c" + hora + " WARNING: " + String(msg), "color:yellow");
+			if (console_wants("warning", msg)) f_warning("%c" + hora + " WARNING: " + String(msg), "color:yellow");
 		} else {
-			if (__console_output_enabled__) _console.warn("%c" + hora + " WARNING: " + String(msg), "color:yellow");
+			if (console_wants("warning", msg)) _console.warn("%c" + hora + " WARNING: " + String(msg), "color:yellow");
 			f_warning(`${hora} WARNING: ${String(msg)}`);
 		}
 	}
@@ -3088,7 +3101,7 @@ function log_info(format) {
 	let msg = format_log(format);
 	let hora = current_timestamp();
 	if (f_info) {
-		if (__console_output_enabled__) f_info("%c" + hora + " INFO: " + String(msg), "color:cyan");
+		if (console_wants("info", msg)) f_info("%c" + hora + " INFO: " + String(msg), "color:cyan");
 	}
 	emit_log_callback("info", msg, hora);
 }
@@ -3096,7 +3109,7 @@ function log_debug(format) {
 	let msg = format_log(format);
 	let hora = current_timestamp();
 	if (f_debug) {
-		if (__console_output_enabled__) f_debug("%c" + hora + " DEBUG: " + String(msg), "color:silver");
+		if (console_wants("debug", msg)) f_debug("%c" + hora + " DEBUG: " + String(msg), "color:silver");
 	}
 	emit_log_callback("debug", msg, hora);
 }
@@ -3104,12 +3117,12 @@ function trace_msg(format) {
 	let msg = format_log(format);
 	let hora = current_timestamp();
 	if (f_debug) {
-		if (__console_output_enabled__) f_debug("%c" + hora + " MSG: " + String(msg), "color:cyan");
+		if (console_wants("msg", msg)) f_debug("%c" + hora + " MSG: " + String(msg), "color:cyan");
 	}
 	emit_log_callback("msg", msg, hora);
 }
 function trace_json(jn, msg) {
-	if (__console_output_enabled__) {
+	if (console_wants("json", msg)) {
 		if (msg) window.console.warn("=====> " + msg);
 		window.console.dir(jn);
 	}
@@ -6861,6 +6874,7 @@ exports.safeSrc = safeSrc;
 exports.sdata_flag_t = sdata_flag_t;
 exports.send_http_json_post = send_http_json_post;
 exports.set_console_log_enabled = set_console_log_enabled;
+exports.set_console_log_filter = set_console_log_filter;
 exports.set_log_callback = set_log_callback;
 exports.set_remote_log_functions = set_remote_log_functions;
 exports.set_timeout = set_timeout;