The previous cleanup implementation only iterated objects with
type === 'channel' and read entity_id from native. Both assumptions
break for entities written by older adapter versions: those exist as
flat states under hass.0.entities.<domain>.<entity_id>.<sub> with no
parent channel object and often no native.entity_id.
The admin UI shows them as folders because sub-states are present, but
`iobroker object get hass.0.entities.text.iob_…` returns "not found".
So the cleanup found nothing to delete even with valid patterns.
Refactor: iterate every object under entities.*, derive entity_id from
the first two path components after the namespace prefix, group by
entity_id, then delete each id individually (longest first, no
recursive flag — there is no parent to recurse into). Custom-config
protection still applies per entity group.
Works for both old flat-state and new channel+sub-state structures.
When enabled, on each adapter start the adapter scans all existing
hass.0.entities.* channels and deletes those whose entity_id matches
any of the configured excludePatterns. This complements the existing
filter (which only prevents new objects from being created) by also
cleaning up objects that were synced before the filter was activated
or before the patterns were extended.
Safety:
- Channels (and any of their sub-states) holding common.custom config
(history/influxdb/sql) are kept and a warning is logged so the user
can decide manually.
- Existing deleteStaleObjects() 50% sanity-guard is intentionally NOT
applied here — the user explicitly opted in to the cleanup.
- Per-id deletion only logs when verboseFilterLog is also active.
Default is false (opt-in). Adds new admin checkbox + i18n keys for all
11 languages (machine translations for non-en/de still pending).
New `verboseFilterLog` boolean (default `false`). When enabled, the initial
sync logs every excluded entity_id individually on INFO level. This is
useful when iterating on exclude patterns or verifying that the filter
catches the intended entities.
The verbose output is intentionally limited to the first sync. Subsequent
debouncedSync() calls only emit the aggregate count to avoid log spam
during normal operation. Live `state_changed` events for filtered entities
remain on DEBUG.
Admin UI gets a checkbox below the patterns field; i18n keys added for
all 11 supported languages.
Adapter now consults the exclude-pattern list (new `native.excludePatterns`
config option, multi-line string) at two points:
- `parseStates()` skips matching entities entirely. They are not registered
as ioBroker objects and no state is written. A summary INFO line reports
the count when the filter dropped anything from a sync.
- The `state_changed` event handler short-circuits matching live updates
with a DEBUG line, so a filtered entity that still emits state changes
in HA does not cause any churn in ioBroker.
Patterns are parsed once at adapter start: trimmed, empty lines and lines
starting with `#` are dropped. An empty resulting list means the filter is
inactive — adapter behaviour is then identical to the previous version.
Default config ships with example comments only, so existing installations
see no functional change after the update.
Glob-based entity_id matcher used by the upcoming exclude-filter feature.
Single wildcard `*` (matches any sequence including dots), all other characters
matched literally with regex metacharacters escaped. Case-sensitive, anchored.
Empty pattern array always returns false, so the helper is a no-op when the
adapter is not configured to filter anything.
New mocha unit-test suite invoked via `npm run test:unit` (separate from the
existing js-controller-backed test:integration).
When Home Assistant reports a new attribute for an entity after the initial
sync (e.g. source_list or media_channel appearing when a media player becomes
active), setState was called without a corresponding ioBroker object — causing
'has no existing object' warnings.
Fix: check if the attribute object exists in hassObjects before calling
setState. If missing, create it on-the-fly via setForeignObjectAsync before
writing the state.
GermanBluefox
mokusone
Torsten Pattberg
Matthias KleineandGitHub