Window postMessage()Métodos
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.
Objeto Window Otras extensiones