s-stream v1.1.0

s-stream

Basic use

As a getter/setter

var s = stream(5);
s(); // 5
s(3);
s(); // 3

Can be observed via .map

var s = stream();

s.map(function(value) {
	// called once with value 'foo'
	// called once more with value 'bar'
});

s('foo');
s('bar');

Map is called immediately if initialized with any value

var s = stream(123);
s.map(function(value) {
	// called with value 123
});

Including undefined

Promises

Streams wait for promise to resolve

var p = new Promise(function(resolve, reject) {
	setTimeout(function() {
		resolve('foo');
	}, 250);
});

var s = stream(p);

s.map(function(value) {
	// called after 250ms with value 'foo'
});

With error handling

var p = new Promise(function(resolve, reject) {
	setTimeout(function() {
		reject(new Error('failed'));
	}, 250);
});

var s = stream(p);

s.map(function(value) {
	// never called
});

s.catch(function(err) {
	// called after 250ms with Error('failed');
});

Preventing memory leaks

Listeners can be removed with .off

var s = stream();
var f = function() {};
s.map(f);
s.off(f);

Other information

stream.toString returns a string of form stream(contentType)

var s = stream(123);
s.toString(); // `stream(Number)`