ime.ended event

输入法会话因 guest 关闭、失焦、绘图面销毁或不可恢复错误而永久结束时发送一次。

Event payload

{
  handle: Handle<ime-session, rw, app-context, focus>
  reason: "closed" | "lost-focus" | "canvas-destroyed" | "error"
}

Examples

host.events.on('ime.ended', ({ handle, reason }) => {
  if (handle !== session) return;
  session = null;
  editor.finishComposition(reason === 'closed' ? 'commit' : 'cancel');
});

Delivery rules

• 事件送达时句柄已经失效。
• 应用声明本事件时，每个成功打开的会话恰好发送一次 ended；重复 closeSession 不产生重复事件。
• 应用同时声明 ime.composition 时，活动合成必须先以 commit 或 cancel 事件结束，再发送 ended；未声明时只抑制该通知，不保留悬空的底层合成状态。

Requirements

• 事件声明：ime.ended
• 来源：ime-session 句柄的终止事件
• 信任档位：继承 ime.openSession 的 green

See also

ime.closeSession()、ime.composition