Where is the syntax for "conditions" documented?

rulrok · April 13, 2025, 6:34pm

Hi, my two cents, but this is very confusing.

Look for the function evaluate_depends_on_value through the repos.

I found that there isn’t a single code piece that handles it, but is somewhat duplicated.

I found it in a few places:

frappe/frappe/blob/e6f729bc6193f88eb83c7cb3b36537f8aa335779/frappe/public/js/form_builder/utils.js#L203


      
          				colsize = 3;
          				break;
          			case "Check":
          				colsize = 1;
          		}
          		return colsize;
          	}
          	return table_columns;
          }
          
          export function evaluate_depends_on_value(expression, doc) {
          	let store = useStore();
          	if (!doc) return;
          
          	let out = null;
          	let parent = store.doc;
          
          	if (typeof expression === "boolean") {
          		out = expression;
          	} else if (typeof expression === "function") {
          		out = expression(doc);

github.com

frappe/frappe/blob/e6f729bc6193f88eb83c7cb3b36537f8aa335779/frappe/public/js/frappe/form/layout.js#L786


      
          				);
          				form_obj.setting_dependency = false;
          				// refresh child fields
          				this.fields_dict[fieldname] && this.fields_dict[fieldname].refresh();
          			} else {
          				form_obj.set_df_property(fieldname, property, value);
          			}
          		}
          	}
          
          	evaluate_depends_on_value(expression) {
          		let out = null;
          		let doc = this.doc;
          
          		if (!doc && this.get_values) {
          			doc = this.get_values(true);
          		}
          
          		if (!doc) {
          			return;
          		}

rulrok · April 13, 2025, 6:34pm

And the eval helper definition is at:

github.com

frappe/frappe/blob/e6f729bc6193f88eb83c7cb3b36537f8aa335779/frappe/public/js/frappe/utils/utils.js#L1065


      
          		$($el).on("click.class_actions", "[data-action]", (e) => {
          			let $target = $(e.currentTarget);
          			let action = $target.data("action");
          			let method = object[action];
          			method ? object[action](e, $target) : null;
          		});
          
          		return $el;
          	},
          
          	eval(code, context = {}) {
          		let variable_names = Object.keys(context);
          		let variables = Object.values(context);
          		code = `let out = ${code}; return out`;
          		try {
          			let expression_function = new Function(...variable_names, code);
          			return expression_function(...variables);
          		} catch (error) {
          			console.log("Error evaluating the following expression:");
          			console.error(code);
          			throw error;