Skip to content

(see README below - this is a fork only adding support for targetting a specific domain instead of "*" on postMessage); Allow angularJS to listen and publish cross-document messages though window.postMessage API.

License

Notifications You must be signed in to change notification settings

yonatankarni/angular-post-message

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

17 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Angular Post Message API

(hopefully) temporary fork of kylewelsby/angular-post-message, intended to allow postMessage to a specific domain instead of always "*". from here on - the original README

Allow angularJS to listen and publish cross-document messages though window.postMessage API.

Cross-document messaging is compatable with the following browsers as seen on Can I Use:

  • Internet Explorer 8+
  • Firefox 3+
  • Chrome 4+
  • Safari 4+
  • Opera 9.5+
  • iOS Safari 3.2+
  • Opera Mini 5+
  • Android Browser 2.1+
  • Blackberry Browser 7+
  • Opera Moble 10+
  • Chrome for Android 30+
  • Firefox for Android 25+
  • Internet Exploer Mobile 10+

Partial support in IE8-9 refers to only working in frames/iframes (not other tabs/windows). Also in IE 9 and below an object cannot be sent using postMessage. Partial support in IE10 refers to limitations in certain conditions

Tested on AngularJS versions 1.0.X, 1.2.X and 1.3.0.

Installation

The repository comes with the modules pre-buolt and compressed into the dist/ directory.

Install the component via bower

bower install angular-post-message

Or alternatively checkout this repo into your project.

Then inlcude dist/angular-post-message.min.js into your project.

Example

This is a simple example which uses postMessage to deliver messages between two origins. There is a gist which will deliver a message every second

index.html

<html>
  <head>
    <script src="bower_components/angular/angular.js"></script>
    <script src="bower_components/angular-post-message/angular-post-message.js"></script>
  </head>
  <body>
    <iframe src="https://rawgit.com/kylewelsby/585b3a5395c6731acc50/raw/f661e856adbccf39549ed7c550661f09158f8d55/index.html"></iframe>
    <br>
    <button ng-click="sendMessage();">Send response</button>
    <br>
    <ol>
      <li ng-repeat="message in messages">{{message}}</li>
    </ol>
  </body>
</html>

app.js

var app = angular.module('app',['ngPostMessage']);
app.controller('MainCtrl', function($scope) {
  $scope.messages = [];
  $scope.$root.$on('$messageIncoming', function (event, data){
    $scope.messages.push(angular.fromJson(data));
  });
  $scope.sendMessage = function (){
    $scope.$emit(
      '$messageOutgoing',
      angular.toJson({"response":"hi"})
    );
  };
});

Development

You do not need to build the project to use it, but if you are working on it then this is what you need to know.

Requirements

Testing

To run all the tests

npm test

To run tests while developing

testem

Then open http://localhost:7357 in any or all browsers.

or run tests once (testing on all available browsers)

testem ci

About

(see README below - this is a fork only adding support for targetting a specific domain instead of "*" on postMessage); Allow angularJS to listen and publish cross-document messages though window.postMessage API.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • CoffeeScript 97.2%
  • Shell 2.8%