网页 window.open 连点两次为什么串到同一个窗口：HarmonyOS 7 ArkWeb name 路由怎么防重入

网页 window.open 连点两次为什么串到同一个窗口HarmonyOS 7 ArkWeb name 路由怎么防重入网页连续两次调用window.open(url, preview)应用侧创建了两个窗口但后一次内容跑进前一个窗口关闭其中一个后另一个也失去控制器。官方文档说明 ArkWeb 会根据 name 查找已绑定 Web 组件而 API 26 的onWindowNewExt()还带来 NavigationPolicy 与 WindowFeatures。工程上要把 name、请求代际和宿主生命周期放进同一套路由而不能每次回调都无条件 new 窗口。证据边界文中 API 26/HarmonyOS 7 能力以华为当前官方文档为准代码中的应用侧状态与一致性断言已在本机 Node.js 环境执行。当前本机 SDK 为 API 24且没有连接 HarmonyOS 7 真机因此本文不声称完成 API 26 编译、真机性能或上架审核验证。先把故障钉在可复现步骤上在测试网页中快速执行两次同名window.open再执行一次不同 name 的打开请求。应用侧记录 openerId、windowName、requestId、navigationPolicy、windowFeatures 和 hostState。复现目标是同名请求重用既有宿主不同 name 隔离关闭回调只能释放对应绑定。案例一预览窗口应重用而不是复制同一个preview已经绑定时第二次请求更新其导航目标并激活窗口。若仍创建新宿主ArkWeb 的 name 绑定与应用窗口表会发生分歧。案例二支付窗口必须拒绝跨来源复用即使 name 相同只要 opener 或受信来源不同就不能静默复用已有宿主。路由表应把业务安全域纳入 key并在不满足策略时拒绝或新建隔离窗口。先分清同名复用和重复回调onWindowNewExt()与onWindowNew()同时配置时官方说明只触发增强接口。不要为了兼容而在两个回调里都创建窗口。收到增强事件后先查 name 绑定再核对 opener 和策略最后决定复用、隔离或拒绝。窗口表要保存“谁能关闭谁”路由记录至少包含 windowName、hostWindowId、webControllerId、openerId、generation 和 state。关闭事件带 requestId 进入时只能关闭仍由这一代请求拥有的宿主迟到的旧 close 不能把新页面一起销毁。WindowFeatures 是约束输入不是绝对命令网页给出的窗口位置和大小需要经过设备、自由多窗状态与产品规则校验。应用可以映射成安全范围不应把网页参数直接当作系统窗口最终几何结果。可直接放进工程的接口片段Web({src:$rawfile(window.html),controller:this.controller}).multiWindowAccess(true).onWindowNewExt((event){// 读取 event 中的增强导航策略与窗口特征交给受控路由表。this.popupRouter.route(event)})// 当同时注册新旧回调时以官方文档所述的 onWindowNewExt 行为为准。上面是围绕官方接口位置整理的 ArkTS/工程片段仍需在 API 26 工具链和目标设备上编译验证。为避免把接口示意当成证据应用侧关键判定另写成可执行断言classPopupRouter{hostsnewMap();route(name,opener,request){constkeyopener::name;constoldthis.hosts.get(key);if(old){old.requestrequest;returnreuse;}this.hosts.set(key,{request,state:open});returncreate;}}constrnewPopupRouter();if(r.route(preview,main,r1)!create)thrownewError(首开失败);if(r.route(preview,main,r2)!reuse)thrownewError(同名窗口未复用);if(r.route(preview,other,r3)!create)thrownewError(跨来源错误复用);方案不是越复杂越好方案适用场景放弃它的理由每回调新建窗口一次性演示页连点和同名请求制造重复宿主只按 name 复用单来源工具跨来源安全域混淆来源域 name 路由正式多窗 Web 应用需要生命周期与代际管理采用来源安全域与 name 组成的路由 key并把 WindowFeatures 当作布局建议。这样既符合网页同名窗口的直觉又不会让不可信来源复用敏感宿主。最终交付物一张 popup 路由表、可执行的重复请求断言以及窗口关闭回收规则。接入后所有onWindowNewExt请求都走统一入口。同一 opener 的同名窗口只保留一个宿主。不同 opener 不共享敏感窗口。旧 close 回调不能关闭新一代宿主。窗口位置大小先做设备边界校验。不同时在新旧回调里创建窗口。多窗口问题常被误判成 Web 内容问题。先把 name、来源和窗口所有权路由清楚连点、重入和关闭竞态都会有确定答案。先画出同名窗口的竞态时间线问题通常发生在两个回调几乎同时进入应用层时请求 A 还没完成宿主绑定请求 B 已经看到 name 相同并开始复用。如果窗口表只有 name没有 requestId 和绑定阶段B 就可能拿到一个尚未就绪的控制器。时刻请求name宿主状态正确动作T0Apreviewabsent建立 pending 记录T1Bpreviewpending(A)合并或排队不能再创建T2Apreviewbound绑定控制器并提交导航T3Bpreviewbound(A)激活既有窗口并更新目标T4close(A)previewclosing只释放 A 当前代际这张表把“偶现串窗”变成可记录的状态转换。日志至少保留 openerId、windowName、requestId、generation、hostId、navigationPolicy 和最终动作。一个可复用的 name 路由器typeHostStatepending|bound|closingtypeHostRecord{name:string;requestId:string;generation:number;state:HostState;targetUrl:string}classNamedWindowRouter{privaterecordsnewMapstring,HostRecord()begin(name:string,requestId:string,targetUrl:string):HostRecord{constoldthis.records.get(name)if(oldold.state!closing){old.targetUrltargetUrl;returnold}constnext{name,requestId,targetUrl,generation:(old?.generation??0)1,state:pendingasHostState}this.records.set(name,next)returnnext}bind(name:string,requestId:string):boolean{constitemthis.records.get(name)if(!item||item.requestId!requestId||item.state!pending)returnfalseitem.statebound;returntrue}close(name:string,generation:number):boolean{constitemthis.records.get(name)if(!item||item.generation!generation)returnfalsethis.records.delete(name);returntrue}}requestId 防止迟到回调绑定到新请求generation 防止旧窗口的关闭通知误删新宿主。真实 ArkWeb 控制器仍要按官方接口生命周期接入这段模型只验证应用层路由规则。三条日志就能判断是哪一层串了同一 name 同时出现两个 create-host应用层没有合并 pending 请求。bind 的 requestId 与当前记录不同迟到回调污染了新代际。关闭一个窗口后记录表直接按 name 删除旧关闭事件没有校验 generation。最终验收覆盖快速双击、不同 name 并发、创建失败回滚、旧窗口迟到关闭和应用进程恢复五组路径。官方资料ArkWeb 在新窗口中打开页面Web 组件跨窗口迁移HarmonyOS 7 升级适配指南网页 window.open 连点两次为什么串到同一个窗口HarmonyOS 7 ArkWeb name 路由怎么防重入网页连续两次调用window.open(url, preview)应用侧创建了两个窗口但后一次内容跑进前一个窗口关闭其中一个后另一个也失去控制器。官方文档说明 ArkWeb 会根据 name 查找已绑定 Web 组件而 API 26 的onWindowNewExt()还带来 NavigationPolicy 与 WindowFeatures。工程上要把 name、请求代际和宿主生命周期放进同一套路由而不能每次回调都无条件 new 窗口。证据边界文中 API 26/HarmonyOS 7 能力以华为当前官方文档为准代码中的应用侧状态与一致性断言已在本机 Node.js 环境执行。当前本机 SDK 为 API 24且没有连接 HarmonyOS 7 真机因此本文不声称完成 API 26 编译、真机性能或上架审核验证。先把故障钉在可复现步骤上在测试网页中快速执行两次同名window.open再执行一次不同 name 的打开请求。应用侧记录 openerId、windowName、requestId、navigationPolicy、windowFeatures 和 hostState。复现目标是同名请求重用既有宿主不同 name 隔离关闭回调只能释放对应绑定。案例一预览窗口应重用而不是复制同一个preview已经绑定时第二次请求更新其导航目标并激活窗口。若仍创建新宿主ArkWeb 的 name 绑定与应用窗口表会发生分歧。案例二支付窗口必须拒绝跨来源复用即使 name 相同只要 opener 或受信来源不同就不能静默复用已有宿主。路由表应把业务安全域纳入 key并在不满足策略时拒绝或新建隔离窗口。先分清同名复用和重复回调onWindowNewExt()与onWindowNew()同时配置时官方说明只触发增强接口。不要为了兼容而在两个回调里都创建窗口。收到增强事件后先查 name 绑定再核对 opener 和策略最后决定复用、隔离或拒绝。窗口表要保存“谁能关闭谁”路由记录至少包含 windowName、hostWindowId、webControllerId、openerId、generation 和 state。关闭事件带 requestId 进入时只能关闭仍由这一代请求拥有的宿主迟到的旧 close 不能把新页面一起销毁。WindowFeatures 是约束输入不是绝对命令网页给出的窗口位置和大小需要经过设备、自由多窗状态与产品规则校验。应用可以映射成安全范围不应把网页参数直接当作系统窗口最终几何结果。可直接放进工程的接口片段Web({src:$rawfile(window.html),controller:this.controller}).multiWindowAccess(true).onWindowNewExt((event){// 读取 event 中的增强导航策略与窗口特征交给受控路由表。this.popupRouter.route(event)})// 当同时注册新旧回调时以官方文档所述的 onWindowNewExt 行为为准。上面是围绕官方接口位置整理的 ArkTS/工程片段仍需在 API 26 工具链和目标设备上编译验证。为避免把接口示意当成证据应用侧关键判定另写成可执行断言classPopupRouter{hostsnewMap();route(name,opener,request){constkeyopener::name;constoldthis.hosts.get(key);if(old){old.requestrequest;returnreuse;}this.hosts.set(key,{request,state:open});returncreate;}}constrnewPopupRouter();if(r.route(preview,main,r1)!create)thrownewError(首开失败);if(r.route(preview,main,r2)!reuse)thrownewError(同名窗口未复用);if(r.route(preview,other,r3)!create)thrownewError(跨来源错误复用);方案不是越复杂越好方案适用场景放弃它的理由每回调新建窗口一次性演示页连点和同名请求制造重复宿主只按 name 复用单来源工具跨来源安全域混淆来源域 name 路由正式多窗 Web 应用需要生命周期与代际管理采用来源安全域与 name 组成的路由 key并把 WindowFeatures 当作布局建议。这样既符合网页同名窗口的直觉又不会让不可信来源复用敏感宿主。最终交付物一张 popup 路由表、可执行的重复请求断言以及窗口关闭回收规则。接入后所有onWindowNewExt请求都走统一入口。同一 opener 的同名窗口只保留一个宿主。不同 opener 不共享敏感窗口。旧 close 回调不能关闭新一代宿主。窗口位置大小先做设备边界校验。不同时在新旧回调里创建窗口。多窗口问题常被误判成 Web 内容问题。先把 name、来源和窗口所有权路由清楚连点、重入和关闭竞态都会有确定答案。官方资料ArkWeb 在新窗口中打开页面Web 组件跨窗口迁移HarmonyOS 7 升级适配指南