*Written by Andrew D’Amelio and Yuri Takhteyev.*

## Practical Functional Javascript with Ramda

At rangle.io we’ve been fans of the functional programming style for a while and have used Underscore and Lodash extensively on many projects. However, recently we started using a new library, Ramda, that on the surface seems very similar to Underscore, but which turns out to be different in a small but significant way. Ramda offers roughly the same set of methods as Underscore, but the way it offers them makes functional composition easy.

The difference between Ramda and Underscore comes down to two core concepts: currying and composition.

## Currying

Currying is the process of turning a function that expects multiple parameters into one that, when supplied fewer parameters, returns a new function that awaits the remaining ones.

`1.`

`R.multiply(`

`2`

`, `

`10`

`); `

`// returns 20`

Here we have to pass both parameters, 2 and 10, to call the function.

`1.`

`var multiplyByTwo = R.multiply(`

`2`

`);`

`2.`

`multiplyByTwo(`

`10`

`); `

`// returns 20`

Pretty neat! We created a new function `multiplyByTwo`

which is just the value 2 baked into `multiply()`

. We can now pass any value to our `multiplyByTwo`

function. The reason we can do this is because all of Ramda’s function are curried.

Currying proceeds from right-to-left: when you skip some arguments, Ramda assumes you’ve skipped the ones on the right. Because of that, Ramda functions that take an array and a function normally expect the function as the first argument and the array as the second. This is the reverse of how Underscore does it:

`1.`

`_.map([`

`1`

`,`

`2`

`,`

`3`

`], _.add(`

`1`

`)) `

`// 2,3,4`

Versus:

`1.`

`R.map(R.add(`

`1`

`), [`

`1`

`,`

`2`

`,`

`3`

`]); `

`// 2,3,4`

The combination first-operation-then-data with right-to-left currying allows us to just specify what we want to do and get back a function that does that. We can then call that function with the actual data. Currying becomes easy and practical:

`1.`

`var function addOneToAll = R.map(R.add(`

`1`

`));`

`2.`

`addOneToAll([`

`1`

`,`

`2`

`,`

`3`

`]); `

`// returns 2,3,4`

We’ve now got a function `addOneToAll()`

that we can reuse in a variety of contexts.

Here is a somewhat more complex but also more practical example. Suppose we want to make a request to the server, get an array of items, and then extract the field “cost” from each item. Using Underscore we might do this:

`1.`

`return`

`getItems()`

`2.`

` `

`.then(function(items){`

`3.`

` `

`return`

`_.pluck(items, `

`'cost'`

`);`

`4.`

`});`

Using Ramda, we can eliminate some boilerplate:

`1.`

`return`

`getItems()`

`2.`

` `

`.then(R.pluck(`

`'cost'`

`));`

This is because, when we call `R.pluck('cost')`

, it returns a function that extracts the “cost” field from each item in the supplied array – which is precisely the function we want to pass to `.then()`

.

To get the full benefit of currying, however, we need to combine it with composition.

## Composition

Mathematically speaking, functional composition is an operation that takes functions `f`

and `g`

, returns a function `h`

such that: `f(x) = f(g(x))`

. Ramda offers a `compose()`

function to do this. Compose mixes well with currying, since we can build larger functional behaviors, from smaller functional components.

`1.`

`var getCostWithTax = R.compose(`

`2.`

` `

`R.multiply(`

`1`

`+ TAX_RATE), `

`// calculate the tax`

`3.`

` `

`R.prop(`

`'cost'`

`) `

`// pull out the 'cost' property`

`4.`

`);`

This gives us a function that gets the property “cost” out of an object and then multiplies the result by 1.13.

The standard “compose” function is right-associative. That is, operations proceed from right to left. If you find this unintuitive, you can use `R.pipe()`

, which is the same as `R.compose()`

but works from left to right:

`1.`

`var getCostWithTax = R.pipe(`

`2.`

` `

`R.prop(`

`'cost'`

`), `

`// pull out the 'cost' property`

`3.`

` `

`R.multiply(`

`1`

`+ TAX_RATE) `

`// calculate the tax`

`4.`

`);`

You are not limited to composing just two functions. `R.compose`

and `R.pipe`

can take up to 10 arguments.

It’s worth noting that currying and composing are supported by libraries such as Underscore too. They are rarely used, however, since the data-first order of parameters makes currying Underscore’s methods impractical. Ramda makes it easy to apply currying and composition in practice.

At first, we quickly fell in love with Ramda. Ramda’s style leads to code that’s extendable, composable, testable, and declarative. Composing functions feels very natural, and results in JavaScript that’s just easier to understand.

## then…

As we started using Ramda more and more we discovered that things can get a bit messier when you have asynchronous functions returning promises:

`01.`

`var getCostWithTaxAsync = function() {`

`02.`

` `

`var getCostWithTax = R.pipe(`

`03.`

` `

`R.prop(`

`'cost'`

`), `

`// pull out the 'cost' property`

`04.`

` `

`R.multiply(`

`1`

`+ TAX_RATE) `

`// multiply it by 1.13`

`05.`

` `

`);`

`06.`

`07.`

` `

`return`

`getItem()`

`08.`

` `

`.then(getCostWithTax);`

`09.`

`}`

While this is cleaner than it would have been without Ramda, what we wished we could do was just this:

`1.`

`var getCostWithTaxAsync = R.pipe(`

`2.`

` `

`getItem, `

`// get the item`

`3.`

` `

`R.prop(`

`'cost'`

`), `

`// pull out the 'cost' property`

`4.`

` `

`R.multiply(`

`1`

`+ TAX_RATE) `

`// multiply it by 1.13`

`5.`

`);`

The reason we couldn’t do this is because `getItem()`

returns a promise, while the function returned by `R.prop()`

expects to be called with the actual value.

## Promise-Aware Composition

We got in touch with Ramda contributors and proposed a version of compose that would automatically unwrap promises, so that asynchronous functions could be composed together with functions that expect actual results. After a long discussion, we settled on implementing these as new functions: `R.pCompose()`

and `R.pPipe()`

– with “p” standing for “promise”.

With `R.pPipe`

we could do exactly what we wanted to do:

`1.`

`var getCostWithTaxAsync = R.pPipe(`

`2.`

` `

`getItem, `

`// get a promise for the item`

`3.`

` `

`R.prop(`

`'cost'`

`), `

`// pull out the 'cost' property`

`4.`

` `

`R.multiply(`

`1`

`+ TAX_RATE) `

`// multiply it by 1.13`

`5.`

`); `

`// returns a promise for the cost with tax`

Since our code tends to leverage promises quite heavily, we expect `R.pPipe()`

to do quite a lot of heavy lifting in our future code. Give it a try and let us know what you think!

## {{ parent.title || parent.header.title}}

## {{ parent.tldr }}

## {{ parent.linkDescription }}

{{ parent.urlSource.name }}