こんにちは。
\nES6のPromiseはBluebirdの４倍遅いらしいPromiseのライブラリBluebirdが提供するAPIのうち、個人的に便利だと思ったものについてまとめます。
\nなお、標準のPromiseにも搭載されている機能については割愛します。
.then(fn, fn)や.then(fn).catch(fn)と等価のメソッドです。
\n「成功しても失敗してもどちらにせよ実行したい処理」を意味づけして書けるようになります。
// 素のjs（書き方１）\nPromise.resolve().then(someCallback, someCallback)\n\n// 素のjs（書き方２）\nPromise.resolve().then(someCallback).catch(someCallback)\n\n// Bluebird\nimport Promise from 'bluebird'\nPromise.resolve().finally(someCallback)Promise.allと似たようなメソッドですが、こちらは可変長引数でPromiseを渡します
\nさらに、コールバック関数では、配列ではなく渡したPromiseが１つずつ引数として渡ってきます。
\nいちいちバベって.then(([a, b, c]))のように引数を展開する必要が無いので、あらかじめ決まっている複数個のPromiseを待つ処理に便利です
import Promise from 'bluebird'\nPromise.join(\n Promise.resolve(1),\n Promise.resolve(2),\n Promise.resolve(3),\n // 配列じゃなくて引数として渡ってくる\n (one, two, three) => console.log(one, two, three)\n)同じく複数のPromiseを待つユーティリティですが、こちらはオブジェクトを渡せます
\nオブジェクトの値すべてがPromiseである必要がなく、一部だけPromiseだったとしてもよしなに処理してくれます
import Promise from 'bluebird'\nPromise.props({\n one: 1,\n two: 2,\n three: Promise.resolve(3),\n}).then(function({ one, two, three }) {\n console.log(one, two, three)\n})Promise.all(list.map(fn))の略です。
\nループ処理してPromiseを待つ処理で、上記のような処理がよく登場してくるかと思いますが、
\n若干ネスト（インデント）とタイプ数を削ることができます
Promise.mapは同時実行数を指定できます。第３引数に{concurrency: 3}と渡すと同時に実行する数を3に絞って実行してくれます
\nさらに、インスタンスメソッドとしても実行可能なので、Promiseベースのパイプラインを作りたいときなどにとても流暢に書けるようになります
import Promise from 'bluebird'\nPromise.map(list, fn, { concurrency: 3 })\n\n// Promiseのインスタンスメソッドとしても実行可能\nPromise.map([1, 2, 3], n => n)\n .map(n => n + 1)\n .map(n => n * 100)\n .then(list => console.log(list))Promise.mapSeriesはPromise.mapとはちょっと違う動きをします。
\n何らかの副作用を持つ処理などで、「先頭から順番に処理する、Promiseが完了したら次へ」という処理が実現できます
Promise.allとも違います。あればPromiseのインスタンスを渡してしまうので順序や実行数の指定は不可能です。
\nPromise.mapSeriesなら配列とPromiseを返す関数を渡すので、先頭から１つずつ処理が可能になります。
import Promise from 'bluebird'\n\nconst articles = [\n '記事A',\n '記事B',\n '記事C',\n]\nconst publish = (article) => {\n // 何らかの手段で記事データを公開する非同期処理\n}\n\nPromise.mapSeries(articles, publish)Promise#catchReturnは、正常系としてrejectされうる処理で、.catch(() => value)などとしたい場合に使えます。
import Promise from 'bluebird'\n\nfunction hoge () {\n return Promise.reject(new Error('エラーだけど正常系'))\n}\n\nhoge().then('OK').catchReturn('WARNING')Promiseの数珠つなぎの途中でconsole.logなどを挟み込みたいときに便利です。
jsのconsole.logはRubyのpとは異なり戻り値がないので、.thenなどにそのまま渡すことができません。
\nなので、最短でも.then(n => {console.log(n); return n})という処理になってしまいますが、それを解消してくれます
import Promise from 'bluebird'\n\nPromise.resolve(1)\n .tap(console.log.bind(console)) // => 1\n .then(n => n + 1)\n .tap(console.log.bind(console)) // => 2\n .then(n => n + 1)\n .tap(console.log.bind(console)) // => 3\n .then(n => n + 1)標準のPromiseは途中キャンセルのできないですが、Bluebirdならできます。
\nただし、タイムアウトした処理自体は生きてるいるのでエラーハンドリングに注意です
\n例：タイムアウトすればPromiseはrejectされるが、タイムアウトしたHTTPリクエスト自体は明示的に切断するまで継続する
import Promise from 'bluebird'\n\nfunction connect () {\n // なんかに接続する処理\n}\n\nconnect()\n .timeout(100)\n .then(() => 'OK')\n .catch(() => 'Timeout')\n .then(console.log)リトライ処理に便利です。
\nimport Promise from 'bluebird'\n\n// 素のjsならこう\nconst delay = n => {\n new Promise((resolve) => setTimeout(resolve, n))\n}\n\n// Bluebirdならこう\nPromise.delay(n)Bluebird自体にPromisifyが備わっていたんですね。
\nいままでes6-promisifyとかわざわざ別のpromisifyライブラリを使ってました。
import fs from 'fs'\nimport Promise from 'bluebird'\n\nconst readFile = Promise.promisify(fs.readFile)\nreadFile('hoge.json', 'utf-8')\n .then(content => console.log(content))他にも色々便利な機能もあるのですが、最後にBluebirdの恐ろしいところを。
\nこれまで紹介したPromise.*と使うクラスメソッドのほとんどは、インスタンスメソッドとしても実行可能です
import Promise from 'bluebird'\n\nPromise.all([1, 2, 3])\n .map(n => n - 10)\n .mapSeries(n => n * 10)\n .then(nums => console.log(nums))などなど。
\n最近のJavaScriptではasync/awaitの登場によってかなり書きやすくなっていますが、async/awaitは個人的には手続き型っぽくなるのが嫌いで、
\nbluebirdで関数型寄りの書き味な非同期ベースのパイプラインを作ってみるのも良いかもしれません。