perf: use optimized circular buffer implementation to store measurements history
[poolifier.git] / tests / pools / abstract-pool.test.mjs
CommitLineData
5d5885ee 1// eslint-disable-next-line n/no-unsupported-features/node-builtins
ded253e2 2import { createHook, executionAsyncId } from 'node:async_hooks'
a074ffee
JB
3import { EventEmitterAsyncResource } from 'node:events'
4import { readFileSync } from 'node:fs'
ded253e2 5import { dirname, join } from 'node:path'
2eb14889 6import { fileURLToPath } from 'node:url'
ded253e2 7
a074ffee
JB
8import { expect } from 'expect'
9import { restore, stub } from 'sinon'
ded253e2 10
f12182ad 11import { CircularBuffer } from '../../lib/circular-buffer.cjs'
a074ffee 12import {
70a4f5ea 13 DynamicClusterPool,
9e619829 14 DynamicThreadPool,
aee46736 15 FixedClusterPool,
e843b904 16 FixedThreadPool,
aee46736 17 PoolEvents,
184855e6 18 PoolTypes,
3d6dd312 19 WorkerChoiceStrategies,
184855e6 20 WorkerTypes
d35e5717 21} from '../../lib/index.cjs'
ded253e2 22import { WorkerNode } from '../../lib/pools/worker-node.cjs'
95d1a734 23import { PriorityQueue } from '../../lib/priority-queue.cjs'
d35e5717
JB
24import { DEFAULT_TASK_NAME } from '../../lib/utils.cjs'
25import { waitPoolEvents } from '../test-utils.cjs'
e1ffb94f
JB
26
27describe('Abstract pool test suite', () => {
2eb14889
JB
28 const version = JSON.parse(
29 readFileSync(
a5e5599c 30 join(dirname(fileURLToPath(import.meta.url)), '../..', 'package.json'),
2eb14889
JB
31 'utf8'
32 )
33 ).version
fc027381 34 const numberOfWorkers = 2
a8884ffd 35 class StubPoolWithIsMain extends FixedThreadPool {
e1ffb94f
JB
36 isMain () {
37 return false
38 }
3ec964d6 39 }
3ec964d6 40
dc021bcc 41 afterEach(() => {
a074ffee 42 restore()
dc021bcc
JB
43 })
44
bcf85f7f
JB
45 it('Verify that pool can be created and destroyed', async () => {
46 const pool = new FixedThreadPool(
47 numberOfWorkers,
48 './tests/worker-files/thread/testWorker.mjs'
49 )
50 expect(pool).toBeInstanceOf(FixedThreadPool)
51 await pool.destroy()
52 })
53
54 it('Verify that pool cannot be created from a non main thread/process', () => {
8d3782fa
JB
55 expect(
56 () =>
a8884ffd 57 new StubPoolWithIsMain(
7c0ba920 58 numberOfWorkers,
b2fd3f4a 59 './tests/worker-files/thread/testWorker.mjs',
8d3782fa 60 {
041dc05b 61 errorHandler: e => console.error(e)
8d3782fa
JB
62 }
63 )
948faff7 64 ).toThrow(
e695d66f
JB
65 new Error(
66 'Cannot start a pool from a worker with the same type as the pool'
67 )
04f45163 68 )
3ec964d6 69 })
c510fea7 70
bc61cfe6
JB
71 it('Verify that pool statuses properties are set', async () => {
72 const pool = new FixedThreadPool(
73 numberOfWorkers,
b2fd3f4a 74 './tests/worker-files/thread/testWorker.mjs'
bc61cfe6 75 )
bc61cfe6 76 expect(pool.started).toBe(true)
711623b8
JB
77 expect(pool.starting).toBe(false)
78 expect(pool.destroying).toBe(false)
bc61cfe6 79 await pool.destroy()
bc61cfe6
JB
80 })
81
c510fea7 82 it('Verify that filePath is checked', () => {
948faff7 83 expect(() => new FixedThreadPool(numberOfWorkers)).toThrow(
c3719753
JB
84 new TypeError('The worker file path must be specified')
85 )
86 expect(() => new FixedThreadPool(numberOfWorkers, 0)).toThrow(
87 new TypeError('The worker file path must be a string')
3d6dd312
JB
88 )
89 expect(
90 () => new FixedThreadPool(numberOfWorkers, './dummyWorker.ts')
948faff7 91 ).toThrow(new Error("Cannot find the worker file './dummyWorker.ts'"))
8d3782fa
JB
92 })
93
94 it('Verify that numberOfWorkers is checked', () => {
8003c026
JB
95 expect(
96 () =>
97 new FixedThreadPool(
98 undefined,
b2fd3f4a 99 './tests/worker-files/thread/testWorker.mjs'
8003c026 100 )
948faff7 101 ).toThrow(
e695d66f
JB
102 new Error(
103 'Cannot instantiate a pool without specifying the number of workers'
104 )
8d3782fa
JB
105 )
106 })
107
108 it('Verify that a negative number of workers is checked', () => {
109 expect(
110 () =>
d35e5717 111 new FixedClusterPool(-1, './tests/worker-files/cluster/testWorker.cjs')
948faff7 112 ).toThrow(
473c717a
JB
113 new RangeError(
114 'Cannot instantiate a pool with a negative number of workers'
115 )
8d3782fa
JB
116 )
117 })
118
119 it('Verify that a non integer number of workers is checked', () => {
120 expect(
121 () =>
b2fd3f4a 122 new FixedThreadPool(0.25, './tests/worker-files/thread/testWorker.mjs')
948faff7 123 ).toThrow(
473c717a 124 new TypeError(
0d80593b 125 'Cannot instantiate a pool with a non safe integer number of workers'
8d3782fa
JB
126 )
127 )
c510fea7 128 })
7c0ba920 129
26ce26ca
JB
130 it('Verify that pool arguments number and pool type are checked', () => {
131 expect(
132 () =>
133 new FixedThreadPool(
134 numberOfWorkers,
135 './tests/worker-files/thread/testWorker.mjs',
136 undefined,
137 numberOfWorkers * 2
138 )
139 ).toThrow(
140 new Error(
141 'Cannot instantiate a fixed pool with a maximum number of workers specified at initialization'
142 )
143 )
144 })
145
216541b6 146 it('Verify that dynamic pool sizing is checked', () => {
a5ed75b7
JB
147 expect(
148 () =>
149 new DynamicClusterPool(
150 1,
151 undefined,
d35e5717 152 './tests/worker-files/cluster/testWorker.cjs'
a5ed75b7 153 )
948faff7 154 ).toThrow(
a5ed75b7
JB
155 new TypeError(
156 'Cannot instantiate a dynamic pool without specifying the maximum pool size'
157 )
158 )
2761efb4
JB
159 expect(
160 () =>
161 new DynamicThreadPool(
162 0.5,
163 1,
b2fd3f4a 164 './tests/worker-files/thread/testWorker.mjs'
2761efb4 165 )
948faff7 166 ).toThrow(
2761efb4
JB
167 new TypeError(
168 'Cannot instantiate a pool with a non safe integer number of workers'
169 )
170 )
171 expect(
172 () =>
173 new DynamicClusterPool(
174 0,
175 0.5,
d35e5717 176 './tests/worker-files/cluster/testWorker.cjs'
2761efb4 177 )
948faff7 178 ).toThrow(
2761efb4
JB
179 new TypeError(
180 'Cannot instantiate a dynamic pool with a non safe integer maximum pool size'
181 )
182 )
2431bdb4
JB
183 expect(
184 () =>
b2fd3f4a
JB
185 new DynamicThreadPool(
186 2,
187 1,
188 './tests/worker-files/thread/testWorker.mjs'
189 )
948faff7 190 ).toThrow(
2431bdb4
JB
191 new RangeError(
192 'Cannot instantiate a dynamic pool with a maximum pool size inferior to the minimum pool size'
193 )
194 )
195 expect(
196 () =>
b2fd3f4a
JB
197 new DynamicThreadPool(
198 0,
199 0,
200 './tests/worker-files/thread/testWorker.mjs'
201 )
948faff7 202 ).toThrow(
2431bdb4 203 new RangeError(
213cbac6 204 'Cannot instantiate a dynamic pool with a maximum pool size equal to zero'
2431bdb4
JB
205 )
206 )
21f710aa
JB
207 expect(
208 () =>
213cbac6
JB
209 new DynamicClusterPool(
210 1,
211 1,
d35e5717 212 './tests/worker-files/cluster/testWorker.cjs'
213cbac6 213 )
948faff7 214 ).toThrow(
21f710aa 215 new RangeError(
213cbac6 216 'Cannot instantiate a dynamic pool with a minimum pool size equal to the maximum pool size. Use a fixed pool instead'
21f710aa
JB
217 )
218 )
2431bdb4
JB
219 })
220
fd7ebd49 221 it('Verify that pool options are checked', async () => {
7c0ba920
JB
222 let pool = new FixedThreadPool(
223 numberOfWorkers,
b2fd3f4a 224 './tests/worker-files/thread/testWorker.mjs'
7c0ba920 225 )
b5604034 226 expect(pool.emitter).toBeInstanceOf(EventEmitterAsyncResource)
e44639e9 227 expect(pool.emitter.eventNames()).toStrictEqual([])
47352846
JB
228 expect(pool.opts).toStrictEqual({
229 startWorkers: true,
230 enableEvents: true,
231 restartWorkerOnError: true,
232 enableTasksQueue: false,
26ce26ca 233 workerChoiceStrategy: WorkerChoiceStrategies.ROUND_ROBIN
8990357d 234 })
bcfb06ce 235 for (const [, workerChoiceStrategy] of pool.workerChoiceStrategiesContext
999ef664 236 .workerChoiceStrategies) {
86cbb766 237 expect(workerChoiceStrategy.opts).toStrictEqual({
86cbb766
JB
238 runTime: { median: false },
239 waitTime: { median: false },
240 elu: { median: false },
241 weights: expect.objectContaining({
242 0: expect.any(Number),
243 [pool.info.maxSize - 1]: expect.any(Number)
00e1bdeb 244 })
86cbb766 245 })
999ef664 246 }
fd7ebd49 247 await pool.destroy()
73bfd59d 248 const testHandler = () => console.info('test handler executed')
7c0ba920
JB
249 pool = new FixedThreadPool(
250 numberOfWorkers,
b2fd3f4a 251 './tests/worker-files/thread/testWorker.mjs',
7c0ba920 252 {
e4543b14 253 workerChoiceStrategy: WorkerChoiceStrategies.LEAST_USED,
49be33fe 254 workerChoiceStrategyOptions: {
932fc8be 255 runTime: { median: true },
fc027381 256 weights: { 0: 300, 1: 200 }
49be33fe 257 },
35cf1c03 258 enableEvents: false,
1f68cede 259 restartWorkerOnError: false,
ff733df7 260 enableTasksQueue: true,
d4aeae5a 261 tasksQueueOptions: { concurrency: 2 },
35cf1c03
JB
262 messageHandler: testHandler,
263 errorHandler: testHandler,
264 onlineHandler: testHandler,
265 exitHandler: testHandler
7c0ba920
JB
266 }
267 )
7c0ba920 268 expect(pool.emitter).toBeUndefined()
47352846
JB
269 expect(pool.opts).toStrictEqual({
270 startWorkers: true,
271 enableEvents: false,
272 restartWorkerOnError: false,
273 enableTasksQueue: true,
274 tasksQueueOptions: {
275 concurrency: 2,
2324f8c9 276 size: Math.pow(numberOfWorkers, 2),
dbd73092 277 taskStealing: true,
2eee7220 278 tasksStealingOnBackPressure: false,
568d0075 279 tasksFinishedTimeout: 2000
47352846
JB
280 },
281 workerChoiceStrategy: WorkerChoiceStrategies.LEAST_USED,
282 workerChoiceStrategyOptions: {
47352846 283 runTime: { median: true },
47352846
JB
284 weights: { 0: 300, 1: 200 }
285 },
286 onlineHandler: testHandler,
287 messageHandler: testHandler,
288 errorHandler: testHandler,
289 exitHandler: testHandler
8990357d 290 })
bcfb06ce 291 for (const [, workerChoiceStrategy] of pool.workerChoiceStrategiesContext
999ef664
JB
292 .workerChoiceStrategies) {
293 expect(workerChoiceStrategy.opts).toStrictEqual({
999ef664
JB
294 runTime: { median: true },
295 waitTime: { median: false },
296 elu: { median: false },
297 weights: { 0: 300, 1: 200 }
298 })
299 }
fd7ebd49 300 await pool.destroy()
7c0ba920
JB
301 })
302
fe291b64 303 it('Verify that pool options are validated', () => {
d4aeae5a
JB
304 expect(
305 () =>
306 new FixedThreadPool(
307 numberOfWorkers,
b2fd3f4a 308 './tests/worker-files/thread/testWorker.mjs',
d4aeae5a 309 {
f0d7f803 310 workerChoiceStrategy: 'invalidStrategy'
d4aeae5a
JB
311 }
312 )
948faff7 313 ).toThrow(new Error("Invalid worker choice strategy 'invalidStrategy'"))
49be33fe
JB
314 expect(
315 () =>
316 new FixedThreadPool(
317 numberOfWorkers,
b2fd3f4a 318 './tests/worker-files/thread/testWorker.mjs',
49be33fe
JB
319 {
320 workerChoiceStrategyOptions: { weights: {} }
321 }
322 )
948faff7 323 ).toThrow(
8735b4e5
JB
324 new Error(
325 'Invalid worker choice strategy options: must have a weight for each worker node'
326 )
49be33fe 327 )
f0d7f803
JB
328 expect(
329 () =>
330 new FixedThreadPool(
331 numberOfWorkers,
b2fd3f4a 332 './tests/worker-files/thread/testWorker.mjs',
f0d7f803
JB
333 {
334 workerChoiceStrategyOptions: { measurement: 'invalidMeasurement' }
335 }
336 )
948faff7 337 ).toThrow(
8735b4e5
JB
338 new Error(
339 "Invalid worker choice strategy options: invalid measurement 'invalidMeasurement'"
340 )
f0d7f803 341 )
5c4c2dee
JB
342 expect(
343 () =>
344 new FixedThreadPool(
345 numberOfWorkers,
b2fd3f4a 346 './tests/worker-files/thread/testWorker.mjs',
5c4c2dee
JB
347 {
348 enableTasksQueue: true,
349 tasksQueueOptions: 'invalidTasksQueueOptions'
350 }
351 )
948faff7 352 ).toThrow(
5c4c2dee
JB
353 new TypeError('Invalid tasks queue options: must be a plain object')
354 )
f0d7f803
JB
355 expect(
356 () =>
357 new FixedThreadPool(
358 numberOfWorkers,
b2fd3f4a 359 './tests/worker-files/thread/testWorker.mjs',
f0d7f803
JB
360 {
361 enableTasksQueue: true,
362 tasksQueueOptions: { concurrency: 0 }
363 }
364 )
948faff7 365 ).toThrow(
e695d66f 366 new RangeError(
20c6f652 367 'Invalid worker node tasks concurrency: 0 is a negative integer or zero'
8735b4e5
JB
368 )
369 )
f0d7f803
JB
370 expect(
371 () =>
372 new FixedThreadPool(
373 numberOfWorkers,
b2fd3f4a 374 './tests/worker-files/thread/testWorker.mjs',
f0d7f803
JB
375 {
376 enableTasksQueue: true,
5c4c2dee 377 tasksQueueOptions: { concurrency: -1 }
f0d7f803
JB
378 }
379 )
948faff7 380 ).toThrow(
5c4c2dee
JB
381 new RangeError(
382 'Invalid worker node tasks concurrency: -1 is a negative integer or zero'
383 )
8735b4e5 384 )
f0d7f803
JB
385 expect(
386 () =>
387 new FixedThreadPool(
388 numberOfWorkers,
b2fd3f4a 389 './tests/worker-files/thread/testWorker.mjs',
f0d7f803
JB
390 {
391 enableTasksQueue: true,
392 tasksQueueOptions: { concurrency: 0.2 }
393 }
394 )
948faff7 395 ).toThrow(
20c6f652 396 new TypeError('Invalid worker node tasks concurrency: must be an integer')
8735b4e5 397 )
5c4c2dee
JB
398 expect(
399 () =>
400 new FixedThreadPool(
401 numberOfWorkers,
b2fd3f4a 402 './tests/worker-files/thread/testWorker.mjs',
5c4c2dee
JB
403 {
404 enableTasksQueue: true,
405 tasksQueueOptions: { size: 0 }
406 }
407 )
948faff7 408 ).toThrow(
5c4c2dee
JB
409 new RangeError(
410 'Invalid worker node tasks queue size: 0 is a negative integer or zero'
411 )
412 )
413 expect(
414 () =>
415 new FixedThreadPool(
416 numberOfWorkers,
b2fd3f4a 417 './tests/worker-files/thread/testWorker.mjs',
5c4c2dee
JB
418 {
419 enableTasksQueue: true,
420 tasksQueueOptions: { size: -1 }
421 }
422 )
948faff7 423 ).toThrow(
5c4c2dee
JB
424 new RangeError(
425 'Invalid worker node tasks queue size: -1 is a negative integer or zero'
426 )
427 )
428 expect(
429 () =>
430 new FixedThreadPool(
431 numberOfWorkers,
b2fd3f4a 432 './tests/worker-files/thread/testWorker.mjs',
5c4c2dee
JB
433 {
434 enableTasksQueue: true,
435 tasksQueueOptions: { size: 0.2 }
436 }
437 )
948faff7 438 ).toThrow(
5c4c2dee
JB
439 new TypeError('Invalid worker node tasks queue size: must be an integer')
440 )
d4aeae5a
JB
441 })
442
2431bdb4 443 it('Verify that pool worker choice strategy options can be set', async () => {
a20f0ba5
JB
444 const pool = new FixedThreadPool(
445 numberOfWorkers,
b2fd3f4a 446 './tests/worker-files/thread/testWorker.mjs',
a20f0ba5
JB
447 { workerChoiceStrategy: WorkerChoiceStrategies.FAIR_SHARE }
448 )
26ce26ca 449 expect(pool.opts.workerChoiceStrategyOptions).toBeUndefined()
bcfb06ce 450 for (const [, workerChoiceStrategy] of pool.workerChoiceStrategiesContext
a20f0ba5 451 .workerChoiceStrategies) {
86cbb766 452 expect(workerChoiceStrategy.opts).toStrictEqual({
86cbb766
JB
453 runTime: { median: false },
454 waitTime: { median: false },
455 elu: { median: false },
456 weights: expect.objectContaining({
457 0: expect.any(Number),
458 [pool.info.maxSize - 1]: expect.any(Number)
00e1bdeb 459 })
86cbb766 460 })
a20f0ba5 461 }
87de9ff5 462 expect(
bcfb06ce 463 pool.workerChoiceStrategiesContext.getTaskStatisticsRequirements()
87de9ff5 464 ).toStrictEqual({
932fc8be
JB
465 runTime: {
466 aggregate: true,
467 average: true,
468 median: false
469 },
470 waitTime: {
e0843544
JB
471 aggregate: true,
472 average: true,
932fc8be
JB
473 median: false
474 },
5df69fab 475 elu: {
9adcefab
JB
476 aggregate: true,
477 average: true,
5df69fab
JB
478 median: false
479 }
86bf340d 480 })
9adcefab
JB
481 pool.setWorkerChoiceStrategyOptions({
482 runTime: { median: true },
483 elu: { median: true }
484 })
a20f0ba5 485 expect(pool.opts.workerChoiceStrategyOptions).toStrictEqual({
9adcefab 486 runTime: { median: true },
8990357d
JB
487 elu: { median: true }
488 })
bcfb06ce 489 for (const [, workerChoiceStrategy] of pool.workerChoiceStrategiesContext
a20f0ba5 490 .workerChoiceStrategies) {
86cbb766 491 expect(workerChoiceStrategy.opts).toStrictEqual({
86cbb766
JB
492 runTime: { median: true },
493 waitTime: { median: false },
494 elu: { median: true },
495 weights: expect.objectContaining({
496 0: expect.any(Number),
497 [pool.info.maxSize - 1]: expect.any(Number)
00e1bdeb 498 })
86cbb766 499 })
a20f0ba5 500 }
87de9ff5 501 expect(
bcfb06ce 502 pool.workerChoiceStrategiesContext.getTaskStatisticsRequirements()
87de9ff5 503 ).toStrictEqual({
932fc8be
JB
504 runTime: {
505 aggregate: true,
506 average: false,
507 median: true
508 },
509 waitTime: {
e0843544
JB
510 aggregate: true,
511 average: true,
932fc8be
JB
512 median: false
513 },
5df69fab 514 elu: {
9adcefab 515 aggregate: true,
5df69fab 516 average: false,
9adcefab 517 median: true
5df69fab 518 }
86bf340d 519 })
9adcefab
JB
520 pool.setWorkerChoiceStrategyOptions({
521 runTime: { median: false },
522 elu: { median: false }
523 })
a20f0ba5 524 expect(pool.opts.workerChoiceStrategyOptions).toStrictEqual({
8990357d 525 runTime: { median: false },
8990357d
JB
526 elu: { median: false }
527 })
bcfb06ce 528 for (const [, workerChoiceStrategy] of pool.workerChoiceStrategiesContext
a20f0ba5 529 .workerChoiceStrategies) {
86cbb766 530 expect(workerChoiceStrategy.opts).toStrictEqual({
86cbb766
JB
531 runTime: { median: false },
532 waitTime: { median: false },
533 elu: { median: false },
534 weights: expect.objectContaining({
535 0: expect.any(Number),
536 [pool.info.maxSize - 1]: expect.any(Number)
00e1bdeb 537 })
86cbb766 538 })
a20f0ba5 539 }
87de9ff5 540 expect(
bcfb06ce 541 pool.workerChoiceStrategiesContext.getTaskStatisticsRequirements()
87de9ff5 542 ).toStrictEqual({
932fc8be
JB
543 runTime: {
544 aggregate: true,
545 average: true,
546 median: false
547 },
548 waitTime: {
e0843544
JB
549 aggregate: true,
550 average: true,
932fc8be
JB
551 median: false
552 },
5df69fab 553 elu: {
9adcefab
JB
554 aggregate: true,
555 average: true,
5df69fab
JB
556 median: false
557 }
86bf340d 558 })
1f95d544
JB
559 expect(() =>
560 pool.setWorkerChoiceStrategyOptions('invalidWorkerChoiceStrategyOptions')
948faff7 561 ).toThrow(
8735b4e5
JB
562 new TypeError(
563 'Invalid worker choice strategy options: must be a plain object'
564 )
1f95d544 565 )
948faff7 566 expect(() => pool.setWorkerChoiceStrategyOptions({ weights: {} })).toThrow(
8735b4e5
JB
567 new Error(
568 'Invalid worker choice strategy options: must have a weight for each worker node'
569 )
1f95d544
JB
570 )
571 expect(() =>
572 pool.setWorkerChoiceStrategyOptions({ measurement: 'invalidMeasurement' })
948faff7 573 ).toThrow(
8735b4e5
JB
574 new Error(
575 "Invalid worker choice strategy options: invalid measurement 'invalidMeasurement'"
576 )
1f95d544 577 )
a20f0ba5
JB
578 await pool.destroy()
579 })
580
2431bdb4 581 it('Verify that pool tasks queue can be enabled/disabled', async () => {
a20f0ba5
JB
582 const pool = new FixedThreadPool(
583 numberOfWorkers,
b2fd3f4a 584 './tests/worker-files/thread/testWorker.mjs'
a20f0ba5
JB
585 )
586 expect(pool.opts.enableTasksQueue).toBe(false)
587 expect(pool.opts.tasksQueueOptions).toBeUndefined()
588 pool.enableTasksQueue(true)
589 expect(pool.opts.enableTasksQueue).toBe(true)
20c6f652
JB
590 expect(pool.opts.tasksQueueOptions).toStrictEqual({
591 concurrency: 1,
2324f8c9 592 size: Math.pow(numberOfWorkers, 2),
dbd73092 593 taskStealing: true,
2eee7220 594 tasksStealingOnBackPressure: false,
568d0075 595 tasksFinishedTimeout: 2000
20c6f652 596 })
a20f0ba5
JB
597 pool.enableTasksQueue(true, { concurrency: 2 })
598 expect(pool.opts.enableTasksQueue).toBe(true)
20c6f652
JB
599 expect(pool.opts.tasksQueueOptions).toStrictEqual({
600 concurrency: 2,
2324f8c9 601 size: Math.pow(numberOfWorkers, 2),
dbd73092 602 taskStealing: true,
2eee7220 603 tasksStealingOnBackPressure: false,
568d0075 604 tasksFinishedTimeout: 2000
20c6f652 605 })
a20f0ba5
JB
606 pool.enableTasksQueue(false)
607 expect(pool.opts.enableTasksQueue).toBe(false)
608 expect(pool.opts.tasksQueueOptions).toBeUndefined()
609 await pool.destroy()
610 })
611
2431bdb4 612 it('Verify that pool tasks queue options can be set', async () => {
a20f0ba5
JB
613 const pool = new FixedThreadPool(
614 numberOfWorkers,
b2fd3f4a 615 './tests/worker-files/thread/testWorker.mjs',
a20f0ba5
JB
616 { enableTasksQueue: true }
617 )
20c6f652
JB
618 expect(pool.opts.tasksQueueOptions).toStrictEqual({
619 concurrency: 1,
2324f8c9 620 size: Math.pow(numberOfWorkers, 2),
dbd73092 621 taskStealing: true,
2eee7220 622 tasksStealingOnBackPressure: false,
568d0075 623 tasksFinishedTimeout: 2000
20c6f652 624 })
d6ca1416 625 for (const workerNode of pool.workerNodes) {
2324f8c9
JB
626 expect(workerNode.tasksQueueBackPressureSize).toBe(
627 pool.opts.tasksQueueOptions.size
628 )
d6ca1416
JB
629 }
630 pool.setTasksQueueOptions({
631 concurrency: 2,
2324f8c9 632 size: 2,
d6ca1416 633 taskStealing: false,
32b141fd 634 tasksStealingOnBackPressure: false,
568d0075 635 tasksFinishedTimeout: 3000
d6ca1416 636 })
20c6f652
JB
637 expect(pool.opts.tasksQueueOptions).toStrictEqual({
638 concurrency: 2,
2324f8c9 639 size: 2,
d6ca1416 640 taskStealing: false,
32b141fd 641 tasksStealingOnBackPressure: false,
568d0075 642 tasksFinishedTimeout: 3000
d6ca1416
JB
643 })
644 for (const workerNode of pool.workerNodes) {
2324f8c9
JB
645 expect(workerNode.tasksQueueBackPressureSize).toBe(
646 pool.opts.tasksQueueOptions.size
647 )
d6ca1416
JB
648 }
649 pool.setTasksQueueOptions({
650 concurrency: 1,
651 taskStealing: true,
652 tasksStealingOnBackPressure: true
653 })
654 expect(pool.opts.tasksQueueOptions).toStrictEqual({
655 concurrency: 1,
2324f8c9 656 size: Math.pow(numberOfWorkers, 2),
dbd73092 657 taskStealing: true,
32b141fd 658 tasksStealingOnBackPressure: true,
568d0075 659 tasksFinishedTimeout: 2000
20c6f652 660 })
d6ca1416 661 for (const workerNode of pool.workerNodes) {
2324f8c9
JB
662 expect(workerNode.tasksQueueBackPressureSize).toBe(
663 pool.opts.tasksQueueOptions.size
664 )
d6ca1416 665 }
948faff7 666 expect(() => pool.setTasksQueueOptions('invalidTasksQueueOptions')).toThrow(
8735b4e5
JB
667 new TypeError('Invalid tasks queue options: must be a plain object')
668 )
948faff7 669 expect(() => pool.setTasksQueueOptions({ concurrency: 0 })).toThrow(
e695d66f 670 new RangeError(
20c6f652 671 'Invalid worker node tasks concurrency: 0 is a negative integer or zero'
8735b4e5
JB
672 )
673 )
948faff7 674 expect(() => pool.setTasksQueueOptions({ concurrency: -1 })).toThrow(
e695d66f 675 new RangeError(
20c6f652 676 'Invalid worker node tasks concurrency: -1 is a negative integer or zero'
8735b4e5 677 )
a20f0ba5 678 )
948faff7 679 expect(() => pool.setTasksQueueOptions({ concurrency: 0.2 })).toThrow(
20c6f652
JB
680 new TypeError('Invalid worker node tasks concurrency: must be an integer')
681 )
948faff7 682 expect(() => pool.setTasksQueueOptions({ size: 0 })).toThrow(
20c6f652 683 new RangeError(
68dbcdc0 684 'Invalid worker node tasks queue size: 0 is a negative integer or zero'
20c6f652
JB
685 )
686 )
948faff7 687 expect(() => pool.setTasksQueueOptions({ size: -1 })).toThrow(
20c6f652 688 new RangeError(
68dbcdc0 689 'Invalid worker node tasks queue size: -1 is a negative integer or zero'
20c6f652
JB
690 )
691 )
948faff7 692 expect(() => pool.setTasksQueueOptions({ size: 0.2 })).toThrow(
68dbcdc0 693 new TypeError('Invalid worker node tasks queue size: must be an integer')
f0d7f803 694 )
a20f0ba5
JB
695 await pool.destroy()
696 })
697
6b27d407
JB
698 it('Verify that pool info is set', async () => {
699 let pool = new FixedThreadPool(
700 numberOfWorkers,
b2fd3f4a 701 './tests/worker-files/thread/testWorker.mjs'
6b27d407 702 )
2dca6cab
JB
703 expect(pool.info).toStrictEqual({
704 version,
705 type: PoolTypes.fixed,
706 worker: WorkerTypes.thread,
47352846 707 started: true,
2dca6cab 708 ready: true,
bcfb06ce 709 defaultStrategy: WorkerChoiceStrategies.ROUND_ROBIN,
0e8587d2 710 strategyRetries: 0,
2dca6cab
JB
711 minSize: numberOfWorkers,
712 maxSize: numberOfWorkers,
713 workerNodes: numberOfWorkers,
714 idleWorkerNodes: numberOfWorkers,
715 busyWorkerNodes: 0,
716 executedTasks: 0,
717 executingTasks: 0,
2dca6cab
JB
718 failedTasks: 0
719 })
6b27d407
JB
720 await pool.destroy()
721 pool = new DynamicClusterPool(
2431bdb4 722 Math.floor(numberOfWorkers / 2),
6b27d407 723 numberOfWorkers,
d35e5717 724 './tests/worker-files/cluster/testWorker.cjs'
6b27d407 725 )
2dca6cab
JB
726 expect(pool.info).toStrictEqual({
727 version,
728 type: PoolTypes.dynamic,
729 worker: WorkerTypes.cluster,
47352846 730 started: true,
2dca6cab 731 ready: true,
bcfb06ce 732 defaultStrategy: WorkerChoiceStrategies.ROUND_ROBIN,
0e8587d2 733 strategyRetries: 0,
2dca6cab
JB
734 minSize: Math.floor(numberOfWorkers / 2),
735 maxSize: numberOfWorkers,
736 workerNodes: Math.floor(numberOfWorkers / 2),
737 idleWorkerNodes: Math.floor(numberOfWorkers / 2),
738 busyWorkerNodes: 0,
739 executedTasks: 0,
740 executingTasks: 0,
2dca6cab
JB
741 failedTasks: 0
742 })
6b27d407
JB
743 await pool.destroy()
744 })
745
2431bdb4 746 it('Verify that pool worker tasks usage are initialized', async () => {
bf9549ae
JB
747 const pool = new FixedClusterPool(
748 numberOfWorkers,
d35e5717 749 './tests/worker-files/cluster/testWorker.cjs'
bf9549ae 750 )
f06e48d8 751 for (const workerNode of pool.workerNodes) {
47352846 752 expect(workerNode).toBeInstanceOf(WorkerNode)
465b2940 753 expect(workerNode.usage).toStrictEqual({
a4e07f72
JB
754 tasks: {
755 executed: 0,
756 executing: 0,
757 queued: 0,
df593701 758 maxQueued: 0,
463226a4 759 sequentiallyStolen: 0,
68cbdc84 760 stolen: 0,
a4e07f72
JB
761 failed: 0
762 },
763 runTime: {
f12182ad 764 history: expect.any(CircularBuffer)
a4e07f72
JB
765 },
766 waitTime: {
f12182ad 767 history: expect.any(CircularBuffer)
a4e07f72 768 },
5df69fab
JB
769 elu: {
770 idle: {
f12182ad 771 history: expect.any(CircularBuffer)
5df69fab
JB
772 },
773 active: {
f12182ad 774 history: expect.any(CircularBuffer)
f7510105 775 }
5df69fab 776 }
86bf340d 777 })
f06e48d8
JB
778 }
779 await pool.destroy()
780 })
781
2431bdb4
JB
782 it('Verify that pool worker tasks queue are initialized', async () => {
783 let pool = new FixedClusterPool(
f06e48d8 784 numberOfWorkers,
d35e5717 785 './tests/worker-files/cluster/testWorker.cjs'
f06e48d8
JB
786 )
787 for (const workerNode of pool.workerNodes) {
47352846 788 expect(workerNode).toBeInstanceOf(WorkerNode)
95d1a734 789 expect(workerNode.tasksQueue).toBeInstanceOf(PriorityQueue)
4d8bf9e4 790 expect(workerNode.tasksQueue.size).toBe(0)
9c16fb4b 791 expect(workerNode.tasksQueue.maxSize).toBe(0)
2107bc57 792 expect(workerNode.tasksQueue.bucketSize).toBe(numberOfWorkers * 2)
bf9549ae 793 }
fd7ebd49 794 await pool.destroy()
2431bdb4
JB
795 pool = new DynamicThreadPool(
796 Math.floor(numberOfWorkers / 2),
797 numberOfWorkers,
b2fd3f4a 798 './tests/worker-files/thread/testWorker.mjs'
2431bdb4
JB
799 )
800 for (const workerNode of pool.workerNodes) {
47352846 801 expect(workerNode).toBeInstanceOf(WorkerNode)
95d1a734 802 expect(workerNode.tasksQueue).toBeInstanceOf(PriorityQueue)
2431bdb4
JB
803 expect(workerNode.tasksQueue.size).toBe(0)
804 expect(workerNode.tasksQueue.maxSize).toBe(0)
2107bc57 805 expect(workerNode.tasksQueue.bucketSize).toBe(numberOfWorkers * 2)
2431bdb4 806 }
213cbac6 807 await pool.destroy()
2431bdb4
JB
808 })
809
810 it('Verify that pool worker info are initialized', async () => {
811 let pool = new FixedClusterPool(
812 numberOfWorkers,
d35e5717 813 './tests/worker-files/cluster/testWorker.cjs'
2431bdb4 814 )
2dca6cab 815 for (const workerNode of pool.workerNodes) {
47352846 816 expect(workerNode).toBeInstanceOf(WorkerNode)
2dca6cab
JB
817 expect(workerNode.info).toStrictEqual({
818 id: expect.any(Number),
819 type: WorkerTypes.cluster,
820 dynamic: false,
5eb72b9e 821 ready: true,
85b553ba
JB
822 stealing: false,
823 backPressure: false
2dca6cab
JB
824 })
825 }
2431bdb4
JB
826 await pool.destroy()
827 pool = new DynamicThreadPool(
828 Math.floor(numberOfWorkers / 2),
829 numberOfWorkers,
b2fd3f4a 830 './tests/worker-files/thread/testWorker.mjs'
2431bdb4 831 )
2dca6cab 832 for (const workerNode of pool.workerNodes) {
47352846 833 expect(workerNode).toBeInstanceOf(WorkerNode)
2dca6cab
JB
834 expect(workerNode.info).toStrictEqual({
835 id: expect.any(Number),
836 type: WorkerTypes.thread,
837 dynamic: false,
5eb72b9e 838 ready: true,
85b553ba
JB
839 stealing: false,
840 backPressure: false
2dca6cab
JB
841 })
842 }
213cbac6 843 await pool.destroy()
bf9549ae
JB
844 })
845
711623b8
JB
846 it('Verify that pool statuses are checked at start or destroy', async () => {
847 const pool = new FixedThreadPool(
848 numberOfWorkers,
849 './tests/worker-files/thread/testWorker.mjs'
850 )
851 expect(pool.info.started).toBe(true)
852 expect(pool.info.ready).toBe(true)
853 expect(() => pool.start()).toThrow(
854 new Error('Cannot start an already started pool')
855 )
856 await pool.destroy()
857 expect(pool.info.started).toBe(false)
858 expect(pool.info.ready).toBe(false)
859 await expect(pool.destroy()).rejects.toThrow(
860 new Error('Cannot destroy an already destroyed pool')
861 )
862 })
863
47352846
JB
864 it('Verify that pool can be started after initialization', async () => {
865 const pool = new FixedClusterPool(
866 numberOfWorkers,
d35e5717 867 './tests/worker-files/cluster/testWorker.cjs',
47352846
JB
868 {
869 startWorkers: false
870 }
871 )
872 expect(pool.info.started).toBe(false)
873 expect(pool.info.ready).toBe(false)
874 expect(pool.workerNodes).toStrictEqual([])
8e8d9101 875 expect(pool.readyEventEmitted).toBe(false)
948faff7 876 await expect(pool.execute()).rejects.toThrow(
47352846
JB
877 new Error('Cannot execute a task on not started pool')
878 )
879 pool.start()
880 expect(pool.info.started).toBe(true)
881 expect(pool.info.ready).toBe(true)
55082af9
JB
882 await waitPoolEvents(pool, PoolEvents.ready, 1)
883 expect(pool.readyEventEmitted).toBe(true)
47352846
JB
884 expect(pool.workerNodes.length).toBe(numberOfWorkers)
885 for (const workerNode of pool.workerNodes) {
886 expect(workerNode).toBeInstanceOf(WorkerNode)
887 }
888 await pool.destroy()
889 })
890
9d2d0da1
JB
891 it('Verify that pool execute() arguments are checked', async () => {
892 const pool = new FixedClusterPool(
893 numberOfWorkers,
d35e5717 894 './tests/worker-files/cluster/testWorker.cjs'
9d2d0da1 895 )
948faff7 896 await expect(pool.execute(undefined, 0)).rejects.toThrow(
9d2d0da1
JB
897 new TypeError('name argument must be a string')
898 )
948faff7 899 await expect(pool.execute(undefined, '')).rejects.toThrow(
9d2d0da1
JB
900 new TypeError('name argument must not be an empty string')
901 )
948faff7 902 await expect(pool.execute(undefined, undefined, {})).rejects.toThrow(
9d2d0da1
JB
903 new TypeError('transferList argument must be an array')
904 )
905 await expect(pool.execute(undefined, 'unknown')).rejects.toBe(
906 "Task function 'unknown' not found"
907 )
908 await pool.destroy()
948faff7 909 await expect(pool.execute()).rejects.toThrow(
47352846 910 new Error('Cannot execute a task on not started pool')
9d2d0da1
JB
911 )
912 })
913
2431bdb4 914 it('Verify that pool worker tasks usage are computed', async () => {
bf9549ae
JB
915 const pool = new FixedClusterPool(
916 numberOfWorkers,
d35e5717 917 './tests/worker-files/cluster/testWorker.cjs'
bf9549ae 918 )
09c2d0d3 919 const promises = new Set()
fc027381
JB
920 const maxMultiplier = 2
921 for (let i = 0; i < numberOfWorkers * maxMultiplier; i++) {
09c2d0d3 922 promises.add(pool.execute())
bf9549ae 923 }
f06e48d8 924 for (const workerNode of pool.workerNodes) {
465b2940 925 expect(workerNode.usage).toStrictEqual({
a4e07f72
JB
926 tasks: {
927 executed: 0,
928 executing: maxMultiplier,
929 queued: 0,
df593701 930 maxQueued: 0,
463226a4 931 sequentiallyStolen: 0,
68cbdc84 932 stolen: 0,
a4e07f72
JB
933 failed: 0
934 },
935 runTime: {
f12182ad 936 history: expect.any(CircularBuffer)
a4e07f72
JB
937 },
938 waitTime: {
f12182ad 939 history: expect.any(CircularBuffer)
a4e07f72 940 },
5df69fab
JB
941 elu: {
942 idle: {
f12182ad 943 history: expect.any(CircularBuffer)
5df69fab
JB
944 },
945 active: {
f12182ad 946 history: expect.any(CircularBuffer)
f7510105 947 }
5df69fab 948 }
86bf340d 949 })
bf9549ae
JB
950 }
951 await Promise.all(promises)
f06e48d8 952 for (const workerNode of pool.workerNodes) {
465b2940 953 expect(workerNode.usage).toStrictEqual({
a4e07f72
JB
954 tasks: {
955 executed: maxMultiplier,
956 executing: 0,
957 queued: 0,
df593701 958 maxQueued: 0,
463226a4 959 sequentiallyStolen: 0,
68cbdc84 960 stolen: 0,
a4e07f72
JB
961 failed: 0
962 },
963 runTime: {
f12182ad 964 history: expect.any(CircularBuffer)
a4e07f72
JB
965 },
966 waitTime: {
f12182ad 967 history: expect.any(CircularBuffer)
a4e07f72 968 },
5df69fab
JB
969 elu: {
970 idle: {
f12182ad 971 history: expect.any(CircularBuffer)
5df69fab
JB
972 },
973 active: {
f12182ad 974 history: expect.any(CircularBuffer)
f7510105 975 }
5df69fab 976 }
86bf340d 977 })
bf9549ae 978 }
fd7ebd49 979 await pool.destroy()
bf9549ae
JB
980 })
981
bcfb06ce 982 it("Verify that pool worker tasks usage aren't reset at worker choice strategy change", async () => {
7fd82a1c 983 const pool = new DynamicThreadPool(
2431bdb4 984 Math.floor(numberOfWorkers / 2),
8f4878b7 985 numberOfWorkers,
b2fd3f4a 986 './tests/worker-files/thread/testWorker.mjs'
9e619829 987 )
09c2d0d3 988 const promises = new Set()
ee9f5295
JB
989 const maxMultiplier = 2
990 for (let i = 0; i < numberOfWorkers * maxMultiplier; i++) {
09c2d0d3 991 promises.add(pool.execute())
9e619829
JB
992 }
993 await Promise.all(promises)
f06e48d8 994 for (const workerNode of pool.workerNodes) {
465b2940 995 expect(workerNode.usage).toStrictEqual({
a4e07f72
JB
996 tasks: {
997 executed: expect.any(Number),
998 executing: 0,
999 queued: 0,
df593701 1000 maxQueued: 0,
463226a4 1001 sequentiallyStolen: 0,
68cbdc84 1002 stolen: 0,
a4e07f72
JB
1003 failed: 0
1004 },
1005 runTime: {
f12182ad 1006 history: expect.any(CircularBuffer)
a4e07f72
JB
1007 },
1008 waitTime: {
f12182ad 1009 history: expect.any(CircularBuffer)
a4e07f72 1010 },
5df69fab
JB
1011 elu: {
1012 idle: {
f12182ad 1013 history: expect.any(CircularBuffer)
5df69fab
JB
1014 },
1015 active: {
f12182ad 1016 history: expect.any(CircularBuffer)
f7510105 1017 }
5df69fab 1018 }
86bf340d 1019 })
465b2940 1020 expect(workerNode.usage.tasks.executed).toBeGreaterThan(0)
94407def
JB
1021 expect(workerNode.usage.tasks.executed).toBeLessThanOrEqual(
1022 numberOfWorkers * maxMultiplier
1023 )
9e619829
JB
1024 }
1025 pool.setWorkerChoiceStrategy(WorkerChoiceStrategies.FAIR_SHARE)
f06e48d8 1026 for (const workerNode of pool.workerNodes) {
465b2940 1027 expect(workerNode.usage).toStrictEqual({
a4e07f72 1028 tasks: {
bcfb06ce 1029 executed: expect.any(Number),
a4e07f72
JB
1030 executing: 0,
1031 queued: 0,
df593701 1032 maxQueued: 0,
463226a4 1033 sequentiallyStolen: 0,
68cbdc84 1034 stolen: 0,
a4e07f72
JB
1035 failed: 0
1036 },
1037 runTime: {
f12182ad 1038 history: expect.any(CircularBuffer)
a4e07f72
JB
1039 },
1040 waitTime: {
f12182ad 1041 history: expect.any(CircularBuffer)
a4e07f72 1042 },
5df69fab
JB
1043 elu: {
1044 idle: {
f12182ad 1045 history: expect.any(CircularBuffer)
5df69fab
JB
1046 },
1047 active: {
f12182ad 1048 history: expect.any(CircularBuffer)
f7510105 1049 }
5df69fab 1050 }
86bf340d 1051 })
bcfb06ce
JB
1052 expect(workerNode.usage.tasks.executed).toBeGreaterThan(0)
1053 expect(workerNode.usage.tasks.executed).toBeLessThanOrEqual(
1054 numberOfWorkers * maxMultiplier
1055 )
ee11a4a2 1056 }
fd7ebd49 1057 await pool.destroy()
ee11a4a2
JB
1058 })
1059
a1763c54
JB
1060 it("Verify that pool event emitter 'ready' event can register a callback", async () => {
1061 const pool = new DynamicClusterPool(
2431bdb4 1062 Math.floor(numberOfWorkers / 2),
164d950a 1063 numberOfWorkers,
d35e5717 1064 './tests/worker-files/cluster/testWorker.cjs'
164d950a 1065 )
c726f66c 1066 expect(pool.emitter.eventNames()).toStrictEqual([])
d46660cd 1067 let poolInfo
a1763c54 1068 let poolReady = 0
041dc05b 1069 pool.emitter.on(PoolEvents.ready, info => {
a1763c54 1070 ++poolReady
d46660cd
JB
1071 poolInfo = info
1072 })
a1763c54 1073 await waitPoolEvents(pool, PoolEvents.ready, 1)
c726f66c 1074 expect(pool.emitter.eventNames()).toStrictEqual([PoolEvents.ready])
a1763c54 1075 expect(poolReady).toBe(1)
d46660cd 1076 expect(poolInfo).toStrictEqual({
23ccf9d7 1077 version,
d46660cd 1078 type: PoolTypes.dynamic,
a1763c54 1079 worker: WorkerTypes.cluster,
47352846 1080 started: true,
a1763c54 1081 ready: true,
bcfb06ce 1082 defaultStrategy: WorkerChoiceStrategies.ROUND_ROBIN,
0e8587d2 1083 strategyRetries: expect.any(Number),
2431bdb4
JB
1084 minSize: expect.any(Number),
1085 maxSize: expect.any(Number),
1086 workerNodes: expect.any(Number),
1087 idleWorkerNodes: expect.any(Number),
1088 busyWorkerNodes: expect.any(Number),
1089 executedTasks: expect.any(Number),
1090 executingTasks: expect.any(Number),
2431bdb4
JB
1091 failedTasks: expect.any(Number)
1092 })
1093 await pool.destroy()
1094 })
1095
a1763c54
JB
1096 it("Verify that pool event emitter 'busy' event can register a callback", async () => {
1097 const pool = new FixedThreadPool(
2431bdb4 1098 numberOfWorkers,
b2fd3f4a 1099 './tests/worker-files/thread/testWorker.mjs'
2431bdb4 1100 )
c726f66c 1101 expect(pool.emitter.eventNames()).toStrictEqual([])
a1763c54
JB
1102 const promises = new Set()
1103 let poolBusy = 0
2431bdb4 1104 let poolInfo
041dc05b 1105 pool.emitter.on(PoolEvents.busy, info => {
a1763c54 1106 ++poolBusy
2431bdb4
JB
1107 poolInfo = info
1108 })
c726f66c 1109 expect(pool.emitter.eventNames()).toStrictEqual([PoolEvents.busy])
a1763c54
JB
1110 for (let i = 0; i < numberOfWorkers * 2; i++) {
1111 promises.add(pool.execute())
1112 }
1113 await Promise.all(promises)
1114 // The `busy` event is triggered when the number of submitted tasks at once reach the number of fixed pool workers.
1115 // So in total numberOfWorkers + 1 times for a loop submitting up to numberOfWorkers * 2 tasks to the fixed pool.
1116 expect(poolBusy).toBe(numberOfWorkers + 1)
2431bdb4
JB
1117 expect(poolInfo).toStrictEqual({
1118 version,
a1763c54
JB
1119 type: PoolTypes.fixed,
1120 worker: WorkerTypes.thread,
47352846
JB
1121 started: true,
1122 ready: true,
bcfb06ce 1123 defaultStrategy: WorkerChoiceStrategies.ROUND_ROBIN,
0e8587d2 1124 strategyRetries: expect.any(Number),
d46660cd
JB
1125 minSize: expect.any(Number),
1126 maxSize: expect.any(Number),
1127 workerNodes: expect.any(Number),
1128 idleWorkerNodes: expect.any(Number),
1129 busyWorkerNodes: expect.any(Number),
a4e07f72
JB
1130 executedTasks: expect.any(Number),
1131 executingTasks: expect.any(Number),
a4e07f72 1132 failedTasks: expect.any(Number)
d46660cd 1133 })
164d950a
JB
1134 await pool.destroy()
1135 })
1136
a1763c54
JB
1137 it("Verify that pool event emitter 'full' event can register a callback", async () => {
1138 const pool = new DynamicThreadPool(
1139 Math.floor(numberOfWorkers / 2),
7c0ba920 1140 numberOfWorkers,
b2fd3f4a 1141 './tests/worker-files/thread/testWorker.mjs'
7c0ba920 1142 )
c726f66c 1143 expect(pool.emitter.eventNames()).toStrictEqual([])
09c2d0d3 1144 const promises = new Set()
a1763c54 1145 let poolFull = 0
d46660cd 1146 let poolInfo
041dc05b 1147 pool.emitter.on(PoolEvents.full, info => {
a1763c54 1148 ++poolFull
d46660cd
JB
1149 poolInfo = info
1150 })
c726f66c 1151 expect(pool.emitter.eventNames()).toStrictEqual([PoolEvents.full])
7c0ba920 1152 for (let i = 0; i < numberOfWorkers * 2; i++) {
f5d14e90 1153 promises.add(pool.execute())
7c0ba920 1154 }
cf597bc5 1155 await Promise.all(promises)
33e6bb4c 1156 expect(poolFull).toBe(1)
d46660cd 1157 expect(poolInfo).toStrictEqual({
23ccf9d7 1158 version,
a1763c54 1159 type: PoolTypes.dynamic,
d46660cd 1160 worker: WorkerTypes.thread,
47352846
JB
1161 started: true,
1162 ready: true,
bcfb06ce 1163 defaultStrategy: WorkerChoiceStrategies.ROUND_ROBIN,
0e8587d2 1164 strategyRetries: expect.any(Number),
8735b4e5
JB
1165 minSize: expect.any(Number),
1166 maxSize: expect.any(Number),
1167 workerNodes: expect.any(Number),
1168 idleWorkerNodes: expect.any(Number),
1169 busyWorkerNodes: expect.any(Number),
1170 executedTasks: expect.any(Number),
1171 executingTasks: expect.any(Number),
1172 failedTasks: expect.any(Number)
1173 })
1174 await pool.destroy()
1175 })
1176
3e8611a8 1177 it("Verify that pool event emitter 'backPressure' event can register a callback", async () => {
b1aae695 1178 const pool = new FixedThreadPool(
8735b4e5 1179 numberOfWorkers,
b2fd3f4a 1180 './tests/worker-files/thread/testWorker.mjs',
8735b4e5
JB
1181 {
1182 enableTasksQueue: true
1183 }
1184 )
a074ffee 1185 stub(pool, 'hasBackPressure').returns(true)
c726f66c 1186 expect(pool.emitter.eventNames()).toStrictEqual([])
8735b4e5
JB
1187 const promises = new Set()
1188 let poolBackPressure = 0
1189 let poolInfo
041dc05b 1190 pool.emitter.on(PoolEvents.backPressure, info => {
8735b4e5
JB
1191 ++poolBackPressure
1192 poolInfo = info
1193 })
c726f66c 1194 expect(pool.emitter.eventNames()).toStrictEqual([PoolEvents.backPressure])
033f1776 1195 for (let i = 0; i < numberOfWorkers + 1; i++) {
8735b4e5
JB
1196 promises.add(pool.execute())
1197 }
1198 await Promise.all(promises)
033f1776 1199 expect(poolBackPressure).toBe(1)
8735b4e5
JB
1200 expect(poolInfo).toStrictEqual({
1201 version,
3e8611a8 1202 type: PoolTypes.fixed,
8735b4e5 1203 worker: WorkerTypes.thread,
47352846
JB
1204 started: true,
1205 ready: true,
bcfb06ce 1206 defaultStrategy: WorkerChoiceStrategies.ROUND_ROBIN,
0e8587d2 1207 strategyRetries: expect.any(Number),
d46660cd
JB
1208 minSize: expect.any(Number),
1209 maxSize: expect.any(Number),
1210 workerNodes: expect.any(Number),
1211 idleWorkerNodes: expect.any(Number),
5eb72b9e 1212 stealingWorkerNodes: expect.any(Number),
d46660cd 1213 busyWorkerNodes: expect.any(Number),
a4e07f72
JB
1214 executedTasks: expect.any(Number),
1215 executingTasks: expect.any(Number),
3e8611a8
JB
1216 maxQueuedTasks: expect.any(Number),
1217 queuedTasks: expect.any(Number),
1218 backPressure: true,
68cbdc84 1219 stolenTasks: expect.any(Number),
a4e07f72 1220 failedTasks: expect.any(Number)
d46660cd 1221 })
5eb72b9e 1222 expect(pool.hasBackPressure.callCount).toBeGreaterThanOrEqual(7)
fd7ebd49 1223 await pool.destroy()
7c0ba920 1224 })
70a4f5ea 1225
85b2561d
JB
1226 it('Verify that destroy() waits for queued tasks to finish', async () => {
1227 const tasksFinishedTimeout = 2500
1228 const pool = new FixedThreadPool(
1229 numberOfWorkers,
1230 './tests/worker-files/thread/asyncWorker.mjs',
1231 {
1232 enableTasksQueue: true,
1233 tasksQueueOptions: { tasksFinishedTimeout }
1234 }
1235 )
1236 const maxMultiplier = 4
1237 let tasksFinished = 0
1238 for (const workerNode of pool.workerNodes) {
1239 workerNode.on('taskFinished', () => {
1240 ++tasksFinished
1241 })
1242 }
1243 for (let i = 0; i < numberOfWorkers * maxMultiplier; i++) {
1244 pool.execute()
1245 }
1246 expect(pool.info.queuedTasks).toBeGreaterThan(0)
1247 const startTime = performance.now()
1248 await pool.destroy()
1249 const elapsedTime = performance.now() - startTime
90afa746 1250 expect(tasksFinished).toBeLessThanOrEqual(numberOfWorkers * maxMultiplier)
85b2561d 1251 expect(elapsedTime).toBeGreaterThanOrEqual(2000)
14d5e183 1252 expect(elapsedTime).toBeLessThanOrEqual(tasksFinishedTimeout + 800)
85b2561d
JB
1253 })
1254
1255 it('Verify that destroy() waits until the tasks finished timeout is reached', async () => {
1256 const tasksFinishedTimeout = 1000
1257 const pool = new FixedThreadPool(
1258 numberOfWorkers,
1259 './tests/worker-files/thread/asyncWorker.mjs',
1260 {
1261 enableTasksQueue: true,
1262 tasksQueueOptions: { tasksFinishedTimeout }
1263 }
1264 )
1265 const maxMultiplier = 4
1266 let tasksFinished = 0
1267 for (const workerNode of pool.workerNodes) {
1268 workerNode.on('taskFinished', () => {
1269 ++tasksFinished
1270 })
1271 }
1272 for (let i = 0; i < numberOfWorkers * maxMultiplier; i++) {
1273 pool.execute()
1274 }
1275 expect(pool.info.queuedTasks).toBeGreaterThan(0)
1276 const startTime = performance.now()
1277 await pool.destroy()
1278 const elapsedTime = performance.now() - startTime
1279 expect(tasksFinished).toBe(0)
2885534c 1280 expect(elapsedTime).toBeLessThanOrEqual(tasksFinishedTimeout + 800)
85b2561d
JB
1281 })
1282
f18fd12b
JB
1283 it('Verify that pool asynchronous resource track tasks execution', async () => {
1284 let taskAsyncId
1285 let initCalls = 0
1286 let beforeCalls = 0
1287 let afterCalls = 0
1288 let resolveCalls = 0
1289 const hook = createHook({
1290 init (asyncId, type) {
1291 if (type === 'poolifier:task') {
1292 initCalls++
1293 taskAsyncId = asyncId
1294 }
1295 },
1296 before (asyncId) {
1297 if (asyncId === taskAsyncId) beforeCalls++
1298 },
1299 after (asyncId) {
1300 if (asyncId === taskAsyncId) afterCalls++
1301 },
1302 promiseResolve () {
1303 if (executionAsyncId() === taskAsyncId) resolveCalls++
1304 }
1305 })
f18fd12b
JB
1306 const pool = new FixedThreadPool(
1307 numberOfWorkers,
1308 './tests/worker-files/thread/testWorker.mjs'
1309 )
8954c0a3 1310 hook.enable()
f18fd12b
JB
1311 await pool.execute()
1312 hook.disable()
1313 expect(initCalls).toBe(1)
1314 expect(beforeCalls).toBe(1)
1315 expect(afterCalls).toBe(1)
1316 expect(resolveCalls).toBe(1)
8954c0a3 1317 await pool.destroy()
f18fd12b
JB
1318 })
1319
9eae3c69
JB
1320 it('Verify that hasTaskFunction() is working', async () => {
1321 const dynamicThreadPool = new DynamicThreadPool(
1322 Math.floor(numberOfWorkers / 2),
1323 numberOfWorkers,
b2fd3f4a 1324 './tests/worker-files/thread/testMultipleTaskFunctionsWorker.mjs'
9eae3c69
JB
1325 )
1326 await waitPoolEvents(dynamicThreadPool, PoolEvents.ready, 1)
1327 expect(dynamicThreadPool.hasTaskFunction(DEFAULT_TASK_NAME)).toBe(true)
1328 expect(dynamicThreadPool.hasTaskFunction('jsonIntegerSerialization')).toBe(
1329 true
1330 )
1331 expect(dynamicThreadPool.hasTaskFunction('factorial')).toBe(true)
1332 expect(dynamicThreadPool.hasTaskFunction('fibonacci')).toBe(true)
1333 expect(dynamicThreadPool.hasTaskFunction('unknown')).toBe(false)
1334 await dynamicThreadPool.destroy()
1335 const fixedClusterPool = new FixedClusterPool(
1336 numberOfWorkers,
d35e5717 1337 './tests/worker-files/cluster/testMultipleTaskFunctionsWorker.cjs'
9eae3c69
JB
1338 )
1339 await waitPoolEvents(fixedClusterPool, PoolEvents.ready, 1)
1340 expect(fixedClusterPool.hasTaskFunction(DEFAULT_TASK_NAME)).toBe(true)
1341 expect(fixedClusterPool.hasTaskFunction('jsonIntegerSerialization')).toBe(
1342 true
1343 )
1344 expect(fixedClusterPool.hasTaskFunction('factorial')).toBe(true)
1345 expect(fixedClusterPool.hasTaskFunction('fibonacci')).toBe(true)
1346 expect(fixedClusterPool.hasTaskFunction('unknown')).toBe(false)
1347 await fixedClusterPool.destroy()
1348 })
1349
1350 it('Verify that addTaskFunction() is working', async () => {
1351 const dynamicThreadPool = new DynamicThreadPool(
1352 Math.floor(numberOfWorkers / 2),
1353 numberOfWorkers,
b2fd3f4a 1354 './tests/worker-files/thread/testWorker.mjs'
9eae3c69
JB
1355 )
1356 await waitPoolEvents(dynamicThreadPool, PoolEvents.ready, 1)
3feeab69
JB
1357 await expect(
1358 dynamicThreadPool.addTaskFunction(0, () => {})
948faff7 1359 ).rejects.toThrow(new TypeError('name argument must be a string'))
3feeab69
JB
1360 await expect(
1361 dynamicThreadPool.addTaskFunction('', () => {})
948faff7 1362 ).rejects.toThrow(
3feeab69
JB
1363 new TypeError('name argument must not be an empty string')
1364 )
948faff7 1365 await expect(dynamicThreadPool.addTaskFunction('test', 0)).rejects.toThrow(
31847469 1366 new TypeError('taskFunction property must be a function')
948faff7
JB
1367 )
1368 await expect(dynamicThreadPool.addTaskFunction('test', '')).rejects.toThrow(
31847469 1369 new TypeError('taskFunction property must be a function')
948faff7 1370 )
19c42d90
JB
1371 await expect(
1372 dynamicThreadPool.addTaskFunction('test', { taskFunction: 0 })
1373 ).rejects.toThrow(new TypeError('taskFunction property must be a function'))
1374 await expect(
1375 dynamicThreadPool.addTaskFunction('test', { taskFunction: '' })
1376 ).rejects.toThrow(new TypeError('taskFunction property must be a function'))
1377 await expect(
1378 dynamicThreadPool.addTaskFunction('test', {
1379 taskFunction: () => {},
1380 priority: -21
1381 })
1382 ).rejects.toThrow(
1383 new RangeError("Property 'priority' must be between -20 and 19")
1384 )
1385 await expect(
1386 dynamicThreadPool.addTaskFunction('test', {
1387 taskFunction: () => {},
1388 priority: 20
1389 })
1390 ).rejects.toThrow(
1391 new RangeError("Property 'priority' must be between -20 and 19")
1392 )
1393 await expect(
1394 dynamicThreadPool.addTaskFunction('test', {
1395 taskFunction: () => {},
1396 strategy: 'invalidStrategy'
1397 })
1398 ).rejects.toThrow(
1399 new Error("Invalid worker choice strategy 'invalidStrategy'")
1400 )
31847469
JB
1401 expect(dynamicThreadPool.listTaskFunctionsProperties()).toStrictEqual([
1402 { name: DEFAULT_TASK_NAME },
1403 { name: 'test' }
9eae3c69 1404 ])
f7a08a34
JB
1405 expect([
1406 ...dynamicThreadPool.workerChoiceStrategiesContext.workerChoiceStrategies.keys()
1407 ]).toStrictEqual([WorkerChoiceStrategies.ROUND_ROBIN])
9eae3c69
JB
1408 const echoTaskFunction = data => {
1409 return data
1410 }
1411 await expect(
f7a08a34
JB
1412 dynamicThreadPool.addTaskFunction('echo', {
1413 taskFunction: echoTaskFunction,
1414 strategy: WorkerChoiceStrategies.LEAST_ELU
1415 })
9eae3c69
JB
1416 ).resolves.toBe(true)
1417 expect(dynamicThreadPool.taskFunctions.size).toBe(1)
31847469 1418 expect(dynamicThreadPool.taskFunctions.get('echo')).toStrictEqual({
f7a08a34
JB
1419 taskFunction: echoTaskFunction,
1420 strategy: WorkerChoiceStrategies.LEAST_ELU
31847469 1421 })
f7a08a34
JB
1422 expect([
1423 ...dynamicThreadPool.workerChoiceStrategiesContext.workerChoiceStrategies.keys()
1424 ]).toStrictEqual([
1425 WorkerChoiceStrategies.ROUND_ROBIN,
1426 WorkerChoiceStrategies.LEAST_ELU
1427 ])
31847469
JB
1428 expect(dynamicThreadPool.listTaskFunctionsProperties()).toStrictEqual([
1429 { name: DEFAULT_TASK_NAME },
1430 { name: 'test' },
f7a08a34 1431 { name: 'echo', strategy: WorkerChoiceStrategies.LEAST_ELU }
9eae3c69
JB
1432 ])
1433 const taskFunctionData = { test: 'test' }
1434 const echoResult = await dynamicThreadPool.execute(taskFunctionData, 'echo')
1435 expect(echoResult).toStrictEqual(taskFunctionData)
adee6053
JB
1436 for (const workerNode of dynamicThreadPool.workerNodes) {
1437 expect(workerNode.getTaskFunctionWorkerUsage('echo')).toStrictEqual({
1438 tasks: {
1439 executed: expect.any(Number),
1440 executing: 0,
1441 queued: 0,
463226a4 1442 sequentiallyStolen: 0,
5ad42e34 1443 stolen: 0,
adee6053
JB
1444 failed: 0
1445 },
1446 runTime: {
f12182ad 1447 history: expect.any(CircularBuffer)
adee6053
JB
1448 },
1449 waitTime: {
f12182ad 1450 history: expect.any(CircularBuffer)
adee6053 1451 },
9a55fa8c
JB
1452 elu: expect.objectContaining({
1453 idle: expect.objectContaining({
f12182ad 1454 history: expect.any(CircularBuffer)
9a55fa8c
JB
1455 }),
1456 active: expect.objectContaining({
f12182ad 1457 history: expect.any(CircularBuffer)
9a55fa8c
JB
1458 })
1459 })
adee6053 1460 })
9a55fa8c
JB
1461 expect(
1462 workerNode.getTaskFunctionWorkerUsage('echo').tasks.executed
1463 ).toBeGreaterThan(0)
1464 if (
1465 workerNode.getTaskFunctionWorkerUsage('echo').elu.active.aggregate ==
1466 null
1467 ) {
1468 expect(
1469 workerNode.getTaskFunctionWorkerUsage('echo').elu.active.aggregate
1470 ).toBeUndefined()
1471 } else {
1472 expect(
1473 workerNode.getTaskFunctionWorkerUsage('echo').elu.active.aggregate
1474 ).toBeGreaterThan(0)
1475 }
1476 if (
1477 workerNode.getTaskFunctionWorkerUsage('echo').elu.idle.aggregate == null
1478 ) {
1479 expect(
1480 workerNode.getTaskFunctionWorkerUsage('echo').elu.idle.aggregate
1481 ).toBeUndefined()
1482 } else {
1483 expect(
1484 workerNode.getTaskFunctionWorkerUsage('echo').elu.idle.aggregate
1485 ).toBeGreaterThanOrEqual(0)
1486 }
1487 if (
1488 workerNode.getTaskFunctionWorkerUsage('echo').elu.utilization == null
1489 ) {
1490 expect(
1491 workerNode.getTaskFunctionWorkerUsage('echo').elu.utilization
1492 ).toBeUndefined()
1493 } else {
1494 expect(
1495 workerNode.getTaskFunctionWorkerUsage('echo').elu.utilization
1496 ).toBeGreaterThanOrEqual(0)
1497 expect(
1498 workerNode.getTaskFunctionWorkerUsage('echo').elu.utilization
1499 ).toBeLessThanOrEqual(1)
1500 }
adee6053 1501 }
9eae3c69
JB
1502 await dynamicThreadPool.destroy()
1503 })
1504
1505 it('Verify that removeTaskFunction() is working', async () => {
1506 const dynamicThreadPool = new DynamicThreadPool(
1507 Math.floor(numberOfWorkers / 2),
1508 numberOfWorkers,
b2fd3f4a 1509 './tests/worker-files/thread/testWorker.mjs'
9eae3c69
JB
1510 )
1511 await waitPoolEvents(dynamicThreadPool, PoolEvents.ready, 1)
31847469
JB
1512 expect(dynamicThreadPool.listTaskFunctionsProperties()).toStrictEqual([
1513 { name: DEFAULT_TASK_NAME },
1514 { name: 'test' }
9eae3c69 1515 ])
948faff7 1516 await expect(dynamicThreadPool.removeTaskFunction('test')).rejects.toThrow(
16248b23 1517 new Error('Cannot remove a task function not handled on the pool side')
9eae3c69
JB
1518 )
1519 const echoTaskFunction = data => {
1520 return data
1521 }
f7a08a34
JB
1522 await dynamicThreadPool.addTaskFunction('echo', {
1523 taskFunction: echoTaskFunction,
1524 strategy: WorkerChoiceStrategies.LEAST_ELU
1525 })
9eae3c69 1526 expect(dynamicThreadPool.taskFunctions.size).toBe(1)
31847469 1527 expect(dynamicThreadPool.taskFunctions.get('echo')).toStrictEqual({
f7a08a34
JB
1528 taskFunction: echoTaskFunction,
1529 strategy: WorkerChoiceStrategies.LEAST_ELU
31847469 1530 })
f7a08a34
JB
1531 expect([
1532 ...dynamicThreadPool.workerChoiceStrategiesContext.workerChoiceStrategies.keys()
1533 ]).toStrictEqual([
1534 WorkerChoiceStrategies.ROUND_ROBIN,
1535 WorkerChoiceStrategies.LEAST_ELU
1536 ])
31847469
JB
1537 expect(dynamicThreadPool.listTaskFunctionsProperties()).toStrictEqual([
1538 { name: DEFAULT_TASK_NAME },
1539 { name: 'test' },
f7a08a34 1540 { name: 'echo', strategy: WorkerChoiceStrategies.LEAST_ELU }
9eae3c69
JB
1541 ])
1542 await expect(dynamicThreadPool.removeTaskFunction('echo')).resolves.toBe(
1543 true
1544 )
1545 expect(dynamicThreadPool.taskFunctions.size).toBe(0)
1546 expect(dynamicThreadPool.taskFunctions.get('echo')).toBeUndefined()
f7a08a34
JB
1547 expect([
1548 ...dynamicThreadPool.workerChoiceStrategiesContext.workerChoiceStrategies.keys()
1549 ]).toStrictEqual([WorkerChoiceStrategies.ROUND_ROBIN])
31847469
JB
1550 expect(dynamicThreadPool.listTaskFunctionsProperties()).toStrictEqual([
1551 { name: DEFAULT_TASK_NAME },
1552 { name: 'test' }
9eae3c69
JB
1553 ])
1554 await dynamicThreadPool.destroy()
1555 })
1556
f7a08a34 1557 it('Verify that listTaskFunctionsProperties() is working', async () => {
90d7d101
JB
1558 const dynamicThreadPool = new DynamicThreadPool(
1559 Math.floor(numberOfWorkers / 2),
1560 numberOfWorkers,
b2fd3f4a 1561 './tests/worker-files/thread/testMultipleTaskFunctionsWorker.mjs'
90d7d101
JB
1562 )
1563 await waitPoolEvents(dynamicThreadPool, PoolEvents.ready, 1)
31847469
JB
1564 expect(dynamicThreadPool.listTaskFunctionsProperties()).toStrictEqual([
1565 { name: DEFAULT_TASK_NAME },
1566 { name: 'jsonIntegerSerialization' },
1567 { name: 'factorial' },
1568 { name: 'fibonacci' }
90d7d101 1569 ])
9eae3c69 1570 await dynamicThreadPool.destroy()
90d7d101
JB
1571 const fixedClusterPool = new FixedClusterPool(
1572 numberOfWorkers,
d35e5717 1573 './tests/worker-files/cluster/testMultipleTaskFunctionsWorker.cjs'
90d7d101
JB
1574 )
1575 await waitPoolEvents(fixedClusterPool, PoolEvents.ready, 1)
31847469
JB
1576 expect(fixedClusterPool.listTaskFunctionsProperties()).toStrictEqual([
1577 { name: DEFAULT_TASK_NAME },
1578 { name: 'jsonIntegerSerialization' },
1579 { name: 'factorial' },
1580 { name: 'fibonacci' }
90d7d101 1581 ])
0fe39c97 1582 await fixedClusterPool.destroy()
90d7d101
JB
1583 })
1584
9eae3c69 1585 it('Verify that setDefaultTaskFunction() is working', async () => {
30500265
JB
1586 const dynamicThreadPool = new DynamicThreadPool(
1587 Math.floor(numberOfWorkers / 2),
1588 numberOfWorkers,
b2fd3f4a 1589 './tests/worker-files/thread/testMultipleTaskFunctionsWorker.mjs'
30500265
JB
1590 )
1591 await waitPoolEvents(dynamicThreadPool, PoolEvents.ready, 1)
711623b8 1592 const workerId = dynamicThreadPool.workerNodes[0].info.id
948faff7 1593 await expect(dynamicThreadPool.setDefaultTaskFunction(0)).rejects.toThrow(
b0b55f57 1594 new Error(
711623b8 1595 `Task function operation 'default' failed on worker ${workerId} with error: 'TypeError: name parameter is not a string'`
b0b55f57
JB
1596 )
1597 )
1598 await expect(
1599 dynamicThreadPool.setDefaultTaskFunction(DEFAULT_TASK_NAME)
948faff7 1600 ).rejects.toThrow(
b0b55f57 1601 new Error(
711623b8 1602 `Task function operation 'default' failed on worker ${workerId} with error: 'Error: Cannot set the default task function reserved name as the default task function'`
b0b55f57
JB
1603 )
1604 )
1605 await expect(
1606 dynamicThreadPool.setDefaultTaskFunction('unknown')
948faff7 1607 ).rejects.toThrow(
b0b55f57 1608 new Error(
711623b8 1609 `Task function operation 'default' failed on worker ${workerId} with error: 'Error: Cannot set the default task function to a non-existing task function'`
b0b55f57
JB
1610 )
1611 )
31847469
JB
1612 expect(dynamicThreadPool.listTaskFunctionsProperties()).toStrictEqual([
1613 { name: DEFAULT_TASK_NAME },
1614 { name: 'jsonIntegerSerialization' },
1615 { name: 'factorial' },
1616 { name: 'fibonacci' }
9eae3c69
JB
1617 ])
1618 await expect(
1619 dynamicThreadPool.setDefaultTaskFunction('factorial')
1620 ).resolves.toBe(true)
31847469
JB
1621 expect(dynamicThreadPool.listTaskFunctionsProperties()).toStrictEqual([
1622 { name: DEFAULT_TASK_NAME },
1623 { name: 'factorial' },
1624 { name: 'jsonIntegerSerialization' },
1625 { name: 'fibonacci' }
9eae3c69
JB
1626 ])
1627 await expect(
1628 dynamicThreadPool.setDefaultTaskFunction('fibonacci')
1629 ).resolves.toBe(true)
31847469
JB
1630 expect(dynamicThreadPool.listTaskFunctionsProperties()).toStrictEqual([
1631 { name: DEFAULT_TASK_NAME },
1632 { name: 'fibonacci' },
1633 { name: 'jsonIntegerSerialization' },
1634 { name: 'factorial' }
9eae3c69 1635 ])
cda9ba34 1636 await dynamicThreadPool.destroy()
30500265
JB
1637 })
1638
90d7d101 1639 it('Verify that multiple task functions worker is working', async () => {
70a4f5ea 1640 const pool = new DynamicClusterPool(
2431bdb4 1641 Math.floor(numberOfWorkers / 2),
70a4f5ea 1642 numberOfWorkers,
d35e5717 1643 './tests/worker-files/cluster/testMultipleTaskFunctionsWorker.cjs'
70a4f5ea
JB
1644 )
1645 const data = { n: 10 }
82888165 1646 const result0 = await pool.execute(data)
30b963d4 1647 expect(result0).toStrictEqual({ ok: 1 })
70a4f5ea 1648 const result1 = await pool.execute(data, 'jsonIntegerSerialization')
30b963d4 1649 expect(result1).toStrictEqual({ ok: 1 })
70a4f5ea
JB
1650 const result2 = await pool.execute(data, 'factorial')
1651 expect(result2).toBe(3628800)
1652 const result3 = await pool.execute(data, 'fibonacci')
024daf59 1653 expect(result3).toBe(55)
5bb5be17
JB
1654 expect(pool.info.executingTasks).toBe(0)
1655 expect(pool.info.executedTasks).toBe(4)
b414b84c 1656 for (const workerNode of pool.workerNodes) {
31847469
JB
1657 expect(workerNode.info.taskFunctionsProperties).toStrictEqual([
1658 { name: DEFAULT_TASK_NAME },
1659 { name: 'jsonIntegerSerialization' },
1660 { name: 'factorial' },
1661 { name: 'fibonacci' }
b414b84c
JB
1662 ])
1663 expect(workerNode.taskFunctionsUsage.size).toBe(3)
74111331 1664 expect(workerNode.usage.tasks.executed).toBeGreaterThan(0)
31847469
JB
1665 for (const taskFunctionProperties of pool.listTaskFunctionsProperties()) {
1666 expect(
1667 workerNode.getTaskFunctionWorkerUsage(taskFunctionProperties.name)
1668 ).toStrictEqual({
5bb5be17
JB
1669 tasks: {
1670 executed: expect.any(Number),
4ba4c7f9 1671 executing: 0,
5bb5be17 1672 failed: 0,
68cbdc84 1673 queued: 0,
463226a4 1674 sequentiallyStolen: 0,
68cbdc84 1675 stolen: 0
5bb5be17
JB
1676 },
1677 runTime: {
f12182ad 1678 history: expect.any(CircularBuffer)
5bb5be17
JB
1679 },
1680 waitTime: {
f12182ad 1681 history: expect.any(CircularBuffer)
5bb5be17
JB
1682 },
1683 elu: {
1684 idle: {
f12182ad 1685 history: expect.any(CircularBuffer)
5bb5be17
JB
1686 },
1687 active: {
f12182ad 1688 history: expect.any(CircularBuffer)
5bb5be17
JB
1689 }
1690 }
1691 })
1692 expect(
31847469
JB
1693 workerNode.getTaskFunctionWorkerUsage(taskFunctionProperties.name)
1694 .tasks.executed
4ba4c7f9 1695 ).toBeGreaterThan(0)
5bb5be17 1696 }
dfd7ec01
JB
1697 expect(
1698 workerNode.getTaskFunctionWorkerUsage(DEFAULT_TASK_NAME)
8139fbbc
JB
1699 ).toStrictEqual(
1700 workerNode.getTaskFunctionWorkerUsage(
1701 workerNode.info.taskFunctionsProperties[1].name
1702 )
1703 )
1704 }
1705 await pool.destroy()
1706 })
1707
1708 it('Verify that task function objects worker is working', async () => {
1709 const pool = new DynamicThreadPool(
1710 Math.floor(numberOfWorkers / 2),
1711 numberOfWorkers,
1712 './tests/worker-files/thread/testTaskFunctionObjectsWorker.mjs'
1713 )
1714 const data = { n: 10 }
1715 const result0 = await pool.execute(data)
1716 expect(result0).toStrictEqual({ ok: 1 })
1717 const result1 = await pool.execute(data, 'jsonIntegerSerialization')
1718 expect(result1).toStrictEqual({ ok: 1 })
1719 const result2 = await pool.execute(data, 'factorial')
1720 expect(result2).toBe(3628800)
1721 const result3 = await pool.execute(data, 'fibonacci')
1722 expect(result3).toBe(55)
1723 expect(pool.info.executingTasks).toBe(0)
1724 expect(pool.info.executedTasks).toBe(4)
1725 for (const workerNode of pool.workerNodes) {
1726 expect(workerNode.info.taskFunctionsProperties).toStrictEqual([
1727 { name: DEFAULT_TASK_NAME },
1728 { name: 'jsonIntegerSerialization' },
1729 { name: 'factorial' },
1730 { name: 'fibonacci' }
1731 ])
1732 expect(workerNode.taskFunctionsUsage.size).toBe(3)
1733 expect(workerNode.usage.tasks.executed).toBeGreaterThan(0)
1734 for (const taskFunctionProperties of pool.listTaskFunctionsProperties()) {
1735 expect(
1736 workerNode.getTaskFunctionWorkerUsage(taskFunctionProperties.name)
1737 ).toStrictEqual({
1738 tasks: {
1739 executed: expect.any(Number),
1740 executing: 0,
1741 failed: 0,
1742 queued: 0,
1743 sequentiallyStolen: 0,
1744 stolen: 0
1745 },
1746 runTime: {
f12182ad 1747 history: expect.any(CircularBuffer)
8139fbbc
JB
1748 },
1749 waitTime: {
f12182ad 1750 history: expect.any(CircularBuffer)
8139fbbc
JB
1751 },
1752 elu: {
1753 idle: {
f12182ad 1754 history: expect.any(CircularBuffer)
8139fbbc
JB
1755 },
1756 active: {
f12182ad 1757 history: expect.any(CircularBuffer)
8139fbbc
JB
1758 }
1759 }
1760 })
1761 expect(
1762 workerNode.getTaskFunctionWorkerUsage(taskFunctionProperties.name)
1763 .tasks.executed
1764 ).toBeGreaterThan(0)
1765 }
1766 expect(
1767 workerNode.getTaskFunctionWorkerUsage(DEFAULT_TASK_NAME)
dfd7ec01 1768 ).toStrictEqual(
66979634 1769 workerNode.getTaskFunctionWorkerUsage(
31847469 1770 workerNode.info.taskFunctionsProperties[1].name
66979634 1771 )
dfd7ec01 1772 )
5bb5be17 1773 }
0fe39c97 1774 await pool.destroy()
70a4f5ea 1775 })
52a23942
JB
1776
1777 it('Verify sendKillMessageToWorker()', async () => {
1778 const pool = new DynamicClusterPool(
1779 Math.floor(numberOfWorkers / 2),
1780 numberOfWorkers,
d35e5717 1781 './tests/worker-files/cluster/testWorker.cjs'
52a23942
JB
1782 )
1783 const workerNodeKey = 0
1784 await expect(
adee6053 1785 pool.sendKillMessageToWorker(workerNodeKey)
52a23942
JB
1786 ).resolves.toBeUndefined()
1787 await pool.destroy()
1788 })
adee6053
JB
1789
1790 it('Verify sendTaskFunctionOperationToWorker()', async () => {
1791 const pool = new DynamicClusterPool(
1792 Math.floor(numberOfWorkers / 2),
1793 numberOfWorkers,
d35e5717 1794 './tests/worker-files/cluster/testWorker.cjs'
adee6053
JB
1795 )
1796 const workerNodeKey = 0
1797 await expect(
1798 pool.sendTaskFunctionOperationToWorker(workerNodeKey, {
1799 taskFunctionOperation: 'add',
31847469 1800 taskFunctionProperties: { name: 'empty' },
adee6053
JB
1801 taskFunction: (() => {}).toString()
1802 })
1803 ).resolves.toBe(true)
1804 expect(
31847469
JB
1805 pool.workerNodes[workerNodeKey].info.taskFunctionsProperties
1806 ).toStrictEqual([
1807 { name: DEFAULT_TASK_NAME },
1808 { name: 'test' },
1809 { name: 'empty' }
1810 ])
adee6053
JB
1811 await pool.destroy()
1812 })
1813
1814 it('Verify sendTaskFunctionOperationToWorkers()', async () => {
1815 const pool = new DynamicClusterPool(
1816 Math.floor(numberOfWorkers / 2),
1817 numberOfWorkers,
d35e5717 1818 './tests/worker-files/cluster/testWorker.cjs'
adee6053 1819 )
adee6053
JB
1820 await expect(
1821 pool.sendTaskFunctionOperationToWorkers({
1822 taskFunctionOperation: 'add',
31847469 1823 taskFunctionProperties: { name: 'empty' },
adee6053
JB
1824 taskFunction: (() => {}).toString()
1825 })
1826 ).resolves.toBe(true)
1827 for (const workerNode of pool.workerNodes) {
31847469
JB
1828 expect(workerNode.info.taskFunctionsProperties).toStrictEqual([
1829 { name: DEFAULT_TASK_NAME },
1830 { name: 'test' },
1831 { name: 'empty' }
adee6053
JB
1832 ])
1833 }
1834 await pool.destroy()
1835 })
3ec964d6 1836})