identity.logout() 非正式提议

本页不是正式 API 规范；它记录仅撤销当前 appId 会话的候选契约。

请求退出当前 appId 的应用会话，并由可信 UI 明确说明影响范围。该方法不得改变其他应用、其他设备或平台网站的会话。

Syntax

const result = await host.identity.logout(options?);

Parameters

options?: CallOptions：可选取消信号；无业务参数。

Return value

{ authenticated: false } | null。调用线性化时本 appId 已退出则直接返回前者而不打开 UI；否则退出完成返回前者，用户取消可信确认返回 null。

Examples

logoutButton.onclick = async () => {
  const result = await host.identity.logout();
  if (result) renderAccountControls(result.authenticated);
};

Errors

activation-required、denied、platform-unavailable。用户取消确认不抛错。

取消与应用会话撤销必须线性排序：取消先发生则以 cancelled 失败且不得撤销；撤销先发生则返回 { authenticated: false }，后到的取消不改变结果。

Requirements

• 能力：host:identity.logout
• 可信用户激活：必须；仅改变状态时显示确认
• 可取消：是；取消不得影响其他会话
• 影响范围：仅当前 appId 的应用会话
• 信任档位：green

See also

identity.status()、identity.login()