Write super-clean async code with promises.
A nifty memory device for use with promise-chains.
Promises are a great innovation to reduce "right-ward drift" as seen with code using regular node-style callbacks. It also eases error handling, relieving you from the necessity to check for errors after each asynchronous step.
However, I found code that goes further than merely processing return values in a chain (comparable to a regular synchronous function chain) still to noisy and cumbersome for my taste.
Memoblock allows you to create a memo object which can be used as the return value value in your chain. It essentially takes over the role of what normally would be the function context which different statements can share, and which may hold any number of named objects. The keys set on the memo can be seen as local function variables.
Using Memoblock is incredibly simple. You start a Memoblock with
Memoblock.do. You pass it an array consisting of any number of functions. These functions are called in turn with the value of
memo as both the function context (
this) as well as the first argument for the function.
After any function has executed, the current properties of the
memo object are inspected. If the properties contain any promises, they'll get resolved to their actual values. As soon as all promises have resolved, and the values of the
memo object have been updated, the next function is called.
In this example, we attempt to build some kind of message piece by piece before sending it.
Memoblock = require "memoblock"Memoblockdo->@name = "Meryn Stol" # real@email = "firstname.lastname@example.org" # real@subject = consoleAPIaskForLine "Message subject" # promise->@body = consoleAPIaskForText "Message body" # promise@location = locationAPIguessFriendlyName # promise->@blurp = "\n\nWritten in " # real@body = @body + @blurp@signature = signatureAPIsignMessage @name@emailm@subject@body->@date =->@mailResult = mailerAPIsent @name@email@body + @signature->consolelog "Successfully sent your message '' at ."then nullconsoleerror err
Memoblock will only wait for promises set as properties on the
memo object. If you want to wait for a promise that doesn't return a value to be fullfilled before moving on to the next step, just assign it to a property of the memo object. The value of the property in the next step will be
If you start a Memoblock inside an object method, then by default,
this will be bound to the memo object.
If you want any other value for this, you can bind the function explicitly to a particular object. In CoffeeScript, you can easily bind the function to the outer context by using
=>. You of course then need to have access to the memo object, which you do with
Alternatively, you can assign the outer
this to a local variable before you start a memoblock. This variable will then will be accessible as any other. This in particularly attractive in CoffeeScript, beacuse it keeps the super short syntax for assigning properties available.
self = thisMemoblock.do([-> @prop1 = "prop1"-> @prop2 = "prop2"])
Memoblock is released under the MIT License.
Copyright (c) 2013 Meryn Stol