76 lines
1.7 KiB
JavaScript
76 lines
1.7 KiB
JavaScript
var iterate = require('./lib/iterate.js')
|
|
, initState = require('./lib/state.js')
|
|
, terminator = require('./lib/terminator.js')
|
|
;
|
|
|
|
// Public API
|
|
module.exports = serialOrdered;
|
|
// sorting helpers
|
|
module.exports.ascending = ascending;
|
|
module.exports.descending = descending;
|
|
|
|
/**
|
|
* Runs iterator over provided sorted array elements in series
|
|
*
|
|
* @param {array|object} list - array or object (named list) to iterate over
|
|
* @param {function} iterator - iterator to run
|
|
* @param {function} sortMethod - custom sort function
|
|
* @param {function} callback - invoked when all elements processed
|
|
* @returns {function} - jobs terminator
|
|
*/
|
|
function serialOrdered(list, iterator, sortMethod, callback)
|
|
{
|
|
var state = initState(list, sortMethod);
|
|
|
|
iterate(list, iterator, state, function iteratorHandler(error, result)
|
|
{
|
|
if (error)
|
|
{
|
|
callback(error, result);
|
|
return;
|
|
}
|
|
|
|
state.index++;
|
|
|
|
// are we there yet?
|
|
if (state.index < (state['keyedList'] || list).length)
|
|
{
|
|
iterate(list, iterator, state, iteratorHandler);
|
|
return;
|
|
}
|
|
|
|
// done here
|
|
callback(null, state.results);
|
|
});
|
|
|
|
return terminator.bind(state, callback);
|
|
}
|
|
|
|
/*
|
|
* -- Sort methods
|
|
*/
|
|
|
|
/**
|
|
* sort helper to sort array elements in ascending order
|
|
*
|
|
* @param {mixed} a - an item to compare
|
|
* @param {mixed} b - an item to compare
|
|
* @returns {number} - comparison result
|
|
*/
|
|
function ascending(a, b)
|
|
{
|
|
return a < b ? -1 : a > b ? 1 : 0;
|
|
}
|
|
|
|
/**
|
|
* sort helper to sort array elements in descending order
|
|
*
|
|
* @param {mixed} a - an item to compare
|
|
* @param {mixed} b - an item to compare
|
|
* @returns {number} - comparison result
|
|
*/
|
|
function descending(a, b)
|
|
{
|
|
return -1 * ascending(a, b);
|
|
}
|