docs: generate documentation
[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
JB
10
11import { CircularArray } from '../../lib/circular-array.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,
32b141fd 278 tasksStealingOnBackPressure: true,
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,
32b141fd 594 tasksStealingOnBackPressure: true,
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,
32b141fd 603 tasksStealingOnBackPressure: true,
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,
32b141fd 622 tasksStealingOnBackPressure: true,
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: {
4ba4c7f9 764 history: new CircularArray()
a4e07f72
JB
765 },
766 waitTime: {
4ba4c7f9 767 history: new CircularArray()
a4e07f72 768 },
5df69fab
JB
769 elu: {
770 idle: {
4ba4c7f9 771 history: new CircularArray()
5df69fab
JB
772 },
773 active: {
4ba4c7f9 774 history: new CircularArray()
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)
59ca7cff 792 expect(workerNode.tasksQueue.k).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)
59ca7cff 805 expect(workerNode.tasksQueue.k).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
JB
821 ready: true,
822 stealing: false
2dca6cab
JB
823 })
824 }
2431bdb4
JB
825 await pool.destroy()
826 pool = new DynamicThreadPool(
827 Math.floor(numberOfWorkers / 2),
828 numberOfWorkers,
b2fd3f4a 829 './tests/worker-files/thread/testWorker.mjs'
2431bdb4 830 )
2dca6cab 831 for (const workerNode of pool.workerNodes) {
47352846 832 expect(workerNode).toBeInstanceOf(WorkerNode)
2dca6cab
JB
833 expect(workerNode.info).toStrictEqual({
834 id: expect.any(Number),
835 type: WorkerTypes.thread,
836 dynamic: false,
5eb72b9e
JB
837 ready: true,
838 stealing: false
2dca6cab
JB
839 })
840 }
213cbac6 841 await pool.destroy()
bf9549ae
JB
842 })
843
711623b8
JB
844 it('Verify that pool statuses are checked at start or destroy', async () => {
845 const pool = new FixedThreadPool(
846 numberOfWorkers,
847 './tests/worker-files/thread/testWorker.mjs'
848 )
849 expect(pool.info.started).toBe(true)
850 expect(pool.info.ready).toBe(true)
851 expect(() => pool.start()).toThrow(
852 new Error('Cannot start an already started pool')
853 )
854 await pool.destroy()
855 expect(pool.info.started).toBe(false)
856 expect(pool.info.ready).toBe(false)
857 await expect(pool.destroy()).rejects.toThrow(
858 new Error('Cannot destroy an already destroyed pool')
859 )
860 })
861
47352846
JB
862 it('Verify that pool can be started after initialization', async () => {
863 const pool = new FixedClusterPool(
864 numberOfWorkers,
d35e5717 865 './tests/worker-files/cluster/testWorker.cjs',
47352846
JB
866 {
867 startWorkers: false
868 }
869 )
870 expect(pool.info.started).toBe(false)
871 expect(pool.info.ready).toBe(false)
872 expect(pool.workerNodes).toStrictEqual([])
8e8d9101 873 expect(pool.readyEventEmitted).toBe(false)
948faff7 874 await expect(pool.execute()).rejects.toThrow(
47352846
JB
875 new Error('Cannot execute a task on not started pool')
876 )
877 pool.start()
878 expect(pool.info.started).toBe(true)
879 expect(pool.info.ready).toBe(true)
55082af9
JB
880 await waitPoolEvents(pool, PoolEvents.ready, 1)
881 expect(pool.readyEventEmitted).toBe(true)
47352846
JB
882 expect(pool.workerNodes.length).toBe(numberOfWorkers)
883 for (const workerNode of pool.workerNodes) {
884 expect(workerNode).toBeInstanceOf(WorkerNode)
885 }
886 await pool.destroy()
887 })
888
9d2d0da1
JB
889 it('Verify that pool execute() arguments are checked', async () => {
890 const pool = new FixedClusterPool(
891 numberOfWorkers,
d35e5717 892 './tests/worker-files/cluster/testWorker.cjs'
9d2d0da1 893 )
948faff7 894 await expect(pool.execute(undefined, 0)).rejects.toThrow(
9d2d0da1
JB
895 new TypeError('name argument must be a string')
896 )
948faff7 897 await expect(pool.execute(undefined, '')).rejects.toThrow(
9d2d0da1
JB
898 new TypeError('name argument must not be an empty string')
899 )
948faff7 900 await expect(pool.execute(undefined, undefined, {})).rejects.toThrow(
9d2d0da1
JB
901 new TypeError('transferList argument must be an array')
902 )
903 await expect(pool.execute(undefined, 'unknown')).rejects.toBe(
904 "Task function 'unknown' not found"
905 )
906 await pool.destroy()
948faff7 907 await expect(pool.execute()).rejects.toThrow(
47352846 908 new Error('Cannot execute a task on not started pool')
9d2d0da1
JB
909 )
910 })
911
2431bdb4 912 it('Verify that pool worker tasks usage are computed', async () => {
bf9549ae
JB
913 const pool = new FixedClusterPool(
914 numberOfWorkers,
d35e5717 915 './tests/worker-files/cluster/testWorker.cjs'
bf9549ae 916 )
09c2d0d3 917 const promises = new Set()
fc027381
JB
918 const maxMultiplier = 2
919 for (let i = 0; i < numberOfWorkers * maxMultiplier; i++) {
09c2d0d3 920 promises.add(pool.execute())
bf9549ae 921 }
f06e48d8 922 for (const workerNode of pool.workerNodes) {
465b2940 923 expect(workerNode.usage).toStrictEqual({
a4e07f72
JB
924 tasks: {
925 executed: 0,
926 executing: maxMultiplier,
927 queued: 0,
df593701 928 maxQueued: 0,
463226a4 929 sequentiallyStolen: 0,
68cbdc84 930 stolen: 0,
a4e07f72
JB
931 failed: 0
932 },
933 runTime: {
a4e07f72
JB
934 history: expect.any(CircularArray)
935 },
936 waitTime: {
a4e07f72
JB
937 history: expect.any(CircularArray)
938 },
5df69fab
JB
939 elu: {
940 idle: {
5df69fab
JB
941 history: expect.any(CircularArray)
942 },
943 active: {
5df69fab 944 history: expect.any(CircularArray)
f7510105 945 }
5df69fab 946 }
86bf340d 947 })
bf9549ae
JB
948 }
949 await Promise.all(promises)
f06e48d8 950 for (const workerNode of pool.workerNodes) {
465b2940 951 expect(workerNode.usage).toStrictEqual({
a4e07f72
JB
952 tasks: {
953 executed: maxMultiplier,
954 executing: 0,
955 queued: 0,
df593701 956 maxQueued: 0,
463226a4 957 sequentiallyStolen: 0,
68cbdc84 958 stolen: 0,
a4e07f72
JB
959 failed: 0
960 },
961 runTime: {
a4e07f72
JB
962 history: expect.any(CircularArray)
963 },
964 waitTime: {
a4e07f72
JB
965 history: expect.any(CircularArray)
966 },
5df69fab
JB
967 elu: {
968 idle: {
5df69fab
JB
969 history: expect.any(CircularArray)
970 },
971 active: {
5df69fab 972 history: expect.any(CircularArray)
f7510105 973 }
5df69fab 974 }
86bf340d 975 })
bf9549ae 976 }
fd7ebd49 977 await pool.destroy()
bf9549ae
JB
978 })
979
bcfb06ce 980 it("Verify that pool worker tasks usage aren't reset at worker choice strategy change", async () => {
7fd82a1c 981 const pool = new DynamicThreadPool(
2431bdb4 982 Math.floor(numberOfWorkers / 2),
8f4878b7 983 numberOfWorkers,
b2fd3f4a 984 './tests/worker-files/thread/testWorker.mjs'
9e619829 985 )
09c2d0d3 986 const promises = new Set()
ee9f5295
JB
987 const maxMultiplier = 2
988 for (let i = 0; i < numberOfWorkers * maxMultiplier; i++) {
09c2d0d3 989 promises.add(pool.execute())
9e619829
JB
990 }
991 await Promise.all(promises)
f06e48d8 992 for (const workerNode of pool.workerNodes) {
465b2940 993 expect(workerNode.usage).toStrictEqual({
a4e07f72
JB
994 tasks: {
995 executed: expect.any(Number),
996 executing: 0,
997 queued: 0,
df593701 998 maxQueued: 0,
463226a4 999 sequentiallyStolen: 0,
68cbdc84 1000 stolen: 0,
a4e07f72
JB
1001 failed: 0
1002 },
1003 runTime: {
a4e07f72
JB
1004 history: expect.any(CircularArray)
1005 },
1006 waitTime: {
a4e07f72
JB
1007 history: expect.any(CircularArray)
1008 },
5df69fab
JB
1009 elu: {
1010 idle: {
5df69fab
JB
1011 history: expect.any(CircularArray)
1012 },
1013 active: {
5df69fab 1014 history: expect.any(CircularArray)
f7510105 1015 }
5df69fab 1016 }
86bf340d 1017 })
465b2940 1018 expect(workerNode.usage.tasks.executed).toBeGreaterThan(0)
94407def
JB
1019 expect(workerNode.usage.tasks.executed).toBeLessThanOrEqual(
1020 numberOfWorkers * maxMultiplier
1021 )
b97d82d8
JB
1022 expect(workerNode.usage.runTime.history.length).toBe(0)
1023 expect(workerNode.usage.waitTime.history.length).toBe(0)
1024 expect(workerNode.usage.elu.idle.history.length).toBe(0)
1025 expect(workerNode.usage.elu.active.history.length).toBe(0)
9e619829
JB
1026 }
1027 pool.setWorkerChoiceStrategy(WorkerChoiceStrategies.FAIR_SHARE)
f06e48d8 1028 for (const workerNode of pool.workerNodes) {
465b2940 1029 expect(workerNode.usage).toStrictEqual({
a4e07f72 1030 tasks: {
bcfb06ce 1031 executed: expect.any(Number),
a4e07f72
JB
1032 executing: 0,
1033 queued: 0,
df593701 1034 maxQueued: 0,
463226a4 1035 sequentiallyStolen: 0,
68cbdc84 1036 stolen: 0,
a4e07f72
JB
1037 failed: 0
1038 },
1039 runTime: {
a4e07f72
JB
1040 history: expect.any(CircularArray)
1041 },
1042 waitTime: {
a4e07f72
JB
1043 history: expect.any(CircularArray)
1044 },
5df69fab
JB
1045 elu: {
1046 idle: {
5df69fab
JB
1047 history: expect.any(CircularArray)
1048 },
1049 active: {
5df69fab 1050 history: expect.any(CircularArray)
f7510105 1051 }
5df69fab 1052 }
86bf340d 1053 })
bcfb06ce
JB
1054 expect(workerNode.usage.tasks.executed).toBeGreaterThan(0)
1055 expect(workerNode.usage.tasks.executed).toBeLessThanOrEqual(
1056 numberOfWorkers * maxMultiplier
1057 )
465b2940
JB
1058 expect(workerNode.usage.runTime.history.length).toBe(0)
1059 expect(workerNode.usage.waitTime.history.length).toBe(0)
b97d82d8
JB
1060 expect(workerNode.usage.elu.idle.history.length).toBe(0)
1061 expect(workerNode.usage.elu.active.history.length).toBe(0)
ee11a4a2 1062 }
fd7ebd49 1063 await pool.destroy()
ee11a4a2
JB
1064 })
1065
a1763c54
JB
1066 it("Verify that pool event emitter 'ready' event can register a callback", async () => {
1067 const pool = new DynamicClusterPool(
2431bdb4 1068 Math.floor(numberOfWorkers / 2),
164d950a 1069 numberOfWorkers,
d35e5717 1070 './tests/worker-files/cluster/testWorker.cjs'
164d950a 1071 )
c726f66c 1072 expect(pool.emitter.eventNames()).toStrictEqual([])
d46660cd 1073 let poolInfo
a1763c54 1074 let poolReady = 0
041dc05b 1075 pool.emitter.on(PoolEvents.ready, info => {
a1763c54 1076 ++poolReady
d46660cd
JB
1077 poolInfo = info
1078 })
a1763c54 1079 await waitPoolEvents(pool, PoolEvents.ready, 1)
c726f66c 1080 expect(pool.emitter.eventNames()).toStrictEqual([PoolEvents.ready])
a1763c54 1081 expect(poolReady).toBe(1)
d46660cd 1082 expect(poolInfo).toStrictEqual({
23ccf9d7 1083 version,
d46660cd 1084 type: PoolTypes.dynamic,
a1763c54 1085 worker: WorkerTypes.cluster,
47352846 1086 started: true,
a1763c54 1087 ready: true,
bcfb06ce 1088 defaultStrategy: WorkerChoiceStrategies.ROUND_ROBIN,
0e8587d2 1089 strategyRetries: expect.any(Number),
2431bdb4
JB
1090 minSize: expect.any(Number),
1091 maxSize: expect.any(Number),
1092 workerNodes: expect.any(Number),
1093 idleWorkerNodes: expect.any(Number),
1094 busyWorkerNodes: expect.any(Number),
1095 executedTasks: expect.any(Number),
1096 executingTasks: expect.any(Number),
2431bdb4
JB
1097 failedTasks: expect.any(Number)
1098 })
1099 await pool.destroy()
1100 })
1101
a1763c54
JB
1102 it("Verify that pool event emitter 'busy' event can register a callback", async () => {
1103 const pool = new FixedThreadPool(
2431bdb4 1104 numberOfWorkers,
b2fd3f4a 1105 './tests/worker-files/thread/testWorker.mjs'
2431bdb4 1106 )
c726f66c 1107 expect(pool.emitter.eventNames()).toStrictEqual([])
a1763c54
JB
1108 const promises = new Set()
1109 let poolBusy = 0
2431bdb4 1110 let poolInfo
041dc05b 1111 pool.emitter.on(PoolEvents.busy, info => {
a1763c54 1112 ++poolBusy
2431bdb4
JB
1113 poolInfo = info
1114 })
c726f66c 1115 expect(pool.emitter.eventNames()).toStrictEqual([PoolEvents.busy])
a1763c54
JB
1116 for (let i = 0; i < numberOfWorkers * 2; i++) {
1117 promises.add(pool.execute())
1118 }
1119 await Promise.all(promises)
1120 // The `busy` event is triggered when the number of submitted tasks at once reach the number of fixed pool workers.
1121 // So in total numberOfWorkers + 1 times for a loop submitting up to numberOfWorkers * 2 tasks to the fixed pool.
1122 expect(poolBusy).toBe(numberOfWorkers + 1)
2431bdb4
JB
1123 expect(poolInfo).toStrictEqual({
1124 version,
a1763c54
JB
1125 type: PoolTypes.fixed,
1126 worker: WorkerTypes.thread,
47352846
JB
1127 started: true,
1128 ready: true,
bcfb06ce 1129 defaultStrategy: WorkerChoiceStrategies.ROUND_ROBIN,
0e8587d2 1130 strategyRetries: expect.any(Number),
d46660cd
JB
1131 minSize: expect.any(Number),
1132 maxSize: expect.any(Number),
1133 workerNodes: expect.any(Number),
1134 idleWorkerNodes: expect.any(Number),
1135 busyWorkerNodes: expect.any(Number),
a4e07f72
JB
1136 executedTasks: expect.any(Number),
1137 executingTasks: expect.any(Number),
a4e07f72 1138 failedTasks: expect.any(Number)
d46660cd 1139 })
164d950a
JB
1140 await pool.destroy()
1141 })
1142
a1763c54
JB
1143 it("Verify that pool event emitter 'full' event can register a callback", async () => {
1144 const pool = new DynamicThreadPool(
1145 Math.floor(numberOfWorkers / 2),
7c0ba920 1146 numberOfWorkers,
b2fd3f4a 1147 './tests/worker-files/thread/testWorker.mjs'
7c0ba920 1148 )
c726f66c 1149 expect(pool.emitter.eventNames()).toStrictEqual([])
09c2d0d3 1150 const promises = new Set()
a1763c54 1151 let poolFull = 0
d46660cd 1152 let poolInfo
041dc05b 1153 pool.emitter.on(PoolEvents.full, info => {
a1763c54 1154 ++poolFull
d46660cd
JB
1155 poolInfo = info
1156 })
c726f66c 1157 expect(pool.emitter.eventNames()).toStrictEqual([PoolEvents.full])
7c0ba920 1158 for (let i = 0; i < numberOfWorkers * 2; i++) {
f5d14e90 1159 promises.add(pool.execute())
7c0ba920 1160 }
cf597bc5 1161 await Promise.all(promises)
33e6bb4c 1162 expect(poolFull).toBe(1)
d46660cd 1163 expect(poolInfo).toStrictEqual({
23ccf9d7 1164 version,
a1763c54 1165 type: PoolTypes.dynamic,
d46660cd 1166 worker: WorkerTypes.thread,
47352846
JB
1167 started: true,
1168 ready: true,
bcfb06ce 1169 defaultStrategy: WorkerChoiceStrategies.ROUND_ROBIN,
0e8587d2 1170 strategyRetries: expect.any(Number),
8735b4e5
JB
1171 minSize: expect.any(Number),
1172 maxSize: expect.any(Number),
1173 workerNodes: expect.any(Number),
1174 idleWorkerNodes: expect.any(Number),
1175 busyWorkerNodes: expect.any(Number),
1176 executedTasks: expect.any(Number),
1177 executingTasks: expect.any(Number),
1178 failedTasks: expect.any(Number)
1179 })
1180 await pool.destroy()
1181 })
1182
3e8611a8 1183 it("Verify that pool event emitter 'backPressure' event can register a callback", async () => {
b1aae695 1184 const pool = new FixedThreadPool(
8735b4e5 1185 numberOfWorkers,
b2fd3f4a 1186 './tests/worker-files/thread/testWorker.mjs',
8735b4e5
JB
1187 {
1188 enableTasksQueue: true
1189 }
1190 )
a074ffee 1191 stub(pool, 'hasBackPressure').returns(true)
c726f66c 1192 expect(pool.emitter.eventNames()).toStrictEqual([])
8735b4e5
JB
1193 const promises = new Set()
1194 let poolBackPressure = 0
1195 let poolInfo
041dc05b 1196 pool.emitter.on(PoolEvents.backPressure, info => {
8735b4e5
JB
1197 ++poolBackPressure
1198 poolInfo = info
1199 })
c726f66c 1200 expect(pool.emitter.eventNames()).toStrictEqual([PoolEvents.backPressure])
033f1776 1201 for (let i = 0; i < numberOfWorkers + 1; i++) {
8735b4e5
JB
1202 promises.add(pool.execute())
1203 }
1204 await Promise.all(promises)
033f1776 1205 expect(poolBackPressure).toBe(1)
8735b4e5
JB
1206 expect(poolInfo).toStrictEqual({
1207 version,
3e8611a8 1208 type: PoolTypes.fixed,
8735b4e5 1209 worker: WorkerTypes.thread,
47352846
JB
1210 started: true,
1211 ready: true,
bcfb06ce 1212 defaultStrategy: WorkerChoiceStrategies.ROUND_ROBIN,
0e8587d2 1213 strategyRetries: expect.any(Number),
d46660cd
JB
1214 minSize: expect.any(Number),
1215 maxSize: expect.any(Number),
1216 workerNodes: expect.any(Number),
1217 idleWorkerNodes: expect.any(Number),
5eb72b9e 1218 stealingWorkerNodes: expect.any(Number),
d46660cd 1219 busyWorkerNodes: expect.any(Number),
a4e07f72
JB
1220 executedTasks: expect.any(Number),
1221 executingTasks: expect.any(Number),
3e8611a8
JB
1222 maxQueuedTasks: expect.any(Number),
1223 queuedTasks: expect.any(Number),
1224 backPressure: true,
68cbdc84 1225 stolenTasks: expect.any(Number),
a4e07f72 1226 failedTasks: expect.any(Number)
d46660cd 1227 })
5eb72b9e 1228 expect(pool.hasBackPressure.callCount).toBeGreaterThanOrEqual(7)
fd7ebd49 1229 await pool.destroy()
7c0ba920 1230 })
70a4f5ea 1231
85b2561d
JB
1232 it('Verify that destroy() waits for queued tasks to finish', async () => {
1233 const tasksFinishedTimeout = 2500
1234 const pool = new FixedThreadPool(
1235 numberOfWorkers,
1236 './tests/worker-files/thread/asyncWorker.mjs',
1237 {
1238 enableTasksQueue: true,
1239 tasksQueueOptions: { tasksFinishedTimeout }
1240 }
1241 )
1242 const maxMultiplier = 4
1243 let tasksFinished = 0
1244 for (const workerNode of pool.workerNodes) {
1245 workerNode.on('taskFinished', () => {
1246 ++tasksFinished
1247 })
1248 }
1249 for (let i = 0; i < numberOfWorkers * maxMultiplier; i++) {
1250 pool.execute()
1251 }
1252 expect(pool.info.queuedTasks).toBeGreaterThan(0)
1253 const startTime = performance.now()
1254 await pool.destroy()
1255 const elapsedTime = performance.now() - startTime
90afa746 1256 expect(tasksFinished).toBeLessThanOrEqual(numberOfWorkers * maxMultiplier)
85b2561d 1257 expect(elapsedTime).toBeGreaterThanOrEqual(2000)
14d5e183 1258 expect(elapsedTime).toBeLessThanOrEqual(tasksFinishedTimeout + 800)
85b2561d
JB
1259 })
1260
1261 it('Verify that destroy() waits until the tasks finished timeout is reached', async () => {
1262 const tasksFinishedTimeout = 1000
1263 const pool = new FixedThreadPool(
1264 numberOfWorkers,
1265 './tests/worker-files/thread/asyncWorker.mjs',
1266 {
1267 enableTasksQueue: true,
1268 tasksQueueOptions: { tasksFinishedTimeout }
1269 }
1270 )
1271 const maxMultiplier = 4
1272 let tasksFinished = 0
1273 for (const workerNode of pool.workerNodes) {
1274 workerNode.on('taskFinished', () => {
1275 ++tasksFinished
1276 })
1277 }
1278 for (let i = 0; i < numberOfWorkers * maxMultiplier; i++) {
1279 pool.execute()
1280 }
1281 expect(pool.info.queuedTasks).toBeGreaterThan(0)
1282 const startTime = performance.now()
1283 await pool.destroy()
1284 const elapsedTime = performance.now() - startTime
1285 expect(tasksFinished).toBe(0)
2885534c 1286 expect(elapsedTime).toBeLessThanOrEqual(tasksFinishedTimeout + 800)
85b2561d
JB
1287 })
1288
f18fd12b
JB
1289 it('Verify that pool asynchronous resource track tasks execution', async () => {
1290 let taskAsyncId
1291 let initCalls = 0
1292 let beforeCalls = 0
1293 let afterCalls = 0
1294 let resolveCalls = 0
1295 const hook = createHook({
1296 init (asyncId, type) {
1297 if (type === 'poolifier:task') {
1298 initCalls++
1299 taskAsyncId = asyncId
1300 }
1301 },
1302 before (asyncId) {
1303 if (asyncId === taskAsyncId) beforeCalls++
1304 },
1305 after (asyncId) {
1306 if (asyncId === taskAsyncId) afterCalls++
1307 },
1308 promiseResolve () {
1309 if (executionAsyncId() === taskAsyncId) resolveCalls++
1310 }
1311 })
f18fd12b
JB
1312 const pool = new FixedThreadPool(
1313 numberOfWorkers,
1314 './tests/worker-files/thread/testWorker.mjs'
1315 )
8954c0a3 1316 hook.enable()
f18fd12b
JB
1317 await pool.execute()
1318 hook.disable()
1319 expect(initCalls).toBe(1)
1320 expect(beforeCalls).toBe(1)
1321 expect(afterCalls).toBe(1)
1322 expect(resolveCalls).toBe(1)
8954c0a3 1323 await pool.destroy()
f18fd12b
JB
1324 })
1325
9eae3c69
JB
1326 it('Verify that hasTaskFunction() is working', async () => {
1327 const dynamicThreadPool = new DynamicThreadPool(
1328 Math.floor(numberOfWorkers / 2),
1329 numberOfWorkers,
b2fd3f4a 1330 './tests/worker-files/thread/testMultipleTaskFunctionsWorker.mjs'
9eae3c69
JB
1331 )
1332 await waitPoolEvents(dynamicThreadPool, PoolEvents.ready, 1)
1333 expect(dynamicThreadPool.hasTaskFunction(DEFAULT_TASK_NAME)).toBe(true)
1334 expect(dynamicThreadPool.hasTaskFunction('jsonIntegerSerialization')).toBe(
1335 true
1336 )
1337 expect(dynamicThreadPool.hasTaskFunction('factorial')).toBe(true)
1338 expect(dynamicThreadPool.hasTaskFunction('fibonacci')).toBe(true)
1339 expect(dynamicThreadPool.hasTaskFunction('unknown')).toBe(false)
1340 await dynamicThreadPool.destroy()
1341 const fixedClusterPool = new FixedClusterPool(
1342 numberOfWorkers,
d35e5717 1343 './tests/worker-files/cluster/testMultipleTaskFunctionsWorker.cjs'
9eae3c69
JB
1344 )
1345 await waitPoolEvents(fixedClusterPool, PoolEvents.ready, 1)
1346 expect(fixedClusterPool.hasTaskFunction(DEFAULT_TASK_NAME)).toBe(true)
1347 expect(fixedClusterPool.hasTaskFunction('jsonIntegerSerialization')).toBe(
1348 true
1349 )
1350 expect(fixedClusterPool.hasTaskFunction('factorial')).toBe(true)
1351 expect(fixedClusterPool.hasTaskFunction('fibonacci')).toBe(true)
1352 expect(fixedClusterPool.hasTaskFunction('unknown')).toBe(false)
1353 await fixedClusterPool.destroy()
1354 })
1355
1356 it('Verify that addTaskFunction() is working', async () => {
1357 const dynamicThreadPool = new DynamicThreadPool(
1358 Math.floor(numberOfWorkers / 2),
1359 numberOfWorkers,
b2fd3f4a 1360 './tests/worker-files/thread/testWorker.mjs'
9eae3c69
JB
1361 )
1362 await waitPoolEvents(dynamicThreadPool, PoolEvents.ready, 1)
3feeab69
JB
1363 await expect(
1364 dynamicThreadPool.addTaskFunction(0, () => {})
948faff7 1365 ).rejects.toThrow(new TypeError('name argument must be a string'))
3feeab69
JB
1366 await expect(
1367 dynamicThreadPool.addTaskFunction('', () => {})
948faff7 1368 ).rejects.toThrow(
3feeab69
JB
1369 new TypeError('name argument must not be an empty string')
1370 )
948faff7 1371 await expect(dynamicThreadPool.addTaskFunction('test', 0)).rejects.toThrow(
31847469 1372 new TypeError('taskFunction property must be a function')
948faff7
JB
1373 )
1374 await expect(dynamicThreadPool.addTaskFunction('test', '')).rejects.toThrow(
31847469 1375 new TypeError('taskFunction property must be a function')
948faff7 1376 )
19c42d90
JB
1377 await expect(
1378 dynamicThreadPool.addTaskFunction('test', { taskFunction: 0 })
1379 ).rejects.toThrow(new TypeError('taskFunction property must be a function'))
1380 await expect(
1381 dynamicThreadPool.addTaskFunction('test', { taskFunction: '' })
1382 ).rejects.toThrow(new TypeError('taskFunction property must be a function'))
1383 await expect(
1384 dynamicThreadPool.addTaskFunction('test', {
1385 taskFunction: () => {},
1386 priority: -21
1387 })
1388 ).rejects.toThrow(
1389 new RangeError("Property 'priority' must be between -20 and 19")
1390 )
1391 await expect(
1392 dynamicThreadPool.addTaskFunction('test', {
1393 taskFunction: () => {},
1394 priority: 20
1395 })
1396 ).rejects.toThrow(
1397 new RangeError("Property 'priority' must be between -20 and 19")
1398 )
1399 await expect(
1400 dynamicThreadPool.addTaskFunction('test', {
1401 taskFunction: () => {},
1402 strategy: 'invalidStrategy'
1403 })
1404 ).rejects.toThrow(
1405 new Error("Invalid worker choice strategy 'invalidStrategy'")
1406 )
31847469
JB
1407 expect(dynamicThreadPool.listTaskFunctionsProperties()).toStrictEqual([
1408 { name: DEFAULT_TASK_NAME },
1409 { name: 'test' }
9eae3c69 1410 ])
f7a08a34
JB
1411 expect([
1412 ...dynamicThreadPool.workerChoiceStrategiesContext.workerChoiceStrategies.keys()
1413 ]).toStrictEqual([WorkerChoiceStrategies.ROUND_ROBIN])
9eae3c69
JB
1414 const echoTaskFunction = data => {
1415 return data
1416 }
1417 await expect(
f7a08a34
JB
1418 dynamicThreadPool.addTaskFunction('echo', {
1419 taskFunction: echoTaskFunction,
1420 strategy: WorkerChoiceStrategies.LEAST_ELU
1421 })
9eae3c69
JB
1422 ).resolves.toBe(true)
1423 expect(dynamicThreadPool.taskFunctions.size).toBe(1)
31847469 1424 expect(dynamicThreadPool.taskFunctions.get('echo')).toStrictEqual({
f7a08a34
JB
1425 taskFunction: echoTaskFunction,
1426 strategy: WorkerChoiceStrategies.LEAST_ELU
31847469 1427 })
f7a08a34
JB
1428 expect([
1429 ...dynamicThreadPool.workerChoiceStrategiesContext.workerChoiceStrategies.keys()
1430 ]).toStrictEqual([
1431 WorkerChoiceStrategies.ROUND_ROBIN,
1432 WorkerChoiceStrategies.LEAST_ELU
1433 ])
31847469
JB
1434 expect(dynamicThreadPool.listTaskFunctionsProperties()).toStrictEqual([
1435 { name: DEFAULT_TASK_NAME },
1436 { name: 'test' },
f7a08a34 1437 { name: 'echo', strategy: WorkerChoiceStrategies.LEAST_ELU }
9eae3c69
JB
1438 ])
1439 const taskFunctionData = { test: 'test' }
1440 const echoResult = await dynamicThreadPool.execute(taskFunctionData, 'echo')
1441 expect(echoResult).toStrictEqual(taskFunctionData)
adee6053
JB
1442 for (const workerNode of dynamicThreadPool.workerNodes) {
1443 expect(workerNode.getTaskFunctionWorkerUsage('echo')).toStrictEqual({
1444 tasks: {
1445 executed: expect.any(Number),
1446 executing: 0,
1447 queued: 0,
463226a4 1448 sequentiallyStolen: 0,
5ad42e34 1449 stolen: 0,
adee6053
JB
1450 failed: 0
1451 },
1452 runTime: {
1453 history: new CircularArray()
1454 },
1455 waitTime: {
1456 history: new CircularArray()
1457 },
9a55fa8c
JB
1458 elu: expect.objectContaining({
1459 idle: expect.objectContaining({
1460 history: expect.any(CircularArray)
1461 }),
1462 active: expect.objectContaining({
1463 history: expect.any(CircularArray)
1464 })
1465 })
adee6053 1466 })
9a55fa8c
JB
1467 expect(
1468 workerNode.getTaskFunctionWorkerUsage('echo').tasks.executed
1469 ).toBeGreaterThan(0)
1470 if (
1471 workerNode.getTaskFunctionWorkerUsage('echo').elu.active.aggregate ==
1472 null
1473 ) {
1474 expect(
1475 workerNode.getTaskFunctionWorkerUsage('echo').elu.active.aggregate
1476 ).toBeUndefined()
1477 } else {
1478 expect(
1479 workerNode.getTaskFunctionWorkerUsage('echo').elu.active.aggregate
1480 ).toBeGreaterThan(0)
1481 }
1482 if (
1483 workerNode.getTaskFunctionWorkerUsage('echo').elu.idle.aggregate == null
1484 ) {
1485 expect(
1486 workerNode.getTaskFunctionWorkerUsage('echo').elu.idle.aggregate
1487 ).toBeUndefined()
1488 } else {
1489 expect(
1490 workerNode.getTaskFunctionWorkerUsage('echo').elu.idle.aggregate
1491 ).toBeGreaterThanOrEqual(0)
1492 }
1493 if (
1494 workerNode.getTaskFunctionWorkerUsage('echo').elu.utilization == null
1495 ) {
1496 expect(
1497 workerNode.getTaskFunctionWorkerUsage('echo').elu.utilization
1498 ).toBeUndefined()
1499 } else {
1500 expect(
1501 workerNode.getTaskFunctionWorkerUsage('echo').elu.utilization
1502 ).toBeGreaterThanOrEqual(0)
1503 expect(
1504 workerNode.getTaskFunctionWorkerUsage('echo').elu.utilization
1505 ).toBeLessThanOrEqual(1)
1506 }
adee6053 1507 }
9eae3c69
JB
1508 await dynamicThreadPool.destroy()
1509 })
1510
1511 it('Verify that removeTaskFunction() is working', async () => {
1512 const dynamicThreadPool = new DynamicThreadPool(
1513 Math.floor(numberOfWorkers / 2),
1514 numberOfWorkers,
b2fd3f4a 1515 './tests/worker-files/thread/testWorker.mjs'
9eae3c69
JB
1516 )
1517 await waitPoolEvents(dynamicThreadPool, PoolEvents.ready, 1)
31847469
JB
1518 expect(dynamicThreadPool.listTaskFunctionsProperties()).toStrictEqual([
1519 { name: DEFAULT_TASK_NAME },
1520 { name: 'test' }
9eae3c69 1521 ])
948faff7 1522 await expect(dynamicThreadPool.removeTaskFunction('test')).rejects.toThrow(
16248b23 1523 new Error('Cannot remove a task function not handled on the pool side')
9eae3c69
JB
1524 )
1525 const echoTaskFunction = data => {
1526 return data
1527 }
f7a08a34
JB
1528 await dynamicThreadPool.addTaskFunction('echo', {
1529 taskFunction: echoTaskFunction,
1530 strategy: WorkerChoiceStrategies.LEAST_ELU
1531 })
9eae3c69 1532 expect(dynamicThreadPool.taskFunctions.size).toBe(1)
31847469 1533 expect(dynamicThreadPool.taskFunctions.get('echo')).toStrictEqual({
f7a08a34
JB
1534 taskFunction: echoTaskFunction,
1535 strategy: WorkerChoiceStrategies.LEAST_ELU
31847469 1536 })
f7a08a34
JB
1537 expect([
1538 ...dynamicThreadPool.workerChoiceStrategiesContext.workerChoiceStrategies.keys()
1539 ]).toStrictEqual([
1540 WorkerChoiceStrategies.ROUND_ROBIN,
1541 WorkerChoiceStrategies.LEAST_ELU
1542 ])
31847469
JB
1543 expect(dynamicThreadPool.listTaskFunctionsProperties()).toStrictEqual([
1544 { name: DEFAULT_TASK_NAME },
1545 { name: 'test' },
f7a08a34 1546 { name: 'echo', strategy: WorkerChoiceStrategies.LEAST_ELU }
9eae3c69
JB
1547 ])
1548 await expect(dynamicThreadPool.removeTaskFunction('echo')).resolves.toBe(
1549 true
1550 )
1551 expect(dynamicThreadPool.taskFunctions.size).toBe(0)
1552 expect(dynamicThreadPool.taskFunctions.get('echo')).toBeUndefined()
f7a08a34
JB
1553 expect([
1554 ...dynamicThreadPool.workerChoiceStrategiesContext.workerChoiceStrategies.keys()
1555 ]).toStrictEqual([WorkerChoiceStrategies.ROUND_ROBIN])
31847469
JB
1556 expect(dynamicThreadPool.listTaskFunctionsProperties()).toStrictEqual([
1557 { name: DEFAULT_TASK_NAME },
1558 { name: 'test' }
9eae3c69
JB
1559 ])
1560 await dynamicThreadPool.destroy()
1561 })
1562
f7a08a34 1563 it('Verify that listTaskFunctionsProperties() is working', async () => {
90d7d101
JB
1564 const dynamicThreadPool = new DynamicThreadPool(
1565 Math.floor(numberOfWorkers / 2),
1566 numberOfWorkers,
b2fd3f4a 1567 './tests/worker-files/thread/testMultipleTaskFunctionsWorker.mjs'
90d7d101
JB
1568 )
1569 await waitPoolEvents(dynamicThreadPool, PoolEvents.ready, 1)
31847469
JB
1570 expect(dynamicThreadPool.listTaskFunctionsProperties()).toStrictEqual([
1571 { name: DEFAULT_TASK_NAME },
1572 { name: 'jsonIntegerSerialization' },
1573 { name: 'factorial' },
1574 { name: 'fibonacci' }
90d7d101 1575 ])
9eae3c69 1576 await dynamicThreadPool.destroy()
90d7d101
JB
1577 const fixedClusterPool = new FixedClusterPool(
1578 numberOfWorkers,
d35e5717 1579 './tests/worker-files/cluster/testMultipleTaskFunctionsWorker.cjs'
90d7d101
JB
1580 )
1581 await waitPoolEvents(fixedClusterPool, PoolEvents.ready, 1)
31847469
JB
1582 expect(fixedClusterPool.listTaskFunctionsProperties()).toStrictEqual([
1583 { name: DEFAULT_TASK_NAME },
1584 { name: 'jsonIntegerSerialization' },
1585 { name: 'factorial' },
1586 { name: 'fibonacci' }
90d7d101 1587 ])
0fe39c97 1588 await fixedClusterPool.destroy()
90d7d101
JB
1589 })
1590
9eae3c69 1591 it('Verify that setDefaultTaskFunction() is working', async () => {
30500265
JB
1592 const dynamicThreadPool = new DynamicThreadPool(
1593 Math.floor(numberOfWorkers / 2),
1594 numberOfWorkers,
b2fd3f4a 1595 './tests/worker-files/thread/testMultipleTaskFunctionsWorker.mjs'
30500265
JB
1596 )
1597 await waitPoolEvents(dynamicThreadPool, PoolEvents.ready, 1)
711623b8 1598 const workerId = dynamicThreadPool.workerNodes[0].info.id
948faff7 1599 await expect(dynamicThreadPool.setDefaultTaskFunction(0)).rejects.toThrow(
b0b55f57 1600 new Error(
711623b8 1601 `Task function operation 'default' failed on worker ${workerId} with error: 'TypeError: name parameter is not a string'`
b0b55f57
JB
1602 )
1603 )
1604 await expect(
1605 dynamicThreadPool.setDefaultTaskFunction(DEFAULT_TASK_NAME)
948faff7 1606 ).rejects.toThrow(
b0b55f57 1607 new Error(
711623b8 1608 `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
1609 )
1610 )
1611 await expect(
1612 dynamicThreadPool.setDefaultTaskFunction('unknown')
948faff7 1613 ).rejects.toThrow(
b0b55f57 1614 new Error(
711623b8 1615 `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
1616 )
1617 )
31847469
JB
1618 expect(dynamicThreadPool.listTaskFunctionsProperties()).toStrictEqual([
1619 { name: DEFAULT_TASK_NAME },
1620 { name: 'jsonIntegerSerialization' },
1621 { name: 'factorial' },
1622 { name: 'fibonacci' }
9eae3c69
JB
1623 ])
1624 await expect(
1625 dynamicThreadPool.setDefaultTaskFunction('factorial')
1626 ).resolves.toBe(true)
31847469
JB
1627 expect(dynamicThreadPool.listTaskFunctionsProperties()).toStrictEqual([
1628 { name: DEFAULT_TASK_NAME },
1629 { name: 'factorial' },
1630 { name: 'jsonIntegerSerialization' },
1631 { name: 'fibonacci' }
9eae3c69
JB
1632 ])
1633 await expect(
1634 dynamicThreadPool.setDefaultTaskFunction('fibonacci')
1635 ).resolves.toBe(true)
31847469
JB
1636 expect(dynamicThreadPool.listTaskFunctionsProperties()).toStrictEqual([
1637 { name: DEFAULT_TASK_NAME },
1638 { name: 'fibonacci' },
1639 { name: 'jsonIntegerSerialization' },
1640 { name: 'factorial' }
9eae3c69 1641 ])
cda9ba34 1642 await dynamicThreadPool.destroy()
30500265
JB
1643 })
1644
90d7d101 1645 it('Verify that multiple task functions worker is working', async () => {
70a4f5ea 1646 const pool = new DynamicClusterPool(
2431bdb4 1647 Math.floor(numberOfWorkers / 2),
70a4f5ea 1648 numberOfWorkers,
d35e5717 1649 './tests/worker-files/cluster/testMultipleTaskFunctionsWorker.cjs'
70a4f5ea
JB
1650 )
1651 const data = { n: 10 }
82888165 1652 const result0 = await pool.execute(data)
30b963d4 1653 expect(result0).toStrictEqual({ ok: 1 })
70a4f5ea 1654 const result1 = await pool.execute(data, 'jsonIntegerSerialization')
30b963d4 1655 expect(result1).toStrictEqual({ ok: 1 })
70a4f5ea
JB
1656 const result2 = await pool.execute(data, 'factorial')
1657 expect(result2).toBe(3628800)
1658 const result3 = await pool.execute(data, 'fibonacci')
024daf59 1659 expect(result3).toBe(55)
5bb5be17
JB
1660 expect(pool.info.executingTasks).toBe(0)
1661 expect(pool.info.executedTasks).toBe(4)
b414b84c 1662 for (const workerNode of pool.workerNodes) {
31847469
JB
1663 expect(workerNode.info.taskFunctionsProperties).toStrictEqual([
1664 { name: DEFAULT_TASK_NAME },
1665 { name: 'jsonIntegerSerialization' },
1666 { name: 'factorial' },
1667 { name: 'fibonacci' }
b414b84c
JB
1668 ])
1669 expect(workerNode.taskFunctionsUsage.size).toBe(3)
31847469
JB
1670 for (const taskFunctionProperties of pool.listTaskFunctionsProperties()) {
1671 expect(
1672 workerNode.getTaskFunctionWorkerUsage(taskFunctionProperties.name)
1673 ).toStrictEqual({
5bb5be17
JB
1674 tasks: {
1675 executed: expect.any(Number),
4ba4c7f9 1676 executing: 0,
5bb5be17 1677 failed: 0,
68cbdc84 1678 queued: 0,
463226a4 1679 sequentiallyStolen: 0,
68cbdc84 1680 stolen: 0
5bb5be17
JB
1681 },
1682 runTime: {
1683 history: expect.any(CircularArray)
1684 },
1685 waitTime: {
1686 history: expect.any(CircularArray)
1687 },
1688 elu: {
1689 idle: {
1690 history: expect.any(CircularArray)
1691 },
1692 active: {
1693 history: expect.any(CircularArray)
1694 }
1695 }
1696 })
1697 expect(
31847469
JB
1698 workerNode.getTaskFunctionWorkerUsage(taskFunctionProperties.name)
1699 .tasks.executed
4ba4c7f9 1700 ).toBeGreaterThan(0)
5bb5be17 1701 }
dfd7ec01
JB
1702 expect(
1703 workerNode.getTaskFunctionWorkerUsage(DEFAULT_TASK_NAME)
1704 ).toStrictEqual(
66979634 1705 workerNode.getTaskFunctionWorkerUsage(
31847469 1706 workerNode.info.taskFunctionsProperties[1].name
66979634 1707 )
dfd7ec01 1708 )
5bb5be17 1709 }
0fe39c97 1710 await pool.destroy()
70a4f5ea 1711 })
52a23942
JB
1712
1713 it('Verify sendKillMessageToWorker()', async () => {
1714 const pool = new DynamicClusterPool(
1715 Math.floor(numberOfWorkers / 2),
1716 numberOfWorkers,
d35e5717 1717 './tests/worker-files/cluster/testWorker.cjs'
52a23942
JB
1718 )
1719 const workerNodeKey = 0
1720 await expect(
adee6053 1721 pool.sendKillMessageToWorker(workerNodeKey)
52a23942
JB
1722 ).resolves.toBeUndefined()
1723 await pool.destroy()
1724 })
adee6053
JB
1725
1726 it('Verify sendTaskFunctionOperationToWorker()', async () => {
1727 const pool = new DynamicClusterPool(
1728 Math.floor(numberOfWorkers / 2),
1729 numberOfWorkers,
d35e5717 1730 './tests/worker-files/cluster/testWorker.cjs'
adee6053
JB
1731 )
1732 const workerNodeKey = 0
1733 await expect(
1734 pool.sendTaskFunctionOperationToWorker(workerNodeKey, {
1735 taskFunctionOperation: 'add',
31847469 1736 taskFunctionProperties: { name: 'empty' },
adee6053
JB
1737 taskFunction: (() => {}).toString()
1738 })
1739 ).resolves.toBe(true)
1740 expect(
31847469
JB
1741 pool.workerNodes[workerNodeKey].info.taskFunctionsProperties
1742 ).toStrictEqual([
1743 { name: DEFAULT_TASK_NAME },
1744 { name: 'test' },
1745 { name: 'empty' }
1746 ])
adee6053
JB
1747 await pool.destroy()
1748 })
1749
1750 it('Verify sendTaskFunctionOperationToWorkers()', async () => {
1751 const pool = new DynamicClusterPool(
1752 Math.floor(numberOfWorkers / 2),
1753 numberOfWorkers,
d35e5717 1754 './tests/worker-files/cluster/testWorker.cjs'
adee6053 1755 )
adee6053
JB
1756 await expect(
1757 pool.sendTaskFunctionOperationToWorkers({
1758 taskFunctionOperation: 'add',
31847469 1759 taskFunctionProperties: { name: 'empty' },
adee6053
JB
1760 taskFunction: (() => {}).toString()
1761 })
1762 ).resolves.toBe(true)
1763 for (const workerNode of pool.workerNodes) {
31847469
JB
1764 expect(workerNode.info.taskFunctionsProperties).toStrictEqual([
1765 { name: DEFAULT_TASK_NAME },
1766 { name: 'test' },
1767 { name: 'empty' }
adee6053
JB
1768 ])
1769 }
1770 await pool.destroy()
1771 })
3ec964d6 1772})