JavaScript Script Engine

This adapter uses Sentry libraries to automatically report exceptions and code errors to the developers. For more details and for information how to disable the error reporting see Sentry-Plugin Documentation! Sentry reporting is used starting with js-controller 3.0.

Executes JavaScript, TypeScript Scripts.

Documentation

• 🇺🇸 Function documentation
• 🇺🇸 Upgrade guide
• 🇩🇪 Funktionsdokumentation
• 🇩🇪 Benutzung
• 🇺🇸 Function block diagrams
• 🇩🇪 Funktionspläne
• Blockly
  • 🇺🇸 Here you can find the description of blockly.
  • 🇩🇪 Hier kann man die Beschreibung von Blockly finden.
  • 🇷🇺 Описание по blockly можно найти здесь.

Changelog

10.4.10 (2026-11-04)

• (@GermanBluefox) Fixed: the unsaved changes of the open scripts were lost, when the list of scripts or the log was hidden or shown again (#1739)
• (@GermanBluefox) Added: animated icons in the editor (@iobroker/gui-components 10.3.16) - start/stop morphs between play and pause and shows a ring until the instance confirmed it, the restart button turns until the script is restarted, folders open with an animation, animated delete, menu arrow and expert mode symbols, a check mark after saving and copying
• (@GermanBluefox) Added: more animations in the editor - the rows of a folder grow and shrink when it is opened and closed, new scripts light up, the colors of the start/stop buttons fade, the Save/Diff/Cancel buttons and new tabs grow to their width, closed tabs shrink, new log lines slide in, the side menu and the log slide in when they are opened, badges jump when their number grows
• (@GermanBluefox) Added: the log shows the number of new lines, while it does not follow them
• (@GermanBluefox) Added: the history dialog can be maximized (button or double click on its title); the width of the version list and the border between the two sides of the diff can be dragged; buttons jump from change to change; "Take over into the editor" is disabled for a version that is the same as the editor
• (@GermanBluefox) Changed: the diffs (history, unsaved changes, AI suggestions) scroll to the first change and show changed indentation too
• (@GermanBluefox) Updated packages

10.4.9 (2026-11-02)

• (@GermanBluefox) Fixed: the restart button of the editor did nothing for a running script since 10.4.7 (#2423)
• (@GermanBluefox) Added: OpenRouter, if it is chosen in the system-wide AI settings of admin (@iobroker/ai-core 0.0.6, @iobroker/ai-gui 0.0.5)
• (@GermanBluefox) Added: function block diagrams - selection blocks SEL, MUX and LIMIT; the PID block got HOLD, a dead band DB, a manual mode (MAN, YMAN) and INV to reverse its direction
• (@GermanBluefox) Changed: function block diagrams - RST of the PID block puts out Y = 0 (or the limit nearest to it) instead of the P part (#2426)

10.4.8 (2026-10-27)

• (@GermanBluefox) Fixed: setting scriptEnabled to true restarts an already running script again (#2417)
• (@GermanBluefox) Fixed: a script that stopped itself with stopScript() (or was restarted with runScript()) kept running and scriptEnabled stayed true
• (@GermanBluefox) Added: the AI uses the AI settings of the system that are set up once in admin (System settings → AI) - for new instances and for instances without own keys
• (@GermanBluefox) Fixed: a script started via the execute message wrote scriptEnabled.__execute_<n> without object, when the instance stopped or the setState limit stopped the script before the output was collected

10.4.7 (2026-10-23)

• (@GermanBluefox) Fixed: the AI chat did not see the open script when it was a Blockly script, and an outdated version of it after unsaved edits; the open script is now always the context when no other script is mentioned
• (@GermanBluefox) Fixed: the code mode of the AI chat ignored the open script and wrote an unrelated new script for a request like "turn on the logs in the script"

10.4.6 (2026-10-19)

• (@GermanBluefox) Fixed: false "Cannot redeclare block-scoped variable" (TS2451) warnings for consts that are declared in several scripts
• (@GermanBluefox) Fixed: subscribeObject()/onObject() and the rule trigger "On object change" never fired for a pattern with *
• (@GermanBluefox) Fixed: a change of a TypeScript script could be ignored after its compilation result could not be stored

License

The MIT License (MIT)

Copyright (c) 2014-2026 bluefox dogafox@gmail.com
Copyright (c) 2014 hobbyquaker

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.