Window postMessage()Methode

Window 对象参考手册Window-Objekt

Definition und Verwendung

Die Methode postMessage() wird verwendet, um Cross-Origin-Kommunikation sicher zu implementieren.

Syntax

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

Parameters Beschreibung
otherWindow Eine Referenz auf ein anderes Fenster, wie die contentWindow-Eigenschaft eines iframes, das von window.open zurückgegebene window-Objekt oder ein benanntes oder numerisch indiziertes window.frames.
message Die an das andere Fenster zu sendenden Daten.
targetOrigin Legt fest, welche Fenster das message-Ereignis empfangen können. Sein Wert kann*(was keine Einschränkungen bedeutet) oder ein URI sein.
transfer Optional. Eine Liste von Transferable-Objekten, die zusammen mit der Nachricht übergeben werden. Das Eigentum an diesen Objekten wird auf den Empfänger der Nachricht übertragen, und der Absender behält das Eigentum nicht länger.


Browser-Unterstützung

Chrome 1 Edge 12 Firefox 8 Safari 4 Opera 9.5

Beispiele

Absender

<div> <input id="text" type="text" value="Beispiel" /> <button id="sendMessage" >Nachricht senden</button> </div> <iframe id="receiver" src="https://c.example.com/exampletest/postMessage_receiver.html" width="300" height="360"> <p>Ihr Browser unterstützt keine iframes.</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>

Ausprobieren »

Empfänger: https://c.example.com/exampletest/postMessage_receiver.html

Der Empfänger hat einen Event-Listener, der auf das "message"-Event hört, und wir müssen außerdem den Ursprung der Nachricht überprüfen, um sicherzustellen, dass es ein vertrauenswürdiger Absender ist.

<div id="recMessage"> Hallo Welt! </div> <script> window.onload = function() { var messageEle = document.getElementById('recMessage'); window.addEventListener('message', function (e) { //Auf das message-Event lauschen alert(e.origin); if (e.origin !== "https://www.example.com") { //Ursprung der Nachricht überprüfen return; } messageEle.innerHTML = "from"+ e.origin +"Nachricht empfangen:" + e.data; }); } </script>

Ausprobieren »
  • e.source– Die Nachrichtenquelle, das window/iframe, das die Nachricht gesendet hat.
  • e.origin– Die URI der Nachrichtenquelle (kann Protokoll, Domain und Port enthalten), wird verwendet, um die Datenquelle zu überprüfen.
  • e.data– Die gesendeten Daten.

Window 对象 参考手册Window-Objekt Andere Erweiterungen