You need to enable JavaScript to run this app. 在Chromium 88中如何添加供JavaScript调用、挂载到window.external的C++函数
优惠活动
大模型
产品
解决方案
定价
更多

在Chromium 88中如何添加供JavaScript调用、挂载到window.external的C++函数

Chromium 88 定制浏览器:JS调用自定义C++能力的源码修改与window.external挂载指南

注:该问题对应的技术实现说明更新于2020年11月27日,匹配Chromium 88的源码版本特性。

需修改/新增的核心源码文件

基于Chromium 88的标准目录结构,涉及的核心修改点按模块拆分如下:

  • 渲染进程Blink绑定层
    • third_party/blink/renderer/modules/external/external.idl:原生window.external的JS接口定义文件
    • third_party/blink/renderer/modules/external/external.cc:window.external对应的C++实现类
    • third_party/blink/renderer/core/frame/local_dom_window.cc:window对象初始化时绑定external实例的逻辑
  • 跨进程通信层
    • content/public/common/renderer.mojom:渲染进程与浏览器进程的Mojo通信接口定义
    • content/renderer/render_frame_impl.cc:渲染帧侧的消息路由转发逻辑
    • content/browser/renderer_host/render_frame_host_impl.cc:浏览器进程侧的渲染帧消息接收入口
  • 业务逻辑层
    • 可根据需求新建自定义消息处理类(如custom_native_message_handler.cc/.h),仅需在对应模块的BUILD.gn中添加编译规则即可参与编译

window.external挂载自定义C++函数的完整实现流程

Chromium 88的多进程架构决定了JS运行在渲染进程,原生C++业务逻辑通常运行在浏览器进程,两者通过Mojo通道通信,具体步骤如下:

  1. 定义JS侧可见的接口声明
    打开原生external.idl文件,参照现有方法的IDL语法,新增要暴露给JS的自定义方法。例如要实现让JS调用window.external.postMessageToBrowser(content),就直接在IDL中声明该方法的入参、返回值类型,Blink编译时会自动生成对应的V8绑定胶水代码,无需手写底层V8适配逻辑。

    注意:IDL中使用的类型必须是Web IDL规范支持的原生类型(字符串、数字、布尔值等),不能直接传入自定义C++类实例。

  2. 补全渲染进程侧的转发逻辑
    在external.cc中实现刚才在IDL里声明的方法:不要在这里直接写业务逻辑,仅需要获取当前渲染帧的Mojo通信通道,把JS传入的参数序列化后通过通道发送到浏览器进程即可。实现时要持有渲染帧的弱引用,避免页面销毁后悬空指针导致渲染进程崩溃。
  3. 完善Mojo跨进程接口定义
    在对应的mojom文件中新增自定义的通信方法,指定入参的序列化规则,绑定到对应渲染帧的消息路由上,确保消息能准确从渲染进程投递到浏览器进程的对应处理模块。
  4. 实现浏览器进程侧的业务逻辑
    在render_frame_host_impl.cc或自定义的消息处理类中,实现Mojo接口的接收方法——这部分就是真正的C++业务逻辑实现空间:收到网页发来的消息后,可以调用系统API、读写本地文件、触发浏览器自定义功能,也可以反向通过Mojo通道向网页推送消息。
  5. 增加安全校验逻辑
    必须在调用入口加页面来源校验:仅放行在白名单内的页面源才能调用自定义C++接口,避免任意第三方网页触发原生能力造成安全风险。
  6. 编译规则适配
    把新增的源文件、IDL文件加到对应模块的BUILD.gn编译列表中,重新执行gn生成流程完成全量编译。

避坑提示:Chromium 88已基本淘汰旧的同步IPC机制,跨进程调用尽量使用异步Mojo实现,避免同步等待导致渲染进程无响应,不要照搬CEF或老版本Chromium的单进程绑定实现逻辑。


内容的提问来源于stack exchange,提问作者windowswind

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.16 13:15:04