Window postMessage()メソッド

Window 对象参考手册Window オブジェクト

定義と使用方法

postMessage() メソッドは、安全にクロスオリジン通信を実装するために使用されます。

構文

otherWindow.postMessage(message, targetOrigin, [transfer]);

パラメータ 説明
otherWindow 他のウィンドウへの参照。例えば、iframe の contentWindow プロパティ、window.open の実行で返されるウィンドウオブジェクト、または名前付きまたは数値インデックスの window.frames。
message 他の window に送信するデータ。
targetOrigin どのウィンドウがメッセージイベントを受信できるかを指定します。その値は次のいずれかです:*(無制限を意味する)または URI。
transfer オプションで、message と同時に転送される Transferable オブジェクトのリストです。これらのオブジェクトの所有権はメッセージの受信側に移転され、送信側は所有権を保持しなくなります。


ブラウザサポート

Chrome 1 Edge 12 Firefox 8 Safari 4 Opera 9.5

サンプル

送信プログラム

<div> <input id="text" type="text" value="サンプル" /> <button id="sendMessage" >メッセージを送信</button> </div> <iframe id="receiver" src="https://c.example.com/サンプルtest/postMessage_receiver.html" width="300" height="360"> <p>お使いのブラウザは iframe をサポートしていません。</p> </iframe> <script> window.onload = function() { var receiver = document.getElementById('receiver').contentWindow; var btn = document.getElementById('sendMessage'); btn.addEventListener('click', function (e) { e.preventDefault(); var val = document.getElementById('text').value; receiver.postMessage("Hello "+val+"!", "https://c.example.com"); }); } </script>

試してみる »

受信プログラム:https://c.example.com/サンプルtest/postMessage_receiver.html

受信プログラムにはイベントリスナーがあり、"message" イベントをリッスンします。同時に、信頼できる送信元アドレスであることを確認するために、メッセージの発信元アドレスを検証する必要があります。

<div id="recMessage"> Hello World! </div> <script> window.onload = function() { var messageEle = document.getElementById('recMessage'); window.addEventListener('message', function (e) { //message イベントをリッスン alert(e.origin); if (e.origin !== "https://www.example.com") { //メッセージの発信元アドレスを検証 return; } messageEle.innerHTML = "から"+ e.origin +"受信したメッセージ:" + e.data; }); } </script>

試してみる »
  • e.source– メッセージソース、メッセージを送信したウィンドウ/iframe。
  • e.origin– メッセージソースの URI(プロトコル、ドメイン、ポートを含む場合があります)。データソースの検証に使用します。
  • e.data– 送信されたデータ。

Window 对象 参考手册Window オブジェクト その他の拡張