I’m working on documenting YAML rules and rule templates, and I think I’m closed to finished. However, I thought that it would be nice to include a JavaScript rule template example, but I have no idea how to actually write valid JavaScript rules. I’m worried that the example is a bit terrible to, …

@rlkoshak I have a feeling that you’re one of the potential people that could help out here.

With some help from Gemini, I got to this, which at least runs without errors. version: 1 rules: "3699580b09": template: light-control label: Light Control Test description: Controls lights based on time. config: light_item: DemoSwitch end_time: 01:00 start_time:…

[image] Nadahar: I’d also only want the command to be sent if the state isn’t already correct, to not hammer the Item with commands. JSScripting library has a built-in option for this: sendCommandIfDifferent sendCommandIfDifferent(value) → {boolean} - Item - openHAB JS Item stat…

[image] JustinG: JSScripting library has a built-in option for this: sendCommandIfDifferent Thanks, I’ll see if I can figure that out. [image] JustinG: The only thing about it seems a little off is the every minute cron trigger. I would think that a more common example for beginners woul…

[image] Nadahar: The point is that it’s an example of how to use a rule template, so I want it to be simple to not “take focus away” from the basics. Linking the trigger to a property of the template is a pretty basic thing for a template. What I would do with this example: version: 1 rules…

[image] rlkoshak: give it a meaningful UID and name This was a generated rule, the UID and labels aren’t the ones used in the documentation. [image] rlkoshak: an Item trigger is going to be much more commonly used than a cron trigger so that would make a better trigger for the example …

[image] Nadahar: That said, if I wanted to have a simple template for switching lights on and off at specific times, I’m not sure that I wouldn’t just use a cron timer. What would the Item be? In that case just trigger at the start time and the end time version: 1 rules: "light-control-tem…

The point isn’t if the rules are useful, but if the mechanisms of using templates are clear. So, I’ve modified it to use the sensor item. I actually have a somewhat similar rule in use (except that it gradually adjusts the light levels), and I think it’s actually run by a cron trigger. The reason f…

Updated preview is ready: [image] Example - YAML Rule Templates This page describes the ruleTemplates element for YAML Configuration. | a vendor and technology agnostic open source automation software for your home

[image] Nadahar: (except that it gradually adjusts the light levels), and I think it’s actually run by a cron trigger. That makes sense to use a cron trigger for that because the light needs to change brightness/color over time. But this is a simple ON/OFF at a certain time. So unless there i…

Help making a JavaScript example

Development

Nadahar (Nadar) July 3, 2026, 5:20pm 12

Anybody that wants to help review this so that we can get it into the documentation, the PR is here:

Except for that, thank you both for the help, I consider this “resolved”.