April 17, 2017 Philip Aston

Getting started with JSON & Binary in the JS client

With the release of Diffusion 5.7 two new topic types have been introduced; JSON & Binary. The former is especially useful for users of the JavaScript client, since JSON is the defacto standard for handling data in web-applications and enjoys native support in JS.  This article will go through some simple examples of using these new topic types, and explain where best to use them.

Data Types

JSON and Binary topics introduce the notion of datatypes. These are fully explained here, but in essence provide consistent guarantees around data and operations that can be performed on that data, such as creating deltas.

Datatypes are used in the API to derive values for use in updating topics, and also to create value streams for a particular set of topics. The API exposes these as part of the top-level diffusion namespace.

To subscribe to a topic and receive datatype values, one creates a stream as normal, and then specialises it by providing the datatype to Stream#asType. Listeners for value, subscribe & unsubscribe events can then be bound. It’s important to note that only events for topics that are of the same datatype will be emitted.


Enjoy the rich functionality of Diffusion 6.7 as part of your event-driven application.

Quick Start Guide

Step-by-step guide to getting started.

Diffusion Cloud

SaaS offering that focuses on business.

Diffusion On-Premise

A pub-sub platform for real-time applications.