0.1.9 • Published 9 years ago
crosser v0.1.9
Crosser
A service for communicating between browser frames.
Life Cycle
- One of the frames triggers a session which the other frame can subscribe to by name via a callback.
- Once the subscriber's callback is called, its return value will be resolved within the initiator frame and the session will end.
Although the session has ended, the subscriber will be called next time when a new session with the same name will be initialized.
Installation
npm install crosser --save
Code Example
Frame 1
var Crosser = require('crosser');
// Instantiation
var crosser = new Crosser(frame2.contentWindow, 'http://frame2.origin.com');
// Start a session
crosser.trigger('session-name', {message: 'message from frame1'})
.then(function(payloadFromFrame2){
alert(payloadFromFrame2.message) // 'message from frame2'
});
Frame 2
var Crosser = require('crosser');
// Instantiation
var crosser = new Crosser(frame1.contentWindow, 'http://frame1.origin.com');
// Subscribe to a session
crosser.subscribe('session-name', function(payloadFromFrame1){
alert(payloadFromFrame1.message); // 'message from frame1'
return {message: 'message from frame2'}
});
API Reference
####constructor(otherFrameWindow, otherFrameOrigin)
####trigger (sessionName, payload)
####abort (sessionName)
- arguments:
- sessionName
String
####subscribe (sessionName, callback)
####unsubscribe (sessionName)
- arguments:
- sessionName
String
License
0.1.9
9 years ago
0.1.8
9 years ago
0.1.7
9 years ago
0.1.6
9 years ago
0.1.5
9 years ago
0.1.4
9 years ago
0.1.3
9 years ago
0.1.2
9 years ago
0.1.1
9 years ago
0.1.0
9 years ago
0.0.9
9 years ago
0.0.8
9 years ago
0.0.7
9 years ago
0.0.6
9 years ago
0.0.5
9 years ago
0.0.4
9 years ago
0.0.3
9 years ago
0.0.2
9 years ago
0.0.1
9 years ago