`env.snapshot()`

返回主题、粗化语言、当前 UTC offset 和无障碍偏好的一致快照。

Syntax

const environment = await host.env.snapshot();

无。

{
  colorScheme,
  locale,
  timeZoneOffsetMinutes,
  accessibility
}

字段和枚举见 env API。

返回值是线性化快照：在调用开始与返回之间存在一个逻辑时点，四组字段都等于该时点状态；不得逐字段拼接出从未同时存在的组合。

const env = await host.env.snapshot();
ui.setDark(env.colorScheme === 'dark');
ui.setReducedMotion(env.accessibility.reducedMotion);

不返回 User-Agent、设备型号、硬件能力、序列号、连接状态、时区名称或地区。精度固定在模块契约中，不另设可变 precision 字段。

特有错误：denied、unavailable、limit-exceeded。unavailable 表示宿主暂时无法形成一致快照；不符合封闭成功 schema 的结果由绑定按公共 protocol-error 拒绝，宿主内部不变量失败使用公共 internal。