Wed 29 April 2020 2 min(s)

Check out vcmloop's latest documentation at https://github.com/dalikewara/vcmloop

npm package

versionbuildlanguagedownloaddependentsissuelast_commitlicense

An interval-based looping method for massive data

Doing simple looping basicly doesn't have big impact to your RAM/CPU resource, but, it will if you performing heavy looping with massive data, for example 100k data or > 1m data.

Default looping method like for, while, foreach runs faster (has better performance), but also takes and spent more RAM/CPU resource continously along with the looping process—if you own more resource, I think it's not a big problem. Otherwise, using interval method doesn't harm RAM/CPU resource too much. It just uses a little bit of it and keeping the resource stable until the process is done. As a consequence, it runs slower than the default method—but still fast.

So, if you need to do looping with massive data and heavy process inside, using interval method should be a better solution.

Installation

NPM

npm install vcmloop --save

Browser

// Bower
bower install vcmloop --save

Initialization

NPM

const vcmloop = require('vcmloop');

Browser

// Bower
<script src="bower_components/vcmloop/dist/vcmloop.min.js"></script>

Quickstart

vcmloop(start, stop, fn, end[optional], delay[optional]);

Here is basic vcmloop usage:

vcmloop(0, 5, (num) => {
  console.log(num);
});

You can pass an end argument to run once after the synchronous looping process is done.

vcmloop(0, 5, (num) => {
  console.log(num);
}, () => {
  console.log('end');
});

// output:
// 0
// 1
// 2
// 3
// 4
// end

You can set duration or delay for interval process.

vcmloop(0, 5, (num) => {
  console.log(num);
}, null, 200);
vcmloop(0, 5, (num) => {
  console.log(num);
}, () => {
  console.log('end');
}, 200);

You may do this in an asynchronous looping process to make sure your code runs correctly:

var len = 10;
var lenX = len - 1;
var start = 0;

vcmloop(start, len, (num) => {
  console.log(num);

  sampleFunction(sampleCallback => {
    if (num === lenX) return 'end';
  });
});

Release

Changelog

See https://github.com/dalikewara/vcmloop/blob/master/CHANGELOG.md.

Credits

Copyright © 2019 Dali Kewara.

License

MIT License

Cover image

Article history:

>> Friday 08:41 PM, May 01 2020 | "add articles description"
>> Thursday 07:10 PM, April 30 2020 | "update scripts"