@tawaship/task

Process tasks serially.

How to install

1. on you npm project

npm install --save @tawaship/task

2. on your code

import { Task } from '@tawaship/task';

// or

const { Task } = require('@tawaship/task');

How to build

git clone https://github.com/tawaship/Task

cd Emitter

npm install

npm run build

How to load on browser

After install or build

<script src="/path/to/dist/Task.min.js"></script>

Usage

Single

let a = 0;
const task = new Task(
	function() {
		a++;
	}
);

task.done();
console.log(a); // 1

task.done();
console.log(a); // 2

Chaining

const task = new Task([
	function() {
		return task.next().done();
	},
	function() {
		return 3;
	}
]);

console.log(task.done()); // 3

Change position

const task = new Task([
	function() {
		return 1
	},
	function() {
		return 2;
	},
	function() {
		return 3;
	}
]);

console.log(task.first().done()); // 1
console.log(task.next().done()); // 2
console.log(task.prev().done()); // 1
console.log(task.to(2).done()); // 3

Disabled

const task = new Task([
	function() {
		return 1
	},
	function() {
		return 2;
	},
	function() {
		return 3;
	},
	function() {
		return 4;
	}
]);

task.enabled = false;
console.log(task.first().done()); // undefined
console.log(task.next().done()); // undefined
console.log(task.prev().done()); // undefined
console.log(task.to(2).done()); // undefined

Add

const task = new Task([
	function() {
		return 1
	}
])
.add(function() {
	return 2;
});

console.log(task.next().done()); // 2

Reset

const task = new Task([
	function() {
		return 1
	}
])
.reset();

console.log(task.first().done()); // undefined

Send arguments

const task = new Task(
	function(a, b, c) {
		console.log(a, b, c); // 1 2 3
	}
);
task.done(1, 2, 3);

Returned value

const task = new Task([
	function() {
		return 1;
	},
	function() {
		return 2;
	}
]);
task.first().done();
console.log(task.value); // 1

task.next().done();
console.log(task.value); // 2

Specify the context

let a = {hoge: 1};
const task = new Task(
	function() {
		this.moga = 2;
		return this;
	}
, a);

console.log(task.done()); // { hoge: 1, moga: 2 }

However, using the arrow function invalidates the context specification.

// on window
let a = {hoge: 1};
const task = new Task(
	() => {
		return this;
	}
, a);

console.log(task.done()); // Window

Finish

let a = {hoge: 1};
const task = new Task(
	function() {
		this.moga = 2;
		return this;
	}
, a);
task.first().finish().done();
console.log(a); // {hoge: 1}