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.