Window postMessage()メソッド
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 オブジェクト その他の拡張