ctx.getHost() 返回当前宿主暴露的内部对象。它的 TypeScript 类型是 unknown,不同宿主返回的字段也不同。

API

方法返回值说明
getHost()unknown返回宿主专用对象

案例:仅用于诊断宿主模式

输入: 同一扩展分别运行在完整引擎和轻量 Preview 中。
const host = ctx.getHost();

const mode =
  typeof host === "object" && host !== null && "mode" in host
    ? String(host.mode)
    : "unknown";

console.log(mode);
输出: 完整引擎中通常输出:
engine
轻量 Preview 中通常输出:
preview
getHost() 不是稳定的跨宿主契约。业务扩展不应依赖 application、store 等内部字段;这些字段可能随 Studio 版本变化。需要稳定能力时,应优先使用其他 ctx.* 接口。