情報アイランド

「情報を制する者は世界を制す」をモットーに様々な情報を提供することを目指すブログです。現在はプログラミング関連情報が多めですが、投資関連情報も取り扱っていきたいです。

Node.jsで配列を非同期的に検索する

配列を非同期的に検索するにはasyncモジュールの下のような関数を使用します。

  • async.detect関数
  • async.detectLimit関数
  • async.detectSeries関数

検索処理を完全に並列的に実行したい場合にはasync.detect関数を使用し、並列的に実行する検索処理の最大数を指定して実行したい場合にはasync.detectLimit関数を使用し、直列的に実行したい場合にはasync.detectSeries関数を使用します。

なお、検索処理の実行中にエラーが発生しても既に開始している他の要素に対する検索処理の実行は続行しますので注意してください。しかし、まだ開始していない要素に対する検索処理の実行は行われません。

また、検索は配列の最初の要素から順番に行われます。ただし、並列的に検索処理を実行する場合には検索結果として検索条件を満たす配列の最初の要素が得られるとは限りませんので注意してください。

async.detect関数とasync.detectSeries関数

var async = require('async');

async.detect(['xxx', 'yyy', 'zzz'], function (item, callback) {
    callback(null, true);
    //or
    callback(null, false);
    //or
    callback(new Error('aaa'), null);
}, function (err, result) {
});
async.detectSeries(['xxx', 'yyy', 'zzz'], function (item, callback) {
    callback(null, true);
    //or
    callback(null, false);
    //or
    callback(new Error('aaa'), null);
}, function (err, result) {
});

第1引数

第1引数に配列を指定します。あるいは、配列以外のイテラブルを指定することもできます。

第2引数

第2引数に検索条件を関数として指定します。

この関数の第1引数は配列の要素の値であり、第2引数はコールバック関数です。

検索処理が完了した場合や検索処理の実行中にエラーが発生した場合には必ずこのコールバック関数を呼び出さなければなりません。

このコールバック関数の第1引数にはエラーオブジェクト(エラーが発生しなかった場合にはnull)を指定し、第2引数には配列の要素が検索条件を満たすかどうかを真偽値として指定します(エラーが発生した場合にはnullを指定します)。

第3引数

第3引数に配列の検索が完了したか、検索処理の実行中にエラーが発生した場合に呼び出されるコールバック関数を指定します。

この関数の第1引数はエラーオブジェクトであり、第2引数は最初に見付かった検索条件を満たす配列の要素(検索条件を満たす要素が見付からなかった場合にはundefined)です。

この引数は指定しなくても構いません。

async.detectLimit関数

async.detectLimit(['xxx', 'yyy', 'zzz'], 10, function (item, callback) {
    callback(null, true);
    //or
    callback(null, false);
    //or
    callback(new Error('aaa'), null);
}, function (err, result) {
});

async.detect関数やasync.detectSeries関数とほぼ同じですが、第1引数と第2引数の間に並列的に実行する検索処理の最大数を指定します。

サンプルコード1

async-detect.js

var async = require('async');
var util = require('util');

var xs = [0, 1, 2, 3, 4, 5, 6, 7, 8, 9];
async.detectSeries(xs, function (item, callback) {
    setTimeout(function () {
        util.log(item);
        callback(null, item > 4);
    }, Math.random() * 1000);
}, function (err, result) {
    if (err) {
        console.error(err);
        process.exit(1);
    }
    else {
        console.log(result);
        async.detect(xs, function (item, callback) {
            setTimeout(function () {
                util.log(item);
                callback(null, item > 4);
            }, Math.random() * 1000);
        }, function (err, result) {
            if (err) {
                console.error(err);
                process.exit(1);
            }
            else {
                console.log(result);
                async.detectLimit(xs, 2, function (item, callback) {
                    setTimeout(function () {
                        util.log(item);
                        callback(null, item > 4);
                    }, Math.random() * 1000);
                }, function (err, result) {
                    if (err) {
                        console.error(err);
                        process.exit(1);
                    }
                    else {
                        console.log(result);
                    }
                });
            }
        });
    }
});

使用パッケージ

  • Async.js
    npm install asyncでインストールします。

実行結果

C:\work\node>node async-detect.js
5 Jun 20:43:00 - 0
5 Jun 20:43:00 - 1
5 Jun 20:43:01 - 2
5 Jun 20:43:01 - 3
5 Jun 20:43:02 - 4
5 Jun 20:43:03 - 5
5
5 Jun 20:43:03 - 3
5 Jun 20:43:03 - 4
5 Jun 20:43:03 - 0
5 Jun 20:43:03 - 5
5
5 Jun 20:43:03 - 6
5 Jun 20:43:03 - 2
5 Jun 20:43:03 - 7
5 Jun 20:43:03 - 9
5 Jun 20:43:04 - 1
5 Jun 20:43:04 - 8
5 Jun 20:43:04 - 1
5 Jun 20:43:04 - 2
5 Jun 20:43:04 - 0
5 Jun 20:43:04 - 4
5 Jun 20:43:04 - 3
5 Jun 20:43:04 - 5
5
5 Jun 20:43:05 - 6

関連

pizyumi
プログラミング歴19年のベテランプログラマー。業務システム全般何でも作れます。現在はWeb系の技術を勉強中。
スポンサーリンク

-Node.js