Channel Messaging API

Channel Messaging API 讓同屬一份文件不同瀏覽環境的兩份程式腳本 (如兩個 IFrame、或主頁面和 IFrame、文件和 SharedWorker、或兩個 worker)，也能夠經由雙向 channel (通道) 兩端的 port (連接阜) 直接傳遞訊息互相溝通。

Channel 訊息概念與使用情境

MessageChannel() 建構子產生 channel， 一但生成了，便可以存取 channel 兩端的 port: MessageChannel.port1 和 MessageChannel.port2，這兩個屬性會回傳 domxref("MessagePort")}} objects.)。建立 channel 的 app 使用 port1，另一端用 port2，利用 window.postMessage 方法帶入參數，向 port2 傳送訊息以及移轉物件 (這裡也就是只 port)。

一但可移轉物件被移轉後，前任擁有者便失去所有權，例如當 port 移轉出去後，原本持有該 port 的環境便不能再使用之。目前可移轉物件只有 ArrayBuffer 以及 MessagePort。

另一端的瀏覽環境則藉由 MessagePort.onmessage 監聽訊息、從訊息事件物件的 data 屬性擷取訊息資料，然後再呼叫 MessagePort.postMessage 回傳訊息。

如果想關閉訊息 channel，則呼叫 MessagePort.close。

更多 API 使用細節請見 Using channel messaging。

Channel 訊息介面

MessageChannel

生成一個新的 message channel。

MessagePort

控制 port，用來傳送和監聽訊息。

PortCollection

MessagePorts 陣列，實驗性質方案；用來同時廣播到多個訊息 port。

範例

• Github 上有 channel messaging basic demo (run it live too)，一個簡單示範主頁和 <iframe> 間的訊息溝通。
• 還有 multimessaging demo (run this live)，較為複雜的例子。

標準規範

瀏覽器相容性

延伸閱讀

• Using channel messaging
• Web Workers API
• Broadcast Channel API