framebus - npm Package Versions

5.0.0

• Allow scoping to a specific channel for events

  var bus = new Framebus({
    channel: "some-unique-identifier-used-on-both-the-parent-and-child-pages",
  });
  

• Add verifyDomain config to scope messages to specific domains

  var bus = new Framebus({
    verifyDomain: function (url) {
      // only listens for events emitted from `https://parent-url.example.com` and `https://my-domain.example.com`
      return url.indexOf("https://my-domain.example.com");
    },
  });
  

• Add teardown method for easy cleanup

Breaking Changes

• Instantiate new instances of framebus

  // v4
  var bus = require("framebus");
  bus.on(/* args */);
  bus.emit(/* args */);
  
  // v5
  var Framebus = require("framebus");
  var bus = new Framebus();
  bus.on(/* args */);
  bus.emit(/* args */);
  

• Instantiating a framebus with target method with an origin param now requires an options object (same object that is used to instantiate the instance)

  // v4
  var bus = require("framebus");
  var anotherBus = bus.target("example.com");
  
  // v5
  var Framebus = require("framebus");
  var bus = Framebus.target({
    origin: "example.com",
  });
  var anotherBus = bus.target({
    origin: "example.com",
  });
  

4.0.5

• Fixup Framebus typing for Typescript integrations

v4.0.3 and v4.0.4

• Use @braintree/uuid package for uuid generation
• Update typescript to v4

v4.0.3 and v4.0.4

• Use @braintree/uuid package for uuid generation
• Update typescript to v4

v4.0.2

• Fix issue where rollup bundlers could not import framebus (see braintree-web#504)

v4.0.1

• Fix issue where framebus could not be used with server side rendering

v4.0.0

Breaking Changes

• Drop support for IE < 9
• Drop support for using methods standalone without using the bus
• Drop publish, pub, and trigger methods. Use emit
• Drop subscribe and sub methods. Use on
• Drop unsubscribe and unsub methods. Use off
• Drop support for passing multiple arguments to emit, not it only supports passing data and reply

3.0.2

• Fix issue where framebus would error when trying to reply to a non-existent window/frame

  3.0.1

• Fix issue where broadcasts to frames would fail if parent page has overwritten the window.length variable

  3.0.0

BREAKING CHANGES

• Module is now CommonJS only, and must be used with npm with a build tool (Browserify, Webpack, etc)

• Bower support dropped

  2.0.8

• Fall back to window.self when window.top is undefined in old versions of IE.

  2.0.7

• Corrects a regression introduced in 2.0.6 that prevented CommonJS runtimes from working.

  2.0.6

• framebus can be required (but not executed) from Node.js® environments.

  2.0.5

• Only traverse to opener from the top-level frame

  2.0.4

• Avoid exceptions while broadcasting events

  2.0.3

• Do not infinitely recurse when window.opener === window

  2.0.2

[unpublished]