Channel Messaging API通过MessageChannel创建双端口通道实现跨源双向通信。主页面创建channel，将port1发给iframe，双方用各自端口收发消息，如主页面postMessage、iframe监听并回复。相比postMessage，其优势为通信无需校验origin、更安全高效，适用于父子窗口高频交互场景。
在现代Web开发中，跨文档通信（如iframe之间、弹窗窗口与主页面之间）是常见需求。JavaScript的Channel Messaging API提供了一种安全、高效的双向通信机制，特别适用于不同源（cross-origin）场景下的数据传递。
什么是Channel Messaging API？
Channel Messaging API基于MessageChannel接口，它创建一个消息通道，包含两个端口（port1 和 port2）。每个端口可以发送和接收消息，通过将一个端口传递给另一个文档，实现双向通信。
基本使用步骤
要实现跨文档通信，需完成以下核心步骤：
- 在主文档中创建MessageChannel实例
- 将其中一个端口（如port2）发送给目标文档（通过postMessage）
- 双方通过各自的端口监听和发送消息
示例：主页面与iframe通信
立即学习“Java免费学习笔记（深入）”；
// 主页面
const iframe = document.querySelector('iframe');
const channel = new MessageChannel();
// 当iframe加载完成后发送port1
iframe.onload = function() {
// 将port1发送给iframe
iframe.contentWindow.postMessage('init', '*', [channel.port1]);
};
// 使用port2接收来自iframe的消息
channel.port2.onmessage = function(event) {
console.log('收到来自iframe的消息:', event.data);
};
// 向iframe发送消息
channel.port2.postMessage('你好，iframe！');
对应的iframe页面代码：
// iframe内部
let port = null;
// 监听来自主页面的port1
window.addEventListener('message', function(event) {
if (event.ports && event.ports[0]) {
port = event.ports[0];
// 开始监听主页面消息
port.onmessage = function(e) {
console.log('收到来自主页面的消息:', e.data);
// 回复消息
port.postMessage('收到，谢谢！');
};
}
});
// 向主页面发送消息（需等待port被赋值）
setTimeout(() => {
if (port) {
port.postMessage('iframe已准备就绪');
}
}, 100);
适用场景与优势
该API适用于以下情况：
- 父子窗口或iframe之间的结构化通信
- 需要高频率、低延迟的数据交换（如实时协作）
- 避免频繁使用window.postMessage带来的安全校验开销
相比直接使用postMessage，Channel Messaging的优势在于一旦通道建立，通信不再需要指定目标origin，且消息仅在通道内流通，更安全。
注意事项
使用时注意以下几点：
- 确保目标文档正确接收并保存端口引用
- 通信前应有初始化握手过程
- 使用完后可调用port.close()释放资源
- 注意浏览器兼容性，现代主流浏览器均支持
基本上就这些。掌握MessageChannel能让你在复杂多文档应用中实现清晰、可靠的通信逻辑。不复杂但容易忽略细节。
