env.snapshot()

返回主题、语言、粗化时区、无障碍偏好、连接提示和安全区域的一致快照。

Syntax

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

Return value

{
  colorScheme,
  locale,
  timeZone,
  accessibility,
  connectivity,
  safeArea,
  precision
}

字段和枚举见 env API。

Examples

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

Privacy

不返回 User-Agent、设备型号、硬件能力、序列号或精确网络类型。precision 如实说明粗化级别。

Errors

• HostError("unavailable")：宿主暂时无法形成一致快照。
• HostError("internal")：宿主读取或规范化环境状态失败。

See also

env.change、canvas.resize