env.change event

通知一个或多个环境字段发生变化。事件不携带新值；guest 重新调用 snapshot() 获取一致状态。

Event payload

{ changedFields: EnvironmentField[] }

Examples

host.events.on('env.change', async ({ changedFields }) => {
  const env = await host.env.snapshot();
  if (changedFields.includes('colorScheme')) ui.setDark(env.colorScheme === 'dark');
});

Delivery rules

短时间内的变化可以合并；事件不带高精度时间戳，也不能用事件次数追踪用户。

See also

env.snapshot()、env