PostMessager 0.4

PostMessager is a MooTools plugin that acts as a wrapper for the window.postMessage API which is available in IE8+, Firefox 3.1+, Opera 9+, Safari, and Chrome. PostMessager also normalizes the onMessage event for use within MooTools.



Details

Author
David Walsh
Current version
0.4
GitHub
darkwing/PostMessager
Downloads
5480
Category
Request
Tags
Report
GitHub Issues

Releases


Dependencies

  • core/1.2.1: *

How to use

PostMessager instances can be created at any time. Two arguments are accepted: the destination window and the instance options.


/* Get hold of an iFrame */
var domain = 'http://domain2.com';
var iframe = document.id('listenerFrame').contentWindow;

/* Create a PostMessager instance */
var messager = new PostMessager(iframe,{
    allowReceive: true,
    allowSend: true,
    validReceiveURIs: ['http://domain2.com'],
    onSend: function(message,dest) {
        console.log('sending "',message,'" to ',dest);
    },
    onReceive: function(message,source,origin) {
        console.log('received message "',message,'" from ',origin,' at ',source);
        this.reply('Got it!',source,origin);
    }
});

/* Send a message to the iFrame! */
messager.send('Hello from the parent window!',domain);

PostMessager handles sending, receiving, and replying to messages. Optimally you would add an instance to each frame.

For specific usage and options, please read the documentation or visit http://davidwalsh.name/js/postmessager


Discuss

A note on comments here: These comments are moderated. No comments will show up until they are approved. Comments that are not productive (i.e. inflammatory, rude, etc) will not be approved.

Found a bug in this plugin? Please report it this repository's Github Issues.

blog comments powered by Disqus