Window postMessage()Métodos

Window 对象参考手册Objeto Window

Definición y uso

El método postMessage() se utiliza para implementar la comunicación entre orígenes de forma segura.

Sintaxis

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

Parámetros Descripción
otherWindow Una referencia a otra ventana, por ejemplo, la propiedad contentWindow de un iframe, el objeto de ventana devuelto por window.open, o window.frames con nombre o índice numérico.
message Los datos que se enviarán a otra window.
targetOrigin Especifica qué ventanas pueden recibir el evento de mensaje; su valor puede ser*(sin restricciones) o un URI.
transfer Opcional, es una lista de objetos Transferable que se transfieren junto con message. La propiedad de estos objetos se transferirá al receptor del mensaje, y el remitente ya no conservará la propiedad.


Compatibilidad del navegador

Chrome 1 Edge 12 Firefox 8 Safari 4 Opera 9.5

Ejemplos

Programa de envío

<div> <input id="text" type="text" value="Ejemplo" /> <button id="sendMessage" >Enviar mensaje</button> </div> <iframe id="receiver" src="https://c.example.com/ejemplotest/postMessage_receiver.html" width="300" height="360"> <p>Tu navegador no soporta 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>

Pruébalo »

Programa de recepción: https://c.example.com/ejemplotest/postMessage_receiver.html

El programa receptor tiene un detector de eventos que escucha el evento "message", y también debemos verificar la dirección de origen del mensaje para garantizar que sea una dirección de envío confiable.

<div id="recMessage"> Hello World! </div> <script> window.onload = function() { var messageEle = document.getElementById('recMessage'); window.addEventListener('message', function (e) { //Escuchar el evento message alert(e.origin); if (e.origin !== "https://www.example.com") { //Verificar la dirección de origen del mensaje return; } messageEle.innerHTML = "desde"+ e.origin +"Mensaje recibido:" + e.data; }); } </script>

Pruébalo »
  • e.source– Origen del mensaje, la ventana/iframe que envió el mensaje.
  • e.origin– URI de la fuente del mensaje (puede incluir protocolo, dominio y puerto), utilizada para verificar la fuente de los datos.
  • e.data– Los datos enviados.

Window 对象 参考手册Objeto Window Otras extensiones