From 6c2aa71d06cfeccb07a325f7d9bc5ecdbb42a11f Mon Sep 17 00:00:00 2001 From: Documentation Bot Date: Sat, 25 May 2024 10:36:16 +0000 Subject: [PATCH] docs: generate documentation --- docs/assets/search.js | 2 +- docs/classes/AbstractPool.html | 120 +++++++++--------- docs/classes/AbstractWorker.html | 62 ++++----- docs/classes/CircularBuffer.html | 30 +++-- docs/classes/ClusterWorker.html | 50 ++++---- docs/classes/DynamicClusterPool.html | 74 +++++------ docs/classes/DynamicThreadPool.html | 74 +++++------ docs/classes/FixedClusterPool.html | 74 +++++------ docs/classes/FixedThreadPool.html | 74 +++++------ docs/classes/PriorityQueue.html | 30 ++--- docs/classes/ThreadWorker.html | 52 ++++---- .../WorkerChoiceStrategiesContext.html | 42 +++--- docs/functions/availableParallelism.html | 4 +- docs/hierarchy.html | 2 +- docs/index.html | 4 +- ...tLoopUtilizationMeasurementStatistics.html | 6 +- docs/interfaces/IPool.html | 34 ++--- docs/interfaces/IWorker.html | 22 ++-- docs/interfaces/IWorkerChoiceStrategy.html | 18 +-- docs/interfaces/IWorkerNode.html | 40 +++--- docs/interfaces/MeasurementOptions.html | 6 +- docs/interfaces/MeasurementStatistics.html | 16 +-- .../MeasurementStatisticsRequirements.html | 10 +- docs/interfaces/MessageValue.html | 44 +++---- docs/interfaces/PoolInfo.html | 16 +-- docs/interfaces/PoolOptions.html | 32 ++--- docs/interfaces/PriorityQueueNode.html | 6 +- docs/interfaces/PromiseResponseWrapper.html | 12 +- docs/interfaces/StrategyData.html | 6 +- docs/interfaces/StrategyPolicy.html | 8 +- docs/interfaces/Task.html | 18 +-- docs/interfaces/TaskFunctionObject.html | 10 +- .../TaskFunctionOperationResult.html | 6 +- docs/interfaces/TaskFunctionProperties.html | 10 +- docs/interfaces/TaskPerformance.html | 12 +- docs/interfaces/TaskStatistics.html | 18 +-- .../TaskStatisticsRequirements.html | 10 +- docs/interfaces/TasksQueueOptions.html | 14 +- .../WorkerChoiceStrategyOptions.html | 14 +- docs/interfaces/WorkerError.html | 10 +- docs/interfaces/WorkerInfo.html | 18 +-- docs/interfaces/WorkerNodeEventDetail.html | 6 +- docs/interfaces/WorkerNodeOptions.html | 6 +- docs/interfaces/WorkerOptions.html | 10 +- docs/interfaces/WorkerStatistics.html | 8 +- docs/interfaces/WorkerUsage.html | 12 +- docs/types/ClusterPoolOptions.html | 4 +- docs/types/ErrorHandler.html | 4 +- docs/types/EventHandler.html | 4 +- docs/types/ExitHandler.html | 4 +- docs/types/KillBehavior.html | 4 +- docs/types/KillHandler.html | 4 +- docs/types/Measurement.html | 4 +- docs/types/MessageHandler.html | 4 +- docs/types/OnlineHandler.html | 4 +- docs/types/PoolEvent.html | 4 +- docs/types/PoolType.html | 4 +- docs/types/TaskAsyncFunction.html | 4 +- docs/types/TaskFunction.html | 4 +- docs/types/TaskFunctions.html | 4 +- docs/types/TaskSyncFunction.html | 4 +- docs/types/ThreadPoolOptions.html | 4 +- docs/types/WorkerChoiceStrategy.html | 4 +- docs/types/WorkerType.html | 4 +- docs/types/Writable.html | 2 +- docs/variables/KillBehaviors.html | 4 +- docs/variables/Measurements.html | 4 +- docs/variables/PoolEvents.html | 4 +- docs/variables/PoolTypes.html | 4 +- docs/variables/WorkerChoiceStrategies.html | 4 +- docs/variables/WorkerTypes.html | 4 +- 71 files changed, 631 insertions(+), 619 deletions(-) diff --git a/docs/assets/search.js b/docs/assets/search.js index f81930cf..8aab934c 100644 --- a/docs/assets/search.js +++ b/docs/assets/search.js @@ -1 +1 @@ -window.searchData = "data:application/octet-stream;base64,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"; \ No newline at end of file +window.searchData = "data:application/octet-stream;base64,H4sIAAAAAAAAA8WdW5PktpGo/8qJntf2uHBlld5s2Y5VeL3SWvLqYULh4HSxe+ipZrVYrNGMHf7vJwgQLCCZCYIkWn5SawqXJBKXxJcJ4F937fmXy91X7/5197FujndfMb6/v2vK5+ruq7uv6/bheirb318fH6v27v7u2p7uvrp7OJWXS3X5bfjz2w/d8+nu3v1699Xd3b/vXamK8bHUh3Nz6drrQ3dOKvJNmN4r/v7upWyrpptKequY7bgca26r8vjN8XNSrbe0txq7y/E39eU3L239qeyq5fX/0tZdlSqAlzifBHVXPV+Sqncp89X9XH7+XduWX1IbIEyfT45L/c8qSYAh4cIex3fyNoKq55fuS1JlLuWW2h6vp1NSZUPCLXW9XLukqmy6LTU9VWk12XRbaurOpsMl1XZLu6XGhw/Vw8fvUzukn3rbePAm+d+9v3Rt+dB9dz5PO4//Y5YJflJg0vQeyEhNruf2Y9X+z/lYTSe4aa1h6vW1Vs911yFr47TGW8r1tb205+f6Uv21urycm0v1l/IloWI0E9J9zl310FXHde3+9Ydz/VB937VlVz3V1eXrc9NVn6cDl9IEnT+fpF15+fina/PQ1ecmpY/A9ClDLkWOS1e2Vvw5CW4ps9ZdN0+pldukuWo/VpeuPX9Jqz9InPv7/1I39fP1+X+uz++r9tvHH00nTOkUswXkkrQ3QL/88VPVdH80M0dKf8HyZG25H+rn6tKVzynzziRDLkme1+qOzJhvjnmsT9V3ZfchQRovab76zy9dSksMyfLV+1x+XqkTKuMm2aZGVp/ghy8vU0MLsUhA+g39dirH6oknnjurjH2Cb19Sl0kkS1Zp/q881ccfp1bCl4UiJpSTS+66qTtvGk4xD5EsW6TRnElv2988npNkMMkW2aegJrMCpa5UWb8R32pjdjjcaK+ZX8K6r119qv9Z9t0oQYIwdb4W6NKmt46c1VZ/v7Xhk4393/D88/tfqsulfKrs+P4mxVgisuWaA56q7sdxk/nn6svvvyyQLZo5l4QXV0k4HaaYdmTOZXNHgjTpk/xsAetlq5ry/an6obx8vPzvtbqmjDIky6a2uZW0qEWwbOvleH+tT8c1kpAZM/blW/EoUJtpngVYbYE833dVeUrcbk9y5JLl2iyXBsuTW1eu6G+b35cPH79rq8vl2i5RHFlA9pZbL2tCEfksANQBgOw8If7fbgG8v15SFo4hWb61v266qm3K0+/T6gfJM8pxua3XqbJMs+QbYY2ZbR29/Palao29+cP5x1RTLaWMX03etNUuoZBcEn8oL35dCeJNc6xfh8vjcWHt0xzra2+r5/OnaqEAaKb1MpzqS+cXdvmuPb9UbVcneX/iuddL9VQFxa60rtNKeZV9Sh7pF5X36t/xXVuf2zqJDaSUkV1e6PpaIieSN6OV9ofqsbyeuoUjncy4Yf/zoTyd/vi5erh2Ri0pUkyz5GqZypaasgkcU2749t6Nss1d9erU2NSSKs2m1hicgunuw4377ub45/p0GijRQusJz5mrzYfvu81X6W0S5MlnA1+q7vryX+dz0vD00ua0wv9S1ilz1JgwX93vq8dza6YaO+vU5yaxLeic+aQrH7uqXSMcmTFjv+mn6r+9HMsOsRf+1g+f1Pl+rpB8fqnz+VItGnpIlmyzb//pX7dV2VV/+NKUz/VD+jRFZ805LzTHpRvP6Hy5mhXUnnmX2rHwXNl6kmn73zXH7/sJcVmPorNm9K0ElQR9ZJWYWAn5pG2rp/rSVa0tflh7/7v/pyap683lzy/pt81DtVXaWBn5JD5WW1t3voTM692tl5m+l7raTbPlnQu/763g68s6o5LMnF3Grr509cNltZhk/mxzZ9k0585g9cRN4TRHPh7YHE+pe9MgcS4J2upYX7q2fn/tKuPRsv62pHmEypnNjzLaZd9351PV3HrHMiMvtZxXkLv6+Vo1XV2eTl+yfUNymfn6iPPqZfucFUXmHXO32fqb46kyIVTJQxDPm0u+2xmDJXMUnuu12sx3Ra5tO6yMvG243Nag8mWOOvpdc+zj9f46xl2nxh1hGV9Dx6YCd/RjoW5h3vxr5cgUFktI5c63w78pKajLKCs55jRawmvJ2q/hdfO0WlKY/zXkDPaBBkCsbdt4SfnG++hz+SYtmBamz70nX7EJfxX6VB6Pi0SB6V+jd/2xj/FdMx8HGfNZXb3re1EjIVlySfN4Kp9uBf/u8j9nuwqlxA3RWfP17g/lZWGI1TRHZk9fouVWvY63sfm535OlyhCkzudrWiJDmDqXDN3S8M5Jhnwj6Hr5sCgYeJoj33gBZacsn0iWDW3jHyYfFuOvT9ce832HHSmfJslysJwoNul4OSL1VlcLJc5mh0u6rGvNLbIlMxtd8S9JONpCCbrogMsSKdAgV0qKRaGuC3og6WQnu1ySq/3/Df9QNx+q/uaZleIRHnhKtgQ/fCbBok5IuukSXZEZhUz0DsREXuEjyPQBy1xE1DesdxNl/ox079zcp6zz0WX6nKWuO+pjtjjwNnxK0llDSuZfXrPvJ19AE5dueg1NHomoy2koabAravJIknBxDSXUwutrsioz9VabuHrX3G2T6TMSr8qg5F9xYUYmwcl7NChRk27TyCQceskGJdjsVRu5VJ12Awep6uX3cGSb0tHrCUiTkcCpm6XAry6gF/b4BQbZGge/14CewuduN8gmWOzSA0q8tKsPslnTaefbIxun1DMrryMpdb56ocCR09Yb5Z49F09209jp+GxtOn9SPdKSSafVNw8i9MQuucbNndvNtYmPHaql5+XEo7WZhJw7gUnJGTuHmUeyudOZlGSxM5q59rWzJzfp9S56fjOPfEtOdVKCpp7tzDbLpJySi8wzc2flMs3UxJk1coJGTq5lajH0rBjZQJMTY7mQCH6OjEYf09NkWSWJuIdnZEqMpc807aYecyKx+IrDTplETzwDRU7Py09CZRI8+ZAI6bpZc1TkVYSfP0GS9g3LzpHk7EBzhwqi3WfJ0YJMQqdFUMYJ1n+AWcfDrShx04OuMomZHE1D2vRrYmqyCR8PZKBlTg9n2CLqoWDq5v33UsHtXO/xvfx2miAaWeDHLfyp/lwdY1ELMEGWmAW00KSIhYm8i73FeN3Lj2WnSkI4hnExFh7PTm+NiA+YapAVh1GXyJPo7qWl23ggLFXWZR5EXNw8x/+WSpzuxI1Lvf2YZarkS/21uNy5jlsm9+bU2CiiL2+NjEqVc21cFDFbZ46Kin1FQkwULuSiiKh0CQhXPC5DgiN+nRRoVBYuw6KYrIgEyX7/WFMs8/qnSkP5/HFJlnr8U6VI8PfjAuX09i9TYKqvP6bS7J7+1E9I9PPjsuf28qcKTfr4cTG3e/hTBUP9+7hQ27z7yepN8+0T6s3s2U+fmVG/PmHxL/Hqp0uA+/QpO2+DRz9dJNyfT03Pm7z56ULFfPm4aBk8+Qs2sUl+fHJLu8mLv1FKyvO8SNilHuhUmWf990S3XOu9X9CW8757sgXXe+7TBwzqtyfWrU1e+2S+EvPZU3NuDo99qoBz/npcxrXe+lSp5nz1uFRrPfXp6GLWT0+tYau99KmyLfHR40Lm8NAvmElS/PPkXLLFO588CxO+eWLyXeiZT24p1C9PNMwir3w69sJ98hTeWuaRXyhFxEMZlSeHRzJV1FRfPAFDcnvik+fcND88MfVm9sInU8NUHzyBCbN74NcJPu9/T5E/o/d9UaeZ871Hukw2z3uqwGl+9xhNyuZ1TxU57nPHRc3kcU8VMdnfTtji2b3t6YLHfe2UvJk87TExlR6l/CZwfpsNwmP5UF1++82s0zsAVgH5QYuJPzb5zVLgjteR8sp7tCpI0/Fq5p52j1cBrD+iipmXBGAVWilxU+vf/x44i6JVvLWJf6Pjdb11EhGfFZqTeI3x5wAyfJKpwH0Q5zNfZMUhvgcap3iFc48OZPimoYrxq2Y+yklEfBa1K8frTn3DKMNngqrc5+5nPhdKSHw2te3HZUl9PCnDZ4Oq3o6ZYh8N5SM+OkIVcGEWvNmU4dOntTmls7lOjghKtEEKvcDFW/NmVIZWiVQ7Ns9upnliolPTd5ybENPtspd/ckzwaI1jw8i5GR8XmG6TqB+CFHHW/5C/VbAqx2aZm0QpkZe1C+T2i2Sde6329VrJhY669XVucM18AGX1UZ4XwjZLfU04hx0I6nItMTeYJjLS3YV27pCqijt18neNSX3j6JkzjFFh6bDmPk94VaWNZh7/Pbrr8jdvfY5viI2X+y19C/epai/ElB8U9uaWEG+VUSyiIkofYS1RM2iuChCoRlaCxKgtqcZsIKrjfD23hOsqCsMayGqmEQ1LKjnalTG2zIXVTTOsbUZbwF+rriXsMticMMO6ip/rJrhbkqzwlnBlReXnxIrGhOsqwuI6yMq8xL9hG8caSWewARcHNPPdxb6r/eOSivFM6wSog9vwEyqfZlhXcR/OuqjiaYZ1FQ/sB7wwQlYLk2+ptG6eFtXqpV9X7c/IWypknT8Tz6csnByw91ticwT1asuizoRdukz3JOrC5WUjt38mJPEzw8TrKnws61Nyu4aJVy7U1+aH+jmhPW8JkytKtWvRiuaN+jGbEy0eery85rdDzgjChDI4HBYPk10jis2ZT5TyU9X6D+ikizLk/I3I1irVsS4Tlv9po5iM+QT5pay7tNHgpXzl4eBqcl+t5j92FG7rgJjUPY6IhCYHmTcPCUSYYUzkEyZ5UEyFcaMiYb5KbZnEYYE0jB0X+USpTtcEc8YkeuXhUJ2ucy6HMUMvUMQiXlLZ2yHDfI3Tltz6oabueW8aIoSVeussQEkyTgbzWzEoU645gRZtmBqyi5Y8Q5CiuYkif6slzhd0o9lpI3+bPXT1p2VNNmb5jww4W/vIUxe1xyB5xkEHpHl7K2OpVK8w7CbCjWVkFm7NwIPC3crI3XLLh96k4VwRmUVbBNi8wqnjU7/iMPREcO2UYOoR35CxW2FyjdP6sgV6WlTGLobKOUzyGcWEHp6Ix+y71JtvgsOuzaluqv8yryqSLhK/1DcwB/2hM07QZxvguqTuSZbVlVdte26XVA0yrK/4c90tqjdIv7pa43OCJ4dj9YIMqytGjsaTzqRAACJjVkEWjCZUnjlndIJYbeW19LfNH/tuliQPkXF9xzQOfHD7SbRnhhk2VhwPhiAqTwiJSBCgS4lHmEiA5drYOZd3xwxVV82nxBb/tGkCqrreG5M4+dwSL6kQC674wTeMbrEV/T8nh1YkBaxMQ0aSF+EL4Q3Gi3xzifmEY8EnQaUP5+bh2rZV84DOx0TdYa6NIvRD6PvBFbtABpAtgxAXV9y3Dfr6aJpMdCk5RPxT3dSXD9WxJ4rnKxpcH5Ntmn25UAKJW7qNhU9lW/eTshe8FB8DYjpSqdLMb8nj9ZvkQE00UDJ93A45vjufanwU0RW8mWQmosqWxGLakVF29aWrHy5/rX6+1m31TK3oEeGiBWUQtK0uFX4+hJbJ5VlXfXIc4IwACfGQaAlWeoojvBxL4hAQLc6Y6T/WIFaChMMZaBGD/NTy9OF8viwVaMz0H2sSK8HswQ20gEH66PmNxV12yPQfHDS9BAnnlYhRY+SnbcpYBHFk7vUz/sea5iZFwqk7tBjvO2gr+C9V2Zshz9MgY++X5LXVyxNp+2mq9FWVhnFEqW9m8C4i8uy3pa+is5nSv7x8emqrJ2IlSKvnjV/GbHMQX7kc56YKN+MjWC1aUp+JSZbehWYF83vU97MWYpgiva8c/UsY/nYh9IKU/gbNiX82ED9FlL9SwemzokyP4ieJAjfq6SOXTp2uhkiI30zxs0F/kY9ZEWI1J81s0NVycYjAljlJYqEuSULABTC6G7Qr4eJ9oN/rFh5/ix07W7BIThf1BXW8CfPjjb3iYFtkOMyKNDceVogTGxCz8syOiDUH//AhMStLbEysaZeqfvqAT4rzzTLm3SKOQO1TDP/4P6fiJESGGmVLeML4MPQeDsGzU3dHR1NH60x9UmS+hqT3ReKfRe5PzfGrr8/XZs2nvwH5M0o2nExLukU2QdB4cTe5w7twN38Ffsf4mg8gS/qVZQdG8eYvQEjqr/IdCVbn5m+L1vFq39uCM5jLh/NrSveCPdWUINqQL6dc8CK19V3bz7xtDoQy5e2mcwVmlP12T0euKXy2xIzSA7a/QMoZwL9KGuq22QRx5i4h2yLPFmVOi3i1kQ0Y/KLpMAri144L6nb0tDEwx8DXSfWlecAzrpIyVlpGqcvjMdfkQhf1yv0y1wdES8u6mntbqeFS2R8+9NdWfIet7JMUWbZMeKlJ26SpyNSQSH0bjRBm8+NoyZKufR2NasXMz6NFvyPhfTRCzEUPpC2QAX2bjJBh0eNkyfok3t0kZEh4eDPlQdeEARF7ipMaBKlvceYTMfF1zojAK57nzCP+sickiS9Y/4Jk3o9If8Nz5kPWPeKZ52OWPutJfMqWdz3Xf0jSy4+ExAlPP64WLPkpxqhsy95iTJaHeoyRkGXpa4zJciQ8x0iIlPM9xoVqTIXqUcVmf5Ex+SMSn2QkpM/9JmOy2OSjjISg219lTBYNfZaREGvbu4zpSk57mJFScuaXGRdM4OjTjJRRuORtxgUy4I8zkgv4htcZFwiFP89ITtib3mdcIFbsgUZCuAwvNC6wldPILGkob3ujcaucFERbJu7S1waTpZ59ppHqnmvfaVzSnvMPNdKtuP6lxgVDB32qkVrNNr3VmL4pbyKPNZKzcI7XGpNFnHuukZBy7XuNyXLNPdhIyLX2xcYFO9XZJxvJlW31m43J0i15tJEQM8erjUvmlZRnG+mZZcu7jenzMuFKo6bjhS83prcW+nQj1TiL3m5cADfwxxtJiLHs9calctxuuV0oUZDx9RFjd31BHz+ke/aY4bWFS31dksLZuZ+XTF8i0t6XpFaKzA9MpnteUl+YpFwt2Z+YXCn6/BuTSV+Q8ZHJZV3nViP+ymSs40zzvrbIae9MRiHZr4/C4y9NEsJmemoyWcjktyapzUT2xyYXiB5/bZKUONNzk3FBw8MZt0RwA2lPZkx+Tw7ONo9eRuIJwO9ZogmwMpNiCaCwy/y5aLUJ3twVEkRdt6gcyY7bldIkemlJ2Vb4aFdIusz5hwq73vG3Qd5032tU5nWe1xVyL3WzolJvcbKu6cWp8UF4H94aHZQo5drYIHxOzBwZFPmGhLggVMRFUUHJ9RO+c1SCBM/5KhnQuCRUgkVRSXT9yW76SDMsc9InykK56FE5ljroE2VIcM+j4uR0zi9SXaprPqLM7I75xA9IdMujkud2yieKTLrkUSG3O+QTxULd8ahI25zxqYpNc8Xjis3siE+eh1E3PG7LL3HCJ9ePu+AJO26DAz5ZINz9TkzGm5zvySLFXO+oYBkc78mbnzS3O7Hz2eZ03yYj5SxeIupSp3GixLPudrw7rnW2p7fjvKudar31jvbkYYK62fEVapOTPZWTxFzsxAybw8GeKN6cex2VcK1zPVGmOdc6KtNax3oyhJh1qxOr1WqneqJkS1zqqIg5HOrpc0eKO52aPbY401PnXMKVjk+1Cx3pqa2EutHxRlnkRE8GV7gLnQBUyxzoy2SI+O5i0uTw1aV3acJ1TvXirY7zRMFS3eY4bcntNE+d+tNc5vgKkNlhngojU93lOH3M7ixfJfa8qzxB+oyO8iXdZc5NTneWbE7yRHHTXOQRWJXNQZ4ocNw9jgqayTmeKGCyaxzfAGR3jCeLHXeLE9JmcorHhAxd4n/E3iay3nD/p6jDOno9MVHWm5lbqwO5IuL3nhtCfO+nqPj+9Yom03+fzy9/u5EV9D5W7Dq75MzxsIKU502XVfUm+uhp+jcTQtLPQi4Uc+axyM2Czjyht1DalIf11og86ePIK15DF7/9snmAgqJmx6cnFD6UvgF+5ek95UuGwVwxb0wSXFYnCVF4Z+bJb+ar8BKuqgjvdUEVka40LXzhtfCuhuRXJd7Sry2em4eUqh5mnwPY/jkPVfKN9m+NRNTk0LTV42x9LtWrfpSpZHxRdDf7WVYoqntX7XPdxJ/8GPq3l/JVv2+sKPk5j7c32YjPPNaXh3PTVA+xp14GhOAnfdUPvdWU+ErHW0824kM/1h79pioeEr3qx/V1JL+18dZIFF0pgk3ptNL+5/QV45e5xWcsbth4RV6H9uWjFih/9xSrbOJcXVjRlbp9f1LTNXrbfkJV7tGoP5RdmVQjyLC64uHl1a8/lE1Txfr6repJltWV355a9N9V+554NW8iSDR7BqFWCLKi8oXzAVXruITNzu+mBCAyFUbV/Nwn6bfJSSKF6X+VVvCqTF7hTG5fVmqdq5Z9fpj+V/l8r8pk08zk9mWNf/5/l5fuu7Y+t3VX/7M6Lm0NPPuv2TiIBMl2ud9W2JcQTfdwqso2/vTtRNppnl+lkUC1icaTyQ8lJhrjQ3mZe31zItU0z6/SGKDacVKdtblsEUDoDbsEb5pP3SlkW1fgjoHP7orskjK3bQhj71GcGJMrmv1XaRlagrGjpE2+kU+ZabvbeYvV7UcW8au2IS7F2I5pE/PMJxFtOVxx7oIebEbyqa3JF0Sz/yptSEuQDjJMaZFPIW2CU9VVW5pvroRfyTKICJG80R6Mg9j34LvwZDfHRpfG8ocHB+fAuscGZ6LzFwpxy5VDBBsLvlSEMVcGEZY+szioYs3TivRuf9Fzim6/v/wJRdIUrC/duUXfEYxIcMu1ToTpy6mGYOCOnvDHrb4epLQ5dw+Qjv6Mb5tT3RBfEfy29SOmhc19QygaPgl+P8O8/N/Tp7xPddtdy5OJXGqO/Ttvl658fkmq4A2dGf/M4BPwrwwfU8HECFOkf+kQL4n60pAy33jp8a8BokarrZunZfXaDFsqNnvw5K8dU2+p8rn8/L+LavUzbKn40hOHpqvL0+nL9935VKGTNiYBmnOTKMuqz1HlY1mf0tt8TL2wyulTn98QnoXbr1vd6KCkmCfdE4niCIS1CyuJztTz1QyP+abUdEu6trKWemYYVjU9uLasoktXlSdiFoN1eWnXVvd+BoDBKt+nwK+ELjJzlCHWaxIOMcwKMx1j/Z7JbNL/UHVljXqc0IRL3ZF4jAld9BsvW+wDofyzh+H/XEX6c0SSW9514uBNP/t+sZdoaZMvLvsNzDf3pXOv8DafFlRuU2+scpkLk5BkhSNzjYDXh49Vt140P/tyofDHu3+YbjZuPyRHks4gKB/tJHdp8+Eppb1xKWNtEmVqs49re5WlPaYdrW7+8WyvvsTHsqMVRh/H9uqafwwbVjN5GrrvNvR70ObXeBfw7hkbXH1f8KDy4Ndomal3jE1LTLphLBSTUEHTR+S3bTkN5Udq9RMjQfGTZ+GSJHg/nX0iIrzHJ5uNMlwSa7/EJrmkmp7Lz6mfeku6rL7J3T99i00PqZKNS09ZZI3hcfqfE8fFm1vSDfUNPviU+m5JN9T3UlUf/1S3l+nRUaRGP/HGOvsgg9Qqh7QbajQe/KSZaEi4oa66eRgYbeLIgBm2zAOgLy2UBGbIJsm7uqvasju3P6WI8XeX+u/LNeGZS0EaKhJ0kijddDoSQBcv8s0xFsI4lZWo9GVIuKBiL8vyykN3niH2/1ee8FAf//c8+9hJifPb10DIhfHO0+qiQc8pVVl5zdGzJR/oMqyvuDfXv6vax3P7XBInK6aVTzNtE8CBlW9f+gFNnJHCxcCyZhamx6VXwh+dJNJYQB7B4uAqLlMCuVoqznIhslU9w/DiUqRQvBSBLjMhC1CGIP36akk0PK0xDodTKrP3mJKHLadVhhnWV/xybtFTNdMah5TrqzL/SapqSDkxe9AD0SlVUybCtOo+JTgvsrXymKmANDNmJWwV4QLvdJsZQAsvcUuaVtqyuTxWbX/9QeJcEubIKErMS4/IgfrlNwtRXj6mGltj2k3VhzZ5cOnrj2358oLHdeIp083KtrqcT/isFin6zS0bZSujH7A8Vi9BiPkAPaIQ9xFk0/yDONMYF+ofseONv1LD/CPh4CPZKv+InIGc9WTF5EpzZc02URhHd/nSPPy1upyvLW6+xwSCmVcKBCN8qFiF9GFJLcZjKdNFGEY5LF1sb0Uji2xq4bHF9FbB7FY7VkVssbxVgS6SqVXMLYa3ashFMLmq2GLn1TMbfBathFzMvBqmi1ikeNjj0/ZmeMo8o4Iod36cIKKv7NyUCEndPV2MuQFAiZE0JKJiQK3PgBOQJI+eYYHzCvalXDsKJ7WmDciEqiPuXrTiOZdvYrWEFxatMuaJpaubuuRJvOf9vL2TwMLiHcSXjAyTv8RjCby6bmlXV0etz5O6ZpZpvKqpVuLhyDDNgp3FXBwDjNxMC2ZICEmOBRhMwpFnowySzhD82NZdH1sAo1eGf46H3PuHQsr61Gf4rmzL06k61ZfbIZVHB+5+iyVLDmT43ft+IXgYbhKcOJrCn7OEMiBFJsUyAEnnQ2tjFdboBh194Sat3oClJokAc+SU5lTai6anRxxiEmG5ckqFsOGYOAQa3i6Hvd7um34y+FROb7DHZJlkySkP8cAf2m+Xve+XVv9zWTfp4//NLTmALLS/O00O9HkZTILZ12WS6p4+dPYjGqoanbiwbJtaZCrVD4unFjRbPqnmXjLARIo9ZLBcgrl3C9AhHHm2YLkECa8UYELMPFKwXI4lbxKgc37ikwTLJUt8gQCd+ecfIFjTa/sDh+bW4b8AGz7ecZFsOWee55lLqtEpeOXblEta6gfMeb+85WaKyS/3n+vTabmYYa7sK8tQ9I8wbGd2Fp9mzDePmyctvkac2TNWGcyUU6Lzy3KBYJ7M6+8CWShH/1Y5nqruL8uMNJgjZ4+2jzsvFAjJlF0mfB1bJ2pSWflnr5CKzc9b05i37ZK010Rj5pphJwJr/v5L85Ba+5A2swS/uywQwSXOKcP76qluKKIek4fImG8eGgbGUrnQbPmkur4cy87cwLecedB5t+1rPcT29el6u89rIlTwaxbANi0xia+FYq43opHqN9jQpFTgVdWpSYXIsYD6JbXG7EKIyLB6HaQkWoAhEXHSKWT0oZMk4eapJCLgMii5XcgIpMS0mcYot4s1wywR0RYgy+3iEQgTG4PzBHO7OChJRITZ9kx14owZh2XodLnu0c8keebQGdaTVj74mSRPAkhDRNrw2GeSVEuwGjZpZXjoM3EFSoJs6Dq06ZHPJOnm0BYi1hKylWNwLiZdpHmzGnTl+owY+CKlTuVe24WMMwxEwHSEsV24tfiAMvA20oNcXQKnCWRnmIcJ2wXD4AI2wc+whSyCoKwBF2YWNWQRCEcPuETz5GGlSGEsS9+VTVWTxcUGtUx+j0e3zF8oiRc4d6nkVMz4J0W+JulDqJDXb99TxwSmqdKjp+ZOGBJlp50zRMTfGPLqi7Ao3DVefWqoq1/9ojDXSfWklt36/tfqcj3NqztMnq73C3nYdq74N5f4MdvY11CRdFTA5qwsVfRgdpoosUF8iYzieIwiVur38cnu+8xz3aS8lKnue3ym87GjfXaWsFv8H7NAx0mBScwxkDHl0Ctd3eTEK01tiVqXgs6pDBs4Z7pMMTOfEmmNd5uSaBa8ToVYwF1T2mEWu04lWE1d0/WC29qURpb57VLGSRz9TuXIRH5TRJsHv1PxMnLfFBEj2BfpTRmob4pQM9B3Klgu5psiHIF8kdG/kfimCIMC36ko23hv2lwQx73YfLCO9qZIMwd7kR60kvWmSJOAeqcCbSC9KTItAb3IJJWB86ateEmYF1v3NlHeFNnmIO9UqGyMN31xXoR4qTX7dQhvykfE2elU3kzoNNkYW0FOCRvtNcFp0hyF4ElkUtpCJxPFQOEkKso2NpkoDo4mUXk2kklSoHCr3u9pfl99KD/Vntltt9X+T4u2/31G/M0c75etm35Y1Nx+3xcqdnRz9or1xVe3f8SaOFrsG5AF/6JQXvJU0udvGmvQxk+OBvVPc20Q4SPSHeY/f+7RRKpqgfdt7Mrq4HdMnz/d39XNsfp899W/7j5V7aVf9L+642/F28Pd/d1jXZ2Ol7uv3rlj0w/n5/4G07ufht/+r+qxTZ/CJvnt7u7+3e5e87f8wH/66f6dy2F+MP9gkrG7+3fsXrK3By6CZCxIxu/u33GsNB4kE3f37wSWTATJ5N39O4klk0EydXf/TmHJVJBM392/0/dKvN2zQ5BMB8mKu/t3xb0s3mq+D5IVQbL93f27PZZsHyQ73N2/O2CyHcLm7VuboXpgQBFGEwxNGeqif772HUO1wUJ1sL7ZGaoQFmqkf6GT6AehTljf9kzeS/2WHYowZaiW/vHUd0xhTclCzbBeA0zfy8NbfghVyELl9M+hv2OoFlmoH9brge3RMkMVcaOiw70q3rJ9+O08VBHv9cBRZXIwXMx4QZXJQxXxXg8cH1qhinivCI4qk4c64r0iODrAeKgj3iuCK6yVeKgj3iuCozrioY54rwhe3Ev59iB1mDLUEe8VwVEd8VBHolcER8ebCHUkekUIVEci1JHoFSFQHQkwq5lpDdWRCHUkekUIfAYMdSR6RQh0HIlQR6JXhFBYe4pQR4Kc4kSoItHrQWi0yFBFoteDKFAxQxXJXg9ij6WUoYqkURE64GSoItnrQaLKlKGKZK8HybBvl2DtMYsPR1OGKpK9HqRAvyhUkez1ICVaZqgi2StCoouaDHUke0VIjaYMdSR7RcgCTRnqSPWKkHt0SQ11pHpFSHTAqVBHqleEQnWkQh0pQS2tKlSR6vWgGDYvKGAhGBOBoylDFaleDwodmSpUker1oNDZU4UqUr0eFG6hhCpSvR6Uvpfi7V6EXV6FKtK9HlSBpdShinSvB7VHU4Yq0kZFBzRlqCLdK0KjytShjnSvCI3OnjrUke4VodHZUwNDzlhyqI50qCPdK0JL9ItCHeleERrVkQ51pHtFaI0Ndx3qqOgVodEBV4Q6KnpFaLTPF6GOil4R+oCmDHVU9IooUB0VoY6KXhEFOo6KUEdFr4gCHUdFqKOiV0QhsKWjAPa2WY0kWmaoo6JXRIFaIUWoo6JXRIFOikWoo32viALV0T7U0b5XRIFaIftQR/teEcUBTRnqaG+mOlRH+1BH+14Re1RH+1BH+14Re1RH+1BH+14Re4GmDHW07xWxR3W0B9sisy9CdbQPdbTvFbFHLcV9qKNDr4h9gaU8hDo69IrYowvXIdTRoVfEHt+ZhTo69Io4oDo6hDo69Io4oHPdIdTRoVfEAZ3rDqGODr0iDuhcdwh1dOgVcUDXo0Ooo0OviAM61x3A7tVsX9FxdIAb2F4TB3Qg2d/8tL0uDvimawc2sbteGwdUUfY3P63Zx+6IbTTYye7MVnaH76R3YDe7M9vZHb6Z3oEN7c7saHf4fnoH9rQ7s6ndoWPL/ugnNvvaHTq87I9+YrO13aHasz96iQcAgetvgiAMg9ih44xBCmExxA7XIAQRlkSwHfqBkEVYGMEYtkNgkEdYIEHgEIgkLJNgAi8ZaNBiCSbxxECDlkwwhScGGrRwgiAeAE8wyycYrkFAKBi3FAnXIIcciZPQB1AKZlgEvkgywCkYl5GeD1AFM0AC32AyACuYQRL4voABXMEMlMAtGgaABTNYArdpGEAWzIAJ3AZgAFowQa9vDGALZuAEvmYzAC6YwRP4qs0EJICCXLcZgBfM0gt0C88AvmAiwgEBwGAiQgIBwmAiwgIBxWAiQgMBx2CGVuCkiwGSwQyvwFkXAyyDGWKB0y4GaAYzzALnXQzwDGaoBc6HmITsVpKEiAGmwQy5wJsMQA1m0AVOiRjAGsxyDZS/MAA2mCUbKIFhAG0wyzZQBsMA3GCWbqAUhgG8wQzEQPdlDPANZgEHPpMAwsEMyMD3+QxADmYpB7rTZwpCd0Xu9RkAHcySDnS3zwDqYIreRzMAO5hBGvj+mAHcwQzUwPe9DAAPZrAGvvNlAHkwAzbwHS0D0IMZtIHvPxnAHszADXwHygD4YJresTGAPpim92xMQ3eJJvdNDOAPZiAHYWgDAMJ0zLYEDITpQ8ROAxiEFbuIGQNICCusZYKbiwCGsMK6uHCDH/AQZqgHbsYAIMIsEcH1AZAIs0wEtwoAFGGWiuBWQQGdXQVtFQAwwgz+IKwCgEaYASCEVQDgCDMIhLAKAB5hET7CACBhex4x/QAjYYaEEKYfoCRsHzFNACdhhoYQZiIgJczwEMKMAayEGSJCmDGAljDDRIiRAXgJM1SEcmoCxRkuQpgxgJkwQ0YIMwZQE2bYCGHGAG7CDB0hzBhATpjhI4QZA9gJM4SEMGMAPWGGkeBNBvAJM5CEMGMAQGEGkxBmDEAozIASwowBEIUbUIKbMRxAFG5ACW7GcABRuAEl6DLLAUPhBpPgZgwHCIUbSoKbMRwQFG4gCW7GcABQuGEkuBnDAT/hBpHgZgwH+IQbQoKbMRzQE76jMT8H8IQbPoKbMRywE27wCG7GcIBOuKEjuBnDATnhBo7gZgwH4IQbNoKbMRxwE27QCG7GcIBNuCEjuBnDATXhBozgZgwH0IQbLoKbMRwwE26ZCW7GcBjSMTAT1IzhMKpjYCa4yJPADmuZEKEdQHec3sRxGN1hqQmRFujOgBF8JeIwwsOAEaK/wxgPA0YY5/e8eCs4TAyUZ8gIMThgoIchI2TBQHmC3hBwgE24QSNUwYCbcMNGiGkNcBNu2AhZMNCdoLdyHIATbsEJVTBQnohMmICccBFTHkAn3OARYnYF6ISLmPIAO+GGjxBTMWAnXMaUB+AJt7Eg6NLMATzhMqY8QE94JCCEA3rCZUx5gJ9wGxWCL/qAn3AZUx4AKNwCFNxCAACFy5jyAEHhhpIwIsYMIBSurPaIMDOgPWWnTdQ3xQFF4YreGHBAUbiiNwYcUBRuSAkR6QcoCld01BUHFIUrqzzUIcMBRuEGlTCO4nwOOApXVnsozucApHBttYd/HyAp3NAS3CrmgKRwQ0uIpQmQFK5tyCkeJAlQCje4hOExeBywFG54CcPD8DiAKdwAE4ZH4nFAU7ghJkzgPRngFG5xisB7MsAp3OIUgfcMgFO4xSmiQPUHcAq3OEXgPQPgFG5xikDZCwc4hVucInfo9AKACjfQhJpeAFHhhfUZ4DYnQCq8sDtz3OgETIUbbsKIuRZAFW7ASX8iHuv7gKpwQ06YVPeKvRU7mBhocL+LtAbgKtywE6o1AFjhFqwQrQHACt+LSGsAssL3MtIaAK3wvdWgRvsGYCvcshWqNYAGLVyReOcHdIVbukKVDDRo8QrVzkCDhqFQ7QwACz+wSDsDwsIPPNLOALHwg9XgHm0NwFj4ITYGAWThh9gYBJSFH2JjEHAWfoiNQQBa+CE2BgFp4YamEGsVIC1iFxmCAqAWsYsoUADWInYRBQpAW4SNWMEDaAXALcJGrKgdpm0BeIuwESsKDY4QALgIG7GiOJ4YRI/biBWFBkcIgFyEjVjBw2QFYC7CRqwoNDhCAOgibMSK0mhiQF2EjVhRqDUlAHYRNmJFoWumANxFGLZCdA3AXYQNWFGo5SUAeBE2YEXvsBNLApAXYQNWNK5tgF7EcI4GP6gA2IuwASt4tK0A8EVY+EJ9IFCg4SvogSwB0Iuw6EXjvQigF2HRCx7LKwB6EQavMI1aXgKwF2HZCx7RKwB8ERa+aLwXAfoiuNUfPg8A/CIsfsFDewXAL4Lb4Ae8ZwD+Iix/KfB5AJ61MYyFFXjPgMdtYgBGwBM3BrKwAo2oEpNDN5FNvIDnbgxlYQXeN+DRmxiCEfD0jQ1eKfDpCB7AiTEYAQ/hDOErqMkj4DmcGIQRAMIIaTWImg8CUBhhKUyBd1FAYYSMLYIAwwiLYfAwaAEwjDCohe3x/gw4jLAchpidAYcRUsdkBhq0IIYYVgDECANb2B6fcAGJEZbE7InDYUCDlsQQAxaQGGFJDL5jE4DECEti8A2NACRGKEHb+wKgGKFkZJUHLEZYFkOs8gDGCKUj/RnQGGFpDNUaQIOWxlCtATRoaQzVGkCDlsbs8aUN0BhhiAvb49MXwDHC4pg93nSAxwjLY/BDgQDHCE0eAhYAxggLY/b4iglgjLAwBg/fFwDGCAtjqK8D6rMwBg/3FwDGCAtj8Ih/AWCMsDAGD/oXAMYIC2PwuH8BYIywMAYP/RcAxggLY/DofwFgjLAwBj8AIACMERbGEGsxgDGioJ1IArAYYVkMfrhAABYjLIshVlfAYoRlMcSCCViMsCwGP7ggAIsRlsUc8B4KWIywLAY/uiAAixEGt3D86IIALEbs6QEISIwwsAWPyhEAxAgLYvCoHAFAjDCshTjxCziMMKgFj7QRAMMIQ1rwcCoBKIwwoAUPpxIAwgh7NAgNpxKAwQh7OAgNpxIAwQhDWfBwKgEIjDCQBQ+nEgDACBvlgjosBOAv4kBHJwmAX8SBjk4SgL6IAx2dJAB8EQc6OkkA+CJ3dHSSBOxF7ujoJAnQi9zR0UkSkBe5o6OTJAAvckdHJ0nAXeSOjk6SALvIHRmdJAF0kTs6OkkC5iJ3dHSSBMhF7ujoJAmIi2R0dJIEwEUyOjpJAt4iGRmdJAFtkYyOTpKAtkhGRydJAFsko6OTJGAtktHOdglQi2R0dJIEpEUyOjpJAtAiGR2dJAFnkZyOTpIAtEhORydJwFkkp6OTJMAs0p4LwvUGKIs0IAWPZJIAskjDUfBIJgkYizQYBY9kkgCxSENR8EgmCQiLNBAFj2SSALBIw1DwSCYJ+Iq0fAWPZJKAr0jLV/BIJgn4irR8BZ/YJeArUljLBLVwJeAr0iAUjp+TlICvSMtXMDNGAroiBX2cXAK4Iu31JqhVIAFbkQaf4FaBBGhFGnqCWwUSXnJi4AluFUh4zYlhJ7hVIOFFJwad4OachFedWKyCm3NyctuJJM05Ce87kbRpIuGNJ5I+iyfhnSeWqeDLLLz1xCIV1IyR8N4TS1Tw3g6AihyAClou4CnSIBPCjAE4RRpiQpgxgKZIA0wIMwbAFGl4CWHGAJYiFX2XkAQoRUbiWiQgKVKR9wlJwFGkom8UkgCjSENKCDMGUBRpQAlhxgCIIg0nIcwYwFCkwSTUjT1AbZq8t0YCgiINJiHMGIBQpKEkhBkDCIo0kIQwYwBAkYaREGYM4CdS02GAEuATae9Hwc0YQE+kvSEFN2MAPJGRO1IkYCcyckuKBOhE2ntS8BkKkBMZORckATiR9lwQPvsCbiLtuSB8JgHcRNpzQYS8QG/2XBAhL9BbQd/HIQE0kYaLEGYMYCbSMhPCjAHMRFpmQpgxgJlIG79CTOyAmUjLTHAXtwTURO4jnh8JsIk0ZITj1z1IgE2kQSN8h99qCbiJtPEreLCLBOBEDvErKPyWgJxIQ0eIeRiQE2nDV3B/vwToRNrwFaLlADuR9oTQDr/mDMATebCmJa5tQE+kISQcv85CAnwiD1aBKNWTgJ/IQ8R1JwFAkQaScPzuCwkIijxEXHcSIBRlEQp+Y6gCDEXtIs5XBSCKshAFv1VDAYqidhHnqwIYRRlUwvErOBTgKGoXGYIKgBRlaAnH7+tQAKWoXUSDCrAUZXgJZ/g1bwCmKANMcMNYAZiiDDDBjTEFYIoywIQz/AY5QFMUs/pDUbkCPEUZZsLxS0MUACqKWf2hM4wCREUN962gXj4FkIpikRBABZiKGu5bwZUNoIpikRBABaiKGu5bQX0dCmAVxSMRZApwFWWvhMVPNSsAVhSPzKEKkBU1XAxLXKwINMgjIYAKsBVlA1iIiQDAFcVjGgR0RdlLYqmSgQZ5TIOAryh7VSx+7EoBwKJETIMAsCjDUDh+A68CgEWJmAYBYFEWsOCnKRQALErENAgAizIUheNHLxRALErENAgYizIchePnNBSALMoGsOAhGwpQFiUiYbgKYBYlI2G4CnAWJSNRnAqAFhULYFGAtChpNYi6MhUgLcoGsOCBmQqgFhU7SKQAa1E2gAWPD1UAtqjYSSIFaIuS+8iaAnCLknYM4msKvGnWMBWOn1xR8LJZC1zw+50VvG/WEhf8hImCV85a5IKfMFHw2lnLXPATJmpy86wZg/gJEwUvnzVkheMnTBS8f9awFY6fMFHwCloDVzh+wkTBW2gNXSFMbQXQizJ4BSeHCqAXZfAKF3jXAOxFGb6CIygF2IvSVn94NwL0RQ3HidBtlQL4RWmrPzSkVQH+ogxj4fhN1AoAGGUgC5f4RAAIjDKUhUt0+6oAglEGs3BJ3GIM9GcjWPA4YwUgjLIRLHicsQIURhU8Yi8CDKMMauGSuE8ZaNCwFo7fj60AiFGFveYe7/qAxKjCahDvoQDFqCISQqYAi1FFJIRMARijikgImQI0Rhniwon7ugGOUYa4cOLKboBj1J68+U8BGKNsAAtxwTeAMcrwFq7w6RbAGGV4CxonrgCKUcNRInywAhSjLIpR+DQOUIwytIUTF4MDFKP29hI5vC8DFKOGq1rwvgxYjLJ3tSi8LwMWo+xlLfihBwVYjLIsBj/0oACLUZbFKLwTARajLIvBbwtXgMUoy2LwC8MVYDHqYB+b4OiQAixGWRajUf+dAixGGdzC8QMHCrAYbVkMPpFrwGK0jWfBd68asBhtWYxGN9EasBhtI1o0aqRpwGK0ZTH4UQYNWIzeWQ2ifUMDFqMti9HoGNSAxWiDW3iBLj4asBhtWQy+FGvAYrThLbwP0J72DQ1gjLYwBjU1NIAx2sIYPORaAxijLYwpcG0DGKMtjMFdBhrAGG1hDN73NYAxmim672sAY7ThLbxAFyoNYIxmVoF4pwMwRjP75EuBahvAGM2sAlHrQQMYow1v4fjhBA1gjLYwBj9voAGM0TEYowGM0RbG7PHnDgCM0TEYowGM0cNbPXivAzBG2+d68PMGGsAYbWHMHn9OAcAYPTzag3dRAGO0hTFEFwUwRtune4guCmCMtjCG6KIAxmjBI10UwBhtYQzRRQGM0TbaheiiAMZoC2OIeRHAGC10pJ0BjNEWxlBNBzQo9rGmAxq0t+ESSwqAMdpeh0vIDGCMHu7DxdsZwBg9wBjUztYAxmgZOYuiAYzRUkYWWABjtOEt5AcCDUo7BlELQgMYo2XEkNEAxmgLY/BDIBrAGG1jX6imAxq0wS9E0wEYoy2M2aOmqAYwRlsYg58D0QDGaAtj8HMgGsAYrchYeA1QjLYoBscaGqAYbc8SoS5uDUiMtiRmf0A7MyAx2pIYwjABJEZbEnPA7SP4JJChLXiQnIaPAlkSg59b0fBdIE3HVWv4MpAlMfgZFw0fBzKwheNnXDR8HygSCKMnLwTRgTAavhEUCYTR8JWgSCCMhu8ERQJhNIAwurAP10lUzwDC6MLqTuGJge4shDngD18CCKMthDngszKAMNpwFsIaBwxGWwaDH5zRgMFoy2DwgzMaMBhdFBFzHDAYbTCL2OHDCTAYbTCL2DE8MVCgwSxix9HEgMFog1nETuCJgQINaBE7vGsACqPtXbk7vGsACqPtZbk7vGsACqMNahF4RIUGHEYb1CLwiAoNOIy2J4nwIAkNOIw2qEXgcQ8acBhtQ2LQtQFQGH2IDUBAYbSlMMRCAiiMPvBINwIURtsLXfBVB0AYbSEMseoACKMthCFWHQBhtIUwxKoDIIw2nIVYdQCD0ZbB4AsJQDD6QL+FpwGBKXb0a3gFADDFjn4PrwD8pdjRL+IVAL8UhrDg030B6Eth6Qs+gxeAvhSWvuAzeAHoS2HpCz6DF4C+FPZQET4dFoC+FLs9PcMVgL4UNhIGn+EKQF8KS1/wGa4A+KVgjJ7hCoBfCsbpGa4A+KUwhEXgTysXAL8ULLJ5LwB+KSx+wSlXAfBLYQiLwKOkCoBfChbhZwXALwWLENAC4JdiwC/oPrEA+KUwhEXgL0gXAL8UhrAIPKSqAPilMIRF4KFPBcAvBadnzwLQl8IAFsHwNwIBfSl4xA1fAPpScKtA/N1HQF8Ke5cLtkQVgL0UA3tBWWIB2Eth2Qu+nhWAvRTDs8n4pAHYSyEii18B2EshIotfAdhLYd9PJiYNwF4KGwiD6xqgl8KiF3ylLAB6KQb0gq6UBUAvhUUv+EpZAPRSCPr9qAKQl8KSF3SlLAB4KQxbwVfKAnCXwqAVYqUE2KUwZIVYKQF1KQxYIVZKAF0Kw1WIlRIwl8IyF2KlBMylsMyFWCkBcylkbPEDzKWQscUPMJdCHiLrGWAuhdpF1jPAXArFIusZYC6FslMnSicLwFwKe5cufultAZhLoWKLH6AuhYrcY1YA6lLYY0eUzECDhqwIPPSxANilsCePqA8EGjRkReBhhMWAXX66v6ubT1XbVcdvmmP1+e6rd+/u/v737stLdXf/r7u/1/Yf+2Yypd599a+7/nL0r/717/u7/jJz+4dg7g/h/lDuD5dYuMTSJZYusXSJpUssXeJCDn/sd+4P7f7YD38chjT9lYf2DyePcPIIJ49w8ggnT38Uwv5x4O6Pwv0xpOnjy4c/hPtDuT+GxH2I7/DHIFgfQDv8wd0f0v3hEnOXWLjEwiUWLrFwiV1DKddQ2pWsXcm93Wb/4EPivjN/9a9///vead/8X98byveXri0fupfz+RSoW9y0zcRM5l/O7ceq9bP31HPM37NOooCHrv4UdjPpZeyv/hwUdIiWUDdd1X4qgy/oVzNPhEGN/bbPNontBViRx2NXXj4+XpuHrj43fpmq8IoclMWU65+7scMP/9Ifubd/6KFW7f4oXEct7FjA5bAN+/DhXD9UfVN31dOXoLUOXmv1F7fMlNScj2Fr77wP6p9HJfI/dlXbt0n1uXq49o3y4Xz+6BdUqFs5xdCd+5fEbHu4/ihdf+wPg0Wqugl7qbrri1/RXt8q2h9cRW4+YG7UuiHVn/giKnp6aqunsgvbY8+89pTj4NtThVy+NA9tdTlf24cq7P/ebKk5+bWfyvpUvj9VL2Vbnk7Vqb48h8X4HU5xspiqLZ/AOPIGcH8l9DBhOpUc3AzsJjrh5jdxm2Go/vS+fPj40laXy7UNKxWFX6mbzTQ1+byvHs9tFe9Y0utYhdM3d/p284Ob+voTiVRdT3XTV/VStY/n9rlsQo0JfyjoPVnM9eFj1V0CJSlP133AVTRn/c+woyjmZyZb6lqfzKx0+flaXavzS99WgRTSG4GSluESzB9B5UMTMrcuMbcqCrfM9ifd6YK9URt2Ct9w0FTDPpRNc+4uXVWe+u8MxvzhVsCBGgMPH6qHj9P1pCfqN7WyoY/rgmohW0xzrJ7r7vilKZ/rh2ESbquyb/TqU9WE+u+vJrhNos4WYK5L9u/ADc2oXTNS66Ffe/X80n0xtYWV7f0ZmxqhfkFtVR6nBR0OvtDxVrXlBOMUawbul0jqGZTY9+e6ecLK802QHdXzTHnP1eVSPlVWU/UxGNfed8pR/dQ4s6XVTf18fW6uz++r9vxoS72Ek4W3TER10NtVyGgV/joTbfy+AGiLc++bBLVom9xwumG+jqL1+iZQON0dPL1ocm43hXwqTzVqxGBN4okmogPEFogU0btrPdHoQs7nS9gsvv0iBP1NfUbclCq85WNP6qRuH66nsn1/fXwMDWavQ5GZT1UZGtm+OarombHPd1s7ghK4V29/yo4q4Xrpqpboy/0jp7dOVZDDwRYy3Sv0XjBv5aVsrYdz83Bt26p5CE1gLf2hRNZ+bi5de33ozkHd3jAc5gY2LoPDtN0/qmrnb+02mXtnbbgtpXJzvHarqHbGacHJpaZfUaqyORojN1hsYOfyrUm3KjPtthtu1yndrlwWZCMGdRKVeY3ivpS5b+fjlsaZCZJeS01l1M5D+7M7ZaUfy64MOqz2bS1nu2qnNO1whCZNoGP10Fb9v0wtsYNfNDUHHKvH8nrq0N0Y976pfwgpWsLs3s7fQgtNrX/H6lR1lT9b24KvF7Aj6M9P3r5PUOvzsZrOEsrPSW7Fh5yn8tK9tPW5rbv6n9URGnPcny0UOV6HwmDu/lCzZ/6M3IWWqa2e6tu8MxgKp/6fmnAa2ntLgDN4mYNHzLEn4UiTJHdHx16d50CX2vvmws0rDiBwNqKznRtbzI0talIfKqmbp7BxfUYXz0osY14JxTj4nYDM4TE3OcqCWjOO9eXh3DTVQxcK6I/fHTnI7GQY5PT3lkqTjW9zeitW2H1865nufLaQ7kNvOsMy+sttPeZCfr8/nxsTPBzcnhElJNl9/UImI5r5y0J//zpeSHW6hmTAn6XGPZ5yq5wjZaoY51LhFjfKNDHGfDicmDec3ALFxLi1HPmxq38ErvR39BuioK96XXUoxW2+HMNgDvfJnfuDnJerpicxyEZE+RMxaTXb7Lid5cOYUbQRcDsUyOUgoxi5BnMzAtnhq+YYpRo+h91Ti0jVIJO+8Cd9UikNMU/7m7cbFqfb/lNo1Pn7ozE7aVtWbXsGNqUPJMmp0OT7UDbHE+y8/sgauw6JZ0ynQcrh/h5W0s3fZz+dzy/Xrj7V/zSc4bkqe7xmLJWu7OpLVz+Emx0fO0gSO9kde6Ba7U0A2jFU5VwpO9ctnYEnCvf9zPlLCnIisLUdQ8PDX/EVqcMhqxlBIUDyUSZpCA35cUzufbEg7dWhhGlf9jfNjDKcBjQCFmSfFCgS4I55kY+X/sfTotdY/2P+IBa70adF6eCxrE9AeUL5H0DVbzMi0nuq56Qx81j3BLz7EFr6fk43ZTqfi8PX0lFrSbbtY/25OlL2gL//ZRH5PldHyhrwOockycHjqXy6GVzlpTl3U5vA3wcztwQwPY5HtxY416bckwKfrpcP+FLU3zPn1eKGv4P1fDQ9nQ9SkiYOqAVAAd+zxKn54vF6CprTW61Gp6iboJwRunOCjdYoSXqeKgBP/T0nnee5rBuEU/iGn3ZersKNqoLccj5V3cv5VANu4WM0QXa9p6qb7u3oTaP2RYy0StJ+0TcASCI3FHZbo9rq52s9LFzhB/ughtw3PFXYzrgOe5cOEORcSXXzeA67gW+b7kZ3pVsBx2Vu3I+RntWxjn5Yf6y+vP+CMWjpaUVGNH0rytfPsJkO9eyDTmpFIkuc7UWe9UUCXrvcTC0v3+TRe+ZGicNhZEey5X2sT6dhkx6SXd8754hcsRud+dRoHhbFfq5Fi5V+sYO6+zj5gd1RGzNbLLQU/IiDQ/w7A2dKW11ezg1A0jufTZI75VtpTrnnl6odLEjke33Tz5GIwgUuFKR/z1Zz602+B3jqWvKn/l1cM7ci6+MJKcobqQdqD+KXZDSNt2cw+dPauZDebeZrhI1hPNTw+1BeyDgSTw1qtMCdb37nWOu4BI8BFI756vEPF59USLKh60t3br+Ec7svAOmODGcx7iNb6TiYGiNr1CiSG/Ska6zXdcgk/MABBwckueusg54DTE6fgZGzV92QGHjv64ZsGrCm+Ga6GHf4znZxjcW529g7HUvXaoo0SOqm7szAQCiLCDBSpIBba00W+r03MEhbz0RYNeVpEkHg8zz33crFZ+xGjuH+oBUytc0DmEktm/Wlt9YCLOS1idu6MhcQxIoxqGFc5cfYrHH+dyYdGfhTX7y5EDaJbzdRE2rv3w/jN7yxRedpS+DA4r7F199CQ2RFQvR8K0jSHX3WT1H4PJT0dtU4b+Y+0Fc7qr17syDM5jeyMwP0jppw+vzvqw/lpxpyIm+0F67fFqTa/HKA99oH54qyG/r8yD5d+E6Rwi0EhaKao/ex9GtLVz9Xl658DkLkuB8vo5Xzkbk5qCBdP71XJHD7v7S9MdEB49v3k7lILKZcCJ7bDnHhgobGoDxnYGs97p1cg5NLEL4V6w98exsASuvP5eeybcsv9fFz8AFe16Fz9iEg4RrlxzG5iYU7zy93RiN3yFmRK/JQeiTAhAdRsG45cY09hsWO8ysZ39tX1diwqL6zhF1253c6auA+l5/N9h5goWDej9Ru8yJkyOc7mhovz+XnaQiLz5TcnK1IuOqB1HDa8qm+A0uCHPleMVgMROGH5JCuQR/qhp4cP/6E7s+zTJj7fZuMcEbLIfftvn0g6IFaHeuyCQeMjy4dL+EupIAfxpEz/CTcdCDk+Mc4lqj1H9vl7P1dHbmnGXI+fCibpgKri+9rJMPfhwJQ7ur7L8ZzApIcJ7RbmvtbIF2M+2k3m0tyCrNlfipPwLHjB8yoAznybBBcqFDfInOGFHd7fO4sKn5wHyxmSo/NgMof5cPE5w5sMDfZSuc7k6Rf4bluplOIP72Si7VJ4YvkByNrZ9JqZ1rq0ZB0s4kmlWMocL80hZ/s23KkKR5uJbnv4ZMHqrOfgWOwf8zBy0YZGufmVDd4D/dnBdcbFTnYzi8gaDrY8LkFzsVgjcdwRtbrbCLtLA7tZo2C7GQvVfXxsW4vYQSC8qfIA7VE93l7KyvMGmzbqQ432cj4UYmC9GH22abhvj6E5aT/fcwbztzaX+JITtFnniBSP1iIk2OLigiUQYAq1ZGx0Fbmo13BqH7psoLv9aslD128nNtQrf6GUTunQsHJuhEey32xleua2gXLaUeStYtQKOhPG4qfeuT9VlUkkg7yT7ZbPtpV5Gzx0p6f60vlONpz+RK2s+80c1Oz+8PFTonDeGqAHKBhNb+05csLWP2KYLNB9v9rSA09aEjkwExav2nII2ukPRusV5RyezwJdiP+riKSK+huIjAX3ezpwrXc8svdpkw6C0S6f1HjNEpip9uxAcudQGN5UlNWTVsd60vX1u+vXUU0m7+PI0MuXQhfv4ZZS4GMt/APqSoSP04LjMUFejPhfuztY3DwwfV2txUjd31hJCL9CX43JB0Q6WGNnqb2ox3lFtpiHKxuoSVX07b6Bwzm8yOFNRk93lbPZ3DIs/DjMcQYZ0KPmr4EEqb7IU7uwxyL5I4NcTFGsbg/tEMj7o/CRRMU5HbDijJ/LtNfiUg3vV/YNEDaj6ono87a/ohk2Lb+Akr6xUw+Mxz7odl0dXk6fbl051PV3LaEhGfYd5odqD1mfyryBM5i+TtJTUZftj3SagdifW4mHkbmH3sQ5BGotupaQK6YP90IMohpyPlwvgJjzD+NKUi3a3sNuqfw47S0w0WFi+wryNWxvTbmfGlYmO/Ac1vpYjRaSEutvTbTsvydpTsZWrho5IK0NttrA1kS813cfDwx4WI2hKOQyp3h1G6Lr8nvv1TN0XMHd+cpB/TRMxlR0JdjetT1JVKUr1u3u2TObGNObDEGHpGugaG6YQjFavTmLXIzcRniOyfeXazEIE6fGpizJYaw198txT6ZAMfdmQqm8SMYXHR94YIxCjIK2NRFFuovSGP8slvbCvKknS0U6V/eHOxGLht5rGPAYqQRJHGbzrKhNeXvHhQ1sVyqbjg7Qi2FOghncEuhI/KucbnjE9JdUyFdkJl2fxQOLRcktLqJM78c+vYqefjyUuFo1Z91nVdBkAf73bpGHpT2PW3OIFIO3jsLgMvRfeFGvKZ7j1cjZE1+tH2kU9sSzPHnunk6N1QQQrAHpCeNISbLlhbk9xozMvN2fTAq2Fz7FIMM5DbnyiaH+L2sDhuyMajTHTORo3M81kPm+prPKEf/u7srhR3GITASJqdnEgMSlWJdy48Fdbsx15GYi9Tg7ifpgqKkppbay4fydLLn6IKzIEHr+kGTzv51bcncv4jxjhvStjWVEUHQOrAVYgVcX45l0oE0fxNAj2YwnHzzZ/iw8Yod8tIGs/oHpfhe33HL4PTjTDM+3iIyht6S9M5UQd1B4N/SoskbKkwR4Tbbdws7GTi9PvQFwAB03y6LCl83TwlU3qcVpMHVFzdflvbP75ADoC8Ld3MHhDKWHamb+aaSIMMOCC+bf0hO78b4J0f9HH8pBMXX+nKv4EIA/6KTiKamU3r/XJwXcEJrxWYl46b8nhIpZWq8+FYn6T+1GRFu5rtiIsPr/EKOLh8RkhcLYWsF94/9a8cFtKMj2hkbBXm+1JU6OafsM1LltmeKNgCGcpA48SK4KsKZP2SwuSsJ2/4GThfamv/SPCAL3mQv7Ztl5I0Hk+O/Po/SZLRQn81sfjErV/iBmAXpnqWMZO7vGvUYvu9YfUHaNsGu6T2kYcI/JlQwqh+iW68Q0QeXjFGmEFpOW12uJyCVHw1HAnS0tOksxf2FU5N3vITR61gMEfddNXqM3yJDk8jbSIIDveNM7MpzULZw5lBBBkkmBD5x/zSTGiNwydWjLxKE0BYBq3TyRoUiTnby4BSf261pEt9OZl7ubwUUOW+afI91U18+VMd+IT6Hvhbmd1dB+gJuGyR/ZzMJvvXVqcYQa/J0jFcqfruWDIhIbKYg94vMj3cTTiZBLgn0VpAFZ6LHKyLJE4WJW0Lm9wRBWmXhKZ3QqPNbncR+icd8/M2ecKxEzJQ6tWqYv+MQZPivyU6uE/4Og+6aVftcN+AmQO6vMcqFISh6wfpgXXuh7R1stkk1jwcLsSuNdsF+llSuKQO7W8c3skmXOG5g++BFu+6q3ZUYmoxy686T0Jbw6ASVry2by2PV9m6sUBB/qnMeZ03SPBhT4N8cMUYQuYsH2Hgl4ngDwnj+YLwAktyfX5u2egz7jR/DQx5+uTbpyCeICqK++VYgBn388U2KZPbt4VD2N0nO5SnIDawtIRqbLHyvliYPrd8Ywhr3lGfxkBEOXg2JpXrTGjmUp4co/SlfkT3fO/cftJY/sY9BUo5ZulMKfLyexREmOZ70dntSSQY6faraC6iWBbF3ZJf7VLfd1d7W2ONzdArxdxyK5I2/lHU39Sj5QoxudheiL9yXKdJr/EtVP32Asax+jyZHNTKP+kF2o3dovOHRhbS627/EYYRt4x3R5MfPb7X8S2+Fi9wQ5GUAeIkP56arPgNfsTcrj1ceuT9cOKdw9/iKsX+RkwheNbKr9c8oCBIo4sWlnjf2IxTJCPNZ34XvARO7sR9S1kQiKmZ+LKFwxFGQbG8IGoG+cB5w2d3oU41LB8wUH5mrMSiCXLvwQ9Xcn6wUCRdm41V8VsqcN4Y5qfjosXKWpSTRww10mVib/gh0HYZ5+05rRZ4jDw54h/n9aKPxdAsJI28FYYaeDI6NxbvrlN7516I5y2Y8hzjel+/upOXjJDLej0QCJa9G7HJe/0QxGUxO3tjJdHCTqpss3UnsYmY8EPsZ/zSFJpmbLWJyt6q/7ijSE3XLDLTom1ozXXNqLfjOQkXaWb+0ddffNRV+s28jk57BPmsFAhD9eCEs20/3dy/1S9UHgt999e6nf//7/wOn+3LyoIMCAA=="; \ No newline at end of file diff --git a/docs/classes/AbstractPool.html b/docs/classes/AbstractPool.html index d2afab17..9c8889b0 100644 --- a/docs/classes/AbstractPool.html +++ b/docs/classes/AbstractPool.html @@ -1,8 +1,8 @@ -AbstractPool | poolifier - v4.0.11

Class AbstractPool<Worker, Data, Response>Abstract

Base class that implements some shared logic for all poolifier pools.

+AbstractPool | poolifier - v4.0.12

Class AbstractPool<Worker, Data, Response>Abstract

Base class that implements some shared logic for all poolifier pools.

Type Parameters

  • Worker extends IWorker

    Type of worker which manages this pool.

  • Data = unknown

    Type of data sent to the worker. This can only be structured-cloneable data.

  • Response = unknown

    Type of execution response. This can only be structured-cloneable data.

    -

Hierarchy (view full)

Implements

Constructors

constructor +

Hierarchy (view full)

Implements

Constructors

constructor

Properties

destroying emitter? filePath @@ -114,8 +114,8 @@
  • filePath: string

    Path to the worker file.

  • opts: PoolOptions<Worker>

    Options for the pool.

  • Optional maximumNumberOfWorkers: number

    Maximum number of workers that this pool manages.

    -

    • Returns AbstractPool<Worker, Data, Response>

    Properties

    Private destroying

    destroying: boolean

    Whether the pool is destroying or not.

    -

    Optional emitter

    emitter?: EventEmitterAsyncResource

    Pool event emitter integrated with async resource. +

    Returns AbstractPool<Worker, Data, Response>

    Properties

    Private destroying

    destroying: boolean

    Whether the pool is destroying or not.

    +

    Optional emitter

    emitter?: EventEmitterAsyncResource

    Pool event emitter integrated with async resource. The async tracking tooling identifier is poolifier:<PoolType>-<WorkerType>-pool.

    Events that can currently be listened to:

      @@ -128,124 +128,124 @@ The async tracking tooling identifier is poolifier:<PoolType>-<Wo
    • 'taskError': Emitted when an error occurs while executing a task.
    • 'backPressure': Emitted when all worker nodes have back pressure (i.e. their tasks queue is full: queue size >= maximum queue size).
    -

    Protected Readonly filePath

    filePath: string

    Path to the worker file.

    -

    Protected Optional Readonly maximumNumberOfWorkers

    maximumNumberOfWorkers?: number

    Maximum number of workers that this pool manages.

    -

    Protected Readonly minimumNumberOfWorkers

    minimumNumberOfWorkers: number

    Minimum number of workers that this pool manages.

    -

    Protected Readonly opts

    opts: PoolOptions<Worker>

    Options for the pool.

    -

    Protected promiseResponseMap

    promiseResponseMap: Map<`${string}-${string}-${string}-${string}-${string}`, PromiseResponseWrapper<Response>> = ...

    The task execution response promise map:

    +

    Protected Readonly filePath

    filePath: string

    Path to the worker file.

    +

    Protected Optional Readonly maximumNumberOfWorkers

    maximumNumberOfWorkers?: number

    Maximum number of workers that this pool manages.

    +

    Protected Readonly minimumNumberOfWorkers

    minimumNumberOfWorkers: number

    Minimum number of workers that this pool manages.

    +

    Protected Readonly opts

    opts: PoolOptions<Worker>

    Options for the pool.

    +

    Protected promiseResponseMap

    promiseResponseMap: Map<`${string}-${string}-${string}-${string}-${string}`, PromiseResponseWrapper<Response>> = ...

    The task execution response promise map:

    • key: The message id of each submitted task.
    • value: An object that contains task's worker node key, execution response promise resolve and reject callbacks, async resource.

    When we receive a message from the worker, we get a map entry with the promise resolve/reject bound to the message id.

    -

    Private readyEventEmitted

    readyEventEmitted: boolean

    Whether the pool ready event has been emitted or not.

    -

    Private Optional startTimestamp

    startTimestamp?: number

    The start timestamp of the pool.

    -

    Private started

    started: boolean

    Whether the pool is started or not.

    -

    Private starting

    starting: boolean

    Whether the pool is starting or not.

    -

    Private startingMinimumNumberOfWorkers

    startingMinimumNumberOfWorkers: boolean

    Whether the minimum number of workers is starting or not.

    -

    Private Readonly taskFunctions

    taskFunctions: Map<string, TaskFunctionObject<Data, Response>>

    The task functions added at runtime map:

    +

    Private readyEventEmitted

    readyEventEmitted: boolean

    Whether the pool ready event has been emitted or not.

    +

    Private Optional startTimestamp

    startTimestamp?: number

    The start timestamp of the pool.

    +

    Private started

    started: boolean

    Whether the pool is started or not.

    +

    Private starting

    starting: boolean

    Whether the pool is starting or not.

    +

    Private startingMinimumNumberOfWorkers

    startingMinimumNumberOfWorkers: boolean

    Whether the minimum number of workers is starting or not.

    +

    Private Readonly taskFunctions

    taskFunctions: Map<string, TaskFunctionObject<Data, Response>>

    The task functions added at runtime map:

    • key: The task function name.
    • value: The task function object.
    -

    Protected Optional workerChoiceStrategiesContext

    workerChoiceStrategiesContext?: WorkerChoiceStrategiesContext<Worker, Data, Response>

    Worker choice strategies context referencing worker choice algorithms implementation.

    -

    Readonly Internal workerNodes

    workerNodes: IWorkerNode<Worker, Data>[] = []

    Pool worker nodes.

    -

    Accessors

    Protected Abstract busy

    Protected Optional workerChoiceStrategiesContext

    workerChoiceStrategiesContext?: WorkerChoiceStrategiesContext<Worker, Data, Response>

    Worker choice strategies context referencing worker choice algorithms implementation.

    +

    Readonly Internal workerNodes

    workerNodes: IWorkerNode<Worker, Data>[] = []

    Pool worker nodes.

    +

    Accessors

    Protected Abstract busy

    Protected empty

    Protected full

    Protected empty

    Protected full

    info

    Private ready

    Protected Abstract type

    info

    Private ready

    Protected Abstract type

    • get type(): "fixed" | "dynamic"

    • The pool type.

      If it is 'dynamic', it provides the max property.

      -

      Returns "fixed" | "dynamic"

    Private utilization

    Private utilization

    Protected Abstract worker

    Methods

    addTaskFunction

    Private addWorkerNode

    Protected Abstract worker

    Methods

    addTaskFunction

    Private addWorkerNode

    Protected afterTaskExecutionHook

    Protected afterTaskExecutionHook

    • afterTaskExecutionHook(workerNodeKey, message): void

    • Hook executed after the worker task execution. Can be overridden.

      Parameters

      • workerNodeKey: number

        The worker node key.

      • message: MessageValue<Response, unknown>

        The received message.

        -

      Returns void

    Protected afterWorkerNodeSetup

    • afterWorkerNodeSetup(workerNodeKey): void

    • Method hooked up after a worker node has been newly created. +

    Returns void

    Protected afterWorkerNodeSetup

    • afterWorkerNodeSetup(workerNodeKey): void

    • Method hooked up after a worker node has been newly created. Can be overridden.

      Parameters

      • workerNodeKey: number

        The newly created worker node key.

        -

      Returns void

    Protected beforeTaskExecutionHook

    • beforeTaskExecutionHook(workerNodeKey, task): void

    • Hook executed before the worker task execution. +

    Returns void

    Protected beforeTaskExecutionHook

    • beforeTaskExecutionHook(workerNodeKey, task): void

    • Hook executed before the worker task execution. Can be overridden.

      Parameters

      • workerNodeKey: number

        The worker node key.

      • task: Task<Data>

        The task to execute.

        -

      Returns void

    Private buildTasksQueueOptions

    Private cannotStealTask

    Protected Abstract checkAndEmitDynamicWorkerCreationEvents

    Private checkAndEmitEmptyEvent

    Private checkAndEmitReadyEvent

    Private checkAndEmitTaskExecutionEvents

    Private checkAndEmitTaskQueuingEvents

    Private checkMessageWorkerId

    • checkMessageWorkerId(message): void

    • Checks if the worker id sent in the received message from a worker is valid.

      +

    Returns void

    Private buildTasksQueueOptions

    Private cannotStealTask

    Protected Abstract checkAndEmitDynamicWorkerCreationEvents

    Private checkAndEmitEmptyEvent

    Private checkAndEmitReadyEvent

    Private checkAndEmitTaskExecutionEvents

    Private checkAndEmitTaskQueuingEvents

    Private checkMessageWorkerId

    Private checkMinimumNumberOfWorkers

    • checkMinimumNumberOfWorkers(minimumNumberOfWorkers): void

    • Parameters

      • minimumNumberOfWorkers: undefined | number

      Returns void

    Private checkPoolOptions

    Private checkPoolType

    Private checkValidWorkerChoiceStrategyOptions

    Private chooseWorkerNode

    Private checkMinimumNumberOfWorkers

    • checkMinimumNumberOfWorkers(minimumNumberOfWorkers): void

    • Parameters

      • minimumNumberOfWorkers: undefined | number

      Returns void

    Private checkPoolOptions

    Private checkPoolType

    Private checkValidWorkerChoiceStrategyOptions

    Private chooseWorkerNode

    • chooseWorkerNode(name?): number

    • Chooses a worker node for the next task.

      Parameters

      • Optional name: string

        The task function name.

        -

      Returns number

      The chosen worker node key

      -

    Protected createAndSetupDynamicWorkerNode

    • createAndSetupDynamicWorkerNode(): number

    • Creates a new, completely set up dynamic worker node.

      +

    Returns number

    The chosen worker node key.

    +

    Protected createAndSetupDynamicWorkerNode

    • createAndSetupDynamicWorkerNode(): number

    • Creates a new, completely set up dynamic worker node.

      Returns number

      New, completely set up dynamic worker node key.

      -

    Protected createAndSetupWorkerNode

    Protected createAndSetupWorkerNode

    • createAndSetupWorkerNode(): number

    • Creates a new, completely set up worker node.

      Returns number

      New, completely set up worker node key.

      -

    Private createWorkerNode

    Private createWorkerNode

    Private dequeueTask

    Protected Abstract deregisterWorkerMessageListener

    Private dequeueTask

    Protected Abstract deregisterWorkerMessageListener

    • deregisterWorkerMessageListener<Message>(workerNodeKey, listener): void

    • Deregisters a listener callback on the worker given its worker node key.

      Type Parameters

      • Message

      Parameters

      • workerNodeKey: number

        The worker node key.

      • listener: ((message) => void)

        The message listener callback.

        -

      Returns void

    destroy

    Protected destroyWorkerNode

    • destroyWorkerNode(workerNodeKey): Promise<void>

    • Terminates the worker node given its worker node key.

      +

    Returns void

    destroy

    Protected destroyWorkerNode

    • destroyWorkerNode(workerNodeKey): Promise<void>

    • Terminates the worker node given its worker node key.

      Parameters

      • workerNodeKey: number

        The worker node key.

        -

      Returns Promise<void>

    enableTasksQueue

    Private enqueueTask

    execute

    Private executeTask

    • executeTask(workerNodeKey, task): void

    • Executes the given task on the worker given its worker node key.

      +

    Returns Promise<void>

    enableTasksQueue

    Private enqueueTask

    execute

    Private executeTask

    • executeTask(workerNodeKey, task): void

    • Executes the given task on the worker given its worker node key.

      Parameters

      • workerNodeKey: number

        The worker node key.

      • task: Task<Data>

        The task to execute.

        -

      Returns void

    Protected flagWorkerNodeAsNotReady

    Protected flushTasksQueue

    Private flushTasksQueues

    Private Readonly getTaskFunctionWorkerChoiceStrategy

    • getTaskFunctionWorkerChoiceStrategy(name?): undefined | "ROUND_ROBIN" | "LEAST_USED" | "LEAST_BUSY" | "LEAST_ELU" | "FAIR_SHARE" | "WEIGHTED_ROUND_ROBIN" | "INTERLEAVED_WEIGHTED_ROUND_ROBIN"

    • Gets task function worker choice strategy, if any.

      +

    Returns void

    Protected flagWorkerNodeAsNotReady

    Protected flushTasksQueue

    Private flushTasksQueues

    Private Readonly getTaskFunctionWorkerChoiceStrategy

    • getTaskFunctionWorkerChoiceStrategy(name?): undefined | "ROUND_ROBIN" | "LEAST_USED" | "LEAST_BUSY" | "LEAST_ELU" | "FAIR_SHARE" | "WEIGHTED_ROUND_ROBIN" | "INTERLEAVED_WEIGHTED_ROUND_ROBIN"

    • Gets task function worker choice strategy, if any.

      Parameters

      • Optional name: string

        The task function name.

      Returns undefined | "ROUND_ROBIN" | "LEAST_USED" | "LEAST_BUSY" | "LEAST_ELU" | "FAIR_SHARE" | "WEIGHTED_ROUND_ROBIN" | "INTERLEAVED_WEIGHTED_ROUND_ROBIN"

      The task function worker choice strategy if the task function worker choice strategy is defined, undefined otherwise.

      -

    Private Readonly getWorkerChoiceStrategies

    • getWorkerChoiceStrategies(): Set<"ROUND_ROBIN" | "LEAST_USED" | "LEAST_BUSY" | "LEAST_ELU" | "FAIR_SHARE" | "WEIGHTED_ROUND_ROBIN" | "INTERLEAVED_WEIGHTED_ROUND_ROBIN">

    • Gets the worker choice strategies registered in this pool.

      +

    Private Readonly getWorkerChoiceStrategies

    • getWorkerChoiceStrategies(): Set<"ROUND_ROBIN" | "LEAST_USED" | "LEAST_BUSY" | "LEAST_ELU" | "FAIR_SHARE" | "WEIGHTED_ROUND_ROBIN" | "INTERLEAVED_WEIGHTED_ROUND_ROBIN">

    • Gets the worker choice strategies registered in this pool.

      Returns Set<"ROUND_ROBIN" | "LEAST_USED" | "LEAST_BUSY" | "LEAST_ELU" | "FAIR_SHARE" | "WEIGHTED_ROUND_ROBIN" | "INTERLEAVED_WEIGHTED_ROUND_ROBIN">

      The worker choice strategies.

      -

    Protected getWorkerInfo

    Protected getWorkerInfo

    • getWorkerInfo(workerNodeKey): undefined | WorkerInfo

    • Gets the worker information given its worker node key.

      Parameters

      • workerNodeKey: number

        The worker node key.

      Returns undefined | WorkerInfo

      The worker information.

      -

    Private getWorkerNodeKeyByWorkerId

    Private getWorkerNodeKeyByWorkerId

    • getWorkerNodeKeyByWorkerId(workerId): number

    • Gets the worker node key given its worker id.

      Parameters

      • workerId: undefined | number

        The worker id.

      Returns number

      The worker node key if the worker id is found in the pool worker nodes, -1 otherwise.

      -

    Private Readonly getWorkerNodeTaskFunctionPriority

    • getWorkerNodeTaskFunctionPriority(workerNodeKey, name?): undefined | number

    • Gets worker node task function priority, if any.

      +

    Private Readonly getWorkerNodeTaskFunctionPriority

    • getWorkerNodeTaskFunctionPriority(workerNodeKey, name?): undefined | number

    • Gets worker node task function priority, if any.

      Parameters

      • workerNodeKey: number

        The worker node key.

      • Optional name: string

        The task function name.

      Returns undefined | number

      The worker node task function priority if the worker node task function priority is defined, undefined otherwise.

      -

    Private Readonly getWorkerNodeTaskFunctionWorkerChoiceStrategy

    • getWorkerNodeTaskFunctionWorkerChoiceStrategy(workerNodeKey, name?): undefined | "ROUND_ROBIN" | "LEAST_USED" | "LEAST_BUSY" | "LEAST_ELU" | "FAIR_SHARE" | "WEIGHTED_ROUND_ROBIN" | "INTERLEAVED_WEIGHTED_ROUND_ROBIN"

    • Gets worker node task function worker choice strategy, if any.

      +

    Private Readonly getWorkerNodeTaskFunctionWorkerChoiceStrategy

    • getWorkerNodeTaskFunctionWorkerChoiceStrategy(workerNodeKey, name?): undefined | "ROUND_ROBIN" | "LEAST_USED" | "LEAST_BUSY" | "LEAST_ELU" | "FAIR_SHARE" | "WEIGHTED_ROUND_ROBIN" | "INTERLEAVED_WEIGHTED_ROUND_ROBIN"

    • Gets worker node task function worker choice strategy, if any.

      Parameters

      • workerNodeKey: number

        The worker node key.

      • Optional name: string

        The task function name.

      Returns undefined | "ROUND_ROBIN" | "LEAST_USED" | "LEAST_BUSY" | "LEAST_ELU" | "FAIR_SHARE" | "WEIGHTED_ROUND_ROBIN" | "INTERLEAVED_WEIGHTED_ROUND_ROBIN"

      The worker node task function worker choice strategy if the worker node task function worker choice strategy is defined, undefined otherwise.

      -

    Private handleTask

    Private handleTaskExecutionResponse

    Private Readonly handleWorkerNodeBackPressureEvent

    Private Readonly handleWorkerNodeIdleEvent

    Private handleWorkerReadyResponse

    Private hasBackPressure

    hasTaskFunction

    Private initEventEmitter

    Private initWorkerNodeUsage

    • initWorkerNodeUsage(workerNode): void

    • Initializes the worker node usage with sensible default values gathered during runtime.

      +

    Private handleTask

    Private handleTaskExecutionResponse

    Private Readonly handleWorkerNodeBackPressureEvent

    Private Readonly handleWorkerNodeIdleEvent

    Private handleWorkerReadyResponse

    Private hasBackPressure

    hasTaskFunction

    Private initEventEmitter

    Private initWorkerNodeUsage

    Protected internalBusy

    • internalBusy(): boolean

    • Whether worker nodes are executing concurrently their tasks quota or not.

      +

    Returns void

    Protected internalBusy

    • internalBusy(): boolean

    • Whether worker nodes are executing concurrently their tasks quota or not.

      Returns boolean

      Worker nodes busyness boolean status.

      -

    Protected Abstract isMain

    Protected Abstract isMain

    • isMain(): boolean

    • Returns whether the worker is the main worker or not.

      Returns boolean

      true if the worker is the main worker, false otherwise.

      -

    Private isWorkerNodeBusy

    listTaskFunctionsProperties

    Private redistributeQueuedTasks

    Protected Abstract registerOnceWorkerMessageListener

    • registerOnceWorkerMessageListener<Message>(workerNodeKey, listener): void

    • Registers once a listener callback on the worker given its worker node key.

      +

    Private isWorkerNodeBusy

    listTaskFunctionsProperties

    Private redistributeQueuedTasks

    Protected Abstract registerOnceWorkerMessageListener

    • registerOnceWorkerMessageListener<Message>(workerNodeKey, listener): void

    • Registers once a listener callback on the worker given its worker node key.

      Type Parameters

      • Message

      Parameters

      • workerNodeKey: number

        The worker node key.

      • listener: ((message) => void)

        The message listener callback.

        -

      Returns void

    Protected Abstract registerWorkerMessageListener

    • registerWorkerMessageListener<Message>(workerNodeKey, listener): void

    • Registers a listener callback on the worker given its worker node key.

      +

    Returns void

    Protected Abstract registerWorkerMessageListener

    • registerWorkerMessageListener<Message>(workerNodeKey, listener): void

    • Registers a listener callback on the worker given its worker node key.

      Type Parameters

      • Message

      Parameters

      • workerNodeKey: number

        The worker node key.

      • listener: ((message) => void)

        The message listener callback.

        -

      Returns void

    removeTaskFunction

    Private removeWorkerNode

    • removeWorkerNode(workerNode): void

    • Removes the worker node from the pool worker nodes.

      +

    Returns void

    removeTaskFunction

    Private removeWorkerNode

    Private resetTaskSequentiallyStolenStatisticsWorkerUsage

    • resetTaskSequentiallyStolenStatisticsWorkerUsage(workerNodeKey, taskName): void

    • Parameters

      • workerNodeKey: number
      • taskName: string

      Returns void

    Private sendKillMessageToWorker

    Protected Abstract sendStartupMessageToWorker

    • sendStartupMessageToWorker(workerNodeKey): void

    • Sends the startup message to worker given its worker node key.

      +

    Returns void

    Private resetTaskSequentiallyStolenStatisticsWorkerUsage

    • resetTaskSequentiallyStolenStatisticsWorkerUsage(workerNodeKey, taskName): void

    • Parameters

      • workerNodeKey: number
      • taskName: string

      Returns void

    Private sendKillMessageToWorker

    Protected Abstract sendStartupMessageToWorker

    • sendStartupMessageToWorker(workerNodeKey): void

    • Sends the startup message to worker given its worker node key.

      Parameters

      • workerNodeKey: number

        The worker node key.

        -

      Returns void

    Private sendStatisticsMessageToWorker

    • sendStatisticsMessageToWorker(workerNodeKey): void

    • Sends the statistics message to worker given its worker node key.

      +

    Returns void

    Private sendStatisticsMessageToWorker

    • sendStatisticsMessageToWorker(workerNodeKey): void

    • Sends the statistics message to worker given its worker node key.

      Parameters

      • workerNodeKey: number

        The worker node key.

        -

      Returns void

    Private sendTaskFunctionOperationToWorker

    Private sendTaskFunctionOperationToWorkers

    Protected Abstract sendToWorker

    • sendToWorker(workerNodeKey, message, transferList?): void

    • Sends a message to worker given its worker node key.

      +

    Returns void

    Private sendTaskFunctionOperationToWorker

    Private sendTaskFunctionOperationToWorkers

    Protected Abstract sendToWorker

    • sendToWorker(workerNodeKey, message, transferList?): void

    • Sends a message to worker given its worker node key.

      Parameters

      • workerNodeKey: number

        The worker node key.

      • message: MessageValue<Data, unknown>

        The message.

      • Optional transferList: readonly TransferListItem[]

        The optional array of transferable objects.

        -

      Returns void

    setDefaultTaskFunction

    Private setTaskStealing

    setTasksQueueOptions

    Private setTasksQueueSize

    Private setTasksStealingOnBackPressure

    setWorkerChoiceStrategy

    setWorkerChoiceStrategyOptions

    Protected setupHook

    • setupHook(): void

    • Setup hook to execute code before worker nodes are created in the abstract constructor. +

    Returns void

    setDefaultTaskFunction

    Private setTaskStealing

    setTasksQueueOptions

    Private setTasksQueueSize

    Private setTasksStealingOnBackPressure

    setWorkerChoiceStrategy

    setWorkerChoiceStrategyOptions

    Protected setupHook

    • setupHook(): void

    • Setup hook to execute code before worker nodes are created in the abstract constructor. Can be overridden.

      -

      Returns void

    Protected Abstract shallCreateDynamicWorker

    Protected Abstract shallCreateDynamicWorker

    • shallCreateDynamicWorker(): boolean

    • Conditions for dynamic worker creation.

      Returns boolean

      Whether to create a dynamic worker or not.

      -

    Private shallExecuteTask

    Private shallUpdateTaskFunctionWorkerUsage

    • shallUpdateTaskFunctionWorkerUsage(workerNodeKey): boolean

    • Whether the worker node shall update its task function worker usage or not.

      +

    Private shallExecuteTask

    Private shallUpdateTaskFunctionWorkerUsage

    • shallUpdateTaskFunctionWorkerUsage(workerNodeKey): boolean

    • Whether the worker node shall update its task function worker usage or not.

      Parameters

      • workerNodeKey: number

        The worker node key.

      Returns boolean

      true if the worker node shall update its task function worker usage, false otherwise.

      -

    start

    Private startMinimumNumberOfWorkers

    • startMinimumNumberOfWorkers(initWorkerNodeUsage?): void

    • Starts the minimum number of workers.

      -

      Parameters

      • initWorkerNodeUsage: boolean = false

      Returns void

    Private tasksQueueSize

    Private unsetTaskStealing

    Private unsetTasksStealingOnBackPressure

    Private updateTaskSequentiallyStolenStatisticsWorkerUsage

    • updateTaskSequentiallyStolenStatisticsWorkerUsage(workerNodeKey, taskName, previousTaskName?): void

    • Parameters

      • workerNodeKey: number
      • taskName: string
      • Optional previousTaskName: string

      Returns void

    Private updateTaskStolenStatisticsWorkerUsage

    • updateTaskStolenStatisticsWorkerUsage(workerNodeKey, taskName): void

    • Parameters

      • workerNodeKey: number
      • taskName: string

      Returns void

    Protected Readonly workerMessageListener

    Private Readonly workerNodeStealTask

    Settings

    Member Visibility

    Theme

    On This Page

    constructordestroyingemitterfilePathmaximumNumberOfWorkersminimumNumberOfWorkersoptspromiseResponseMapreadyEventEmittedstartTimestampstartedstartingstartingMinimumNumberOfWorkerstaskFunctionsworkerChoiceStrategiesContextworkerNodesbusyemptyfullinforeadytypeutilizationworkeraddTaskFunctionaddWorkerNodeafterTaskExecutionHookafterWorkerNodeSetupbeforeTaskExecutionHookbuildTasksQueueOptionscannotStealTaskcheckAndEmitDynamicWorkerCreationEventscheckAndEmitEmptyEventcheckAndEmitReadyEventcheckAndEmitTaskExecutionEventscheckAndEmitTaskQueuingEventscheckMessageWorkerIdcheckMinimumNumberOfWorkerscheckPoolOptionscheckPoolTypecheckValidWorkerChoiceStrategyOptionschooseWorkerNodecreateAndSetupDynamicWorkerNodecreateAndSetupWorkerNodecreateWorkerNodedequeueTaskderegisterWorkerMessageListenerdestroydestroyWorkerNodeenableTasksQueueenqueueTaskexecuteexecuteTaskflagWorkerNodeAsNotReadyflushTasksQueueflushTasksQueuesgetTaskFunctionWorkerChoiceStrategygetWorkerChoiceStrategiesgetWorkerInfogetWorkerNodeKeyByWorkerIdgetWorkerNodeTaskFunctionPrioritygetWorkerNodeTaskFunctionWorkerChoiceStrategyhandleTaskhandleTaskExecutionResponsehandleWorkerNodeBackPressureEventhandleWorkerNodeIdleEventhandleWorkerReadyResponsehasBackPressurehasTaskFunctioninitEventEmitterinitWorkerNodeUsageinternalBusyisMainisWorkerNodeBusylistTaskFunctionsPropertiesredistributeQueuedTasksregisterOnceWorkerMessageListenerregisterWorkerMessageListenerremoveTaskFunctionremoveWorkerNoderesetTaskSequentiallyStolenStatisticsWorkerUsagesendKillMessageToWorkersendStartupMessageToWorkersendStatisticsMessageToWorkersendTaskFunctionOperationToWorkersendTaskFunctionOperationToWorkerssendToWorkersetDefaultTaskFunctionsetTaskStealingsetTasksQueueOptionssetTasksQueueSizesetTasksStealingOnBackPressuresetWorkerChoiceStrategysetWorkerChoiceStrategyOptionssetupHookshallCreateDynamicWorkershallExecuteTaskshallUpdateTaskFunctionWorkerUsagestartstartMinimumNumberOfWorkerstasksQueueSizeunsetTaskStealingunsetTasksStealingOnBackPressureupdateTaskSequentiallyStolenStatisticsWorkerUsageupdateTaskStolenStatisticsWorkerUsageworkerMessageListenerworkerNodeStealTask
    \ No newline at end of file +

    start

    Private startMinimumNumberOfWorkers

    • startMinimumNumberOfWorkers(initWorkerNodeUsage?): void

    • Starts the minimum number of workers.

      +

      Parameters

      • initWorkerNodeUsage: boolean = false

      Returns void

    Private tasksQueueSize

    Private unsetTaskStealing

    Private unsetTasksStealingOnBackPressure

    Private updateTaskSequentiallyStolenStatisticsWorkerUsage

    • updateTaskSequentiallyStolenStatisticsWorkerUsage(workerNodeKey, taskName, previousTaskName?): void

    • Parameters

      • workerNodeKey: number
      • taskName: string
      • Optional previousTaskName: string

      Returns void

    Private updateTaskStolenStatisticsWorkerUsage

    • updateTaskStolenStatisticsWorkerUsage(workerNodeKey, taskName): void

    • Parameters

      • workerNodeKey: number
      • taskName: string

      Returns void

    Protected Readonly workerMessageListener

    Private Readonly workerNodeStealTask

    Settings

    Member Visibility

    Theme

    On This Page

    constructordestroyingemitterfilePathmaximumNumberOfWorkersminimumNumberOfWorkersoptspromiseResponseMapreadyEventEmittedstartTimestampstartedstartingstartingMinimumNumberOfWorkerstaskFunctionsworkerChoiceStrategiesContextworkerNodesbusyemptyfullinforeadytypeutilizationworkeraddTaskFunctionaddWorkerNodeafterTaskExecutionHookafterWorkerNodeSetupbeforeTaskExecutionHookbuildTasksQueueOptionscannotStealTaskcheckAndEmitDynamicWorkerCreationEventscheckAndEmitEmptyEventcheckAndEmitReadyEventcheckAndEmitTaskExecutionEventscheckAndEmitTaskQueuingEventscheckMessageWorkerIdcheckMinimumNumberOfWorkerscheckPoolOptionscheckPoolTypecheckValidWorkerChoiceStrategyOptionschooseWorkerNodecreateAndSetupDynamicWorkerNodecreateAndSetupWorkerNodecreateWorkerNodedequeueTaskderegisterWorkerMessageListenerdestroydestroyWorkerNodeenableTasksQueueenqueueTaskexecuteexecuteTaskflagWorkerNodeAsNotReadyflushTasksQueueflushTasksQueuesgetTaskFunctionWorkerChoiceStrategygetWorkerChoiceStrategiesgetWorkerInfogetWorkerNodeKeyByWorkerIdgetWorkerNodeTaskFunctionPrioritygetWorkerNodeTaskFunctionWorkerChoiceStrategyhandleTaskhandleTaskExecutionResponsehandleWorkerNodeBackPressureEventhandleWorkerNodeIdleEventhandleWorkerReadyResponsehasBackPressurehasTaskFunctioninitEventEmitterinitWorkerNodeUsageinternalBusyisMainisWorkerNodeBusylistTaskFunctionsPropertiesredistributeQueuedTasksregisterOnceWorkerMessageListenerregisterWorkerMessageListenerremoveTaskFunctionremoveWorkerNoderesetTaskSequentiallyStolenStatisticsWorkerUsagesendKillMessageToWorkersendStartupMessageToWorkersendStatisticsMessageToWorkersendTaskFunctionOperationToWorkersendTaskFunctionOperationToWorkerssendToWorkersetDefaultTaskFunctionsetTaskStealingsetTasksQueueOptionssetTasksQueueSizesetTasksStealingOnBackPressuresetWorkerChoiceStrategysetWorkerChoiceStrategyOptionssetupHookshallCreateDynamicWorkershallExecuteTaskshallUpdateTaskFunctionWorkerUsagestartstartMinimumNumberOfWorkerstasksQueueSizeunsetTaskStealingunsetTasksStealingOnBackPressureupdateTaskSequentiallyStolenStatisticsWorkerUsageupdateTaskStolenStatisticsWorkerUsageworkerMessageListenerworkerNodeStealTask
    \ No newline at end of file diff --git a/docs/classes/AbstractWorker.html b/docs/classes/AbstractWorker.html index 930d4484..ace39ab4 100644 --- a/docs/classes/AbstractWorker.html +++ b/docs/classes/AbstractWorker.html @@ -1,8 +1,8 @@ -AbstractWorker | poolifier - v4.0.11

    Class AbstractWorker<MainWorker, Data, Response>Abstract

    Base class that implements some shared logic for all poolifier workers.

    +AbstractWorker | poolifier - v4.0.12

    Class AbstractWorker<MainWorker, Data, Response>Abstract

    Base class that implements some shared logic for all poolifier workers.

    Type Parameters

    • MainWorker extends Worker | MessagePort

      Type of main worker.

    • Data = unknown

      Type of data this worker receives from pool's execution. This can only be structured-cloneable data.

    • Response = unknown

      Type of response the worker sends back to the main worker. This can only be structured-cloneable data.

      -

    Hierarchy (view full)

    Constructors

    constructor +

    Hierarchy (view full)

    Constructors

    constructor

    Properties

    activeInterval? id isMain @@ -41,58 +41,58 @@
  • mainWorker: undefined | null | MainWorker

    Reference to main worker.

  • taskFunctions: TaskFunction<Data, Response> | TaskFunctions<Data, Response>

    Task function(s) processed by the worker when the pool's execution function is invoked. The first function is the default function.

  • opts: WorkerOptions = DEFAULT_WORKER_OPTIONS

    Options for the worker.

    -

    • Returns AbstractWorker<MainWorker, Data, Response>

    Properties

    Protected Optional activeInterval

    activeInterval?: Timeout

    Handler id of the activeInterval worker activity check.

    -

    Protected Abstract id

    id: number

    Worker id.

    -

    Protected Readonly isMain

    isMain: undefined | boolean

    Whether this is the main worker or not.

    -

    Protected lastTaskTimestamp

    lastTaskTimestamp: number

    Timestamp of the last task processed by this worker.

    -

    Private Readonly mainWorker

    mainWorker: undefined | null | MainWorker

    Reference to main worker.

    -

    Protected opts

    opts: WorkerOptions = DEFAULT_WORKER_OPTIONS

    Options for the worker.

    -

    Protected Optional statistics

    statistics?: WorkerStatistics

    Performance statistics computation requirements.

    -

    Protected taskFunctions

    taskFunctions: Map<string, TaskFunctionObject<Data, Response>>

    Task function object(s) processed by the worker when the pool's execution function is invoked.

    -

    Methods

    addTaskFunction

    Returns AbstractWorker<MainWorker, Data, Response>

    Properties

    Protected Optional activeInterval

    activeInterval?: Timeout

    Handler id of the activeInterval worker activity check.

    +

    Protected Abstract id

    id: number

    Worker id.

    +

    Protected Readonly isMain

    isMain: undefined | boolean

    Whether this is the main worker or not.

    +

    Protected lastTaskTimestamp

    lastTaskTimestamp: number

    Timestamp of the last task processed by this worker.

    +

    Private Readonly mainWorker

    mainWorker: undefined | null | MainWorker

    Reference to main worker.

    +

    Protected opts

    opts: WorkerOptions = DEFAULT_WORKER_OPTIONS

    Options for the worker.

    +

    Protected Optional statistics

    statistics?: WorkerStatistics

    Performance statistics computation requirements.

    +

    Protected taskFunctions

    taskFunctions: Map<string, TaskFunctionObject<Data, Response>>

    Task function object(s) processed by the worker when the pool's execution function is invoked.

    +

    Methods

    addTaskFunction

    Private beginTaskPerformance

    Private checkActive

    Private checkMessageWorkerId

    Private beginTaskPerformance

    Private checkActive

    Private checkMessageWorkerId

    Private checkTaskFunctions

    Private checkTaskFunctions

    Private checkWorkerOptions

    Private endTaskPerformance

    Protected getMainWorker

    • getMainWorker(): MainWorker

    • Returns the main worker.

      +

    Returns void

    Private checkWorkerOptions

    Private endTaskPerformance

    Protected getMainWorker

    Protected handleError

    Protected handleError

    • handleError(error): string

    • Handles an error and convert it to a string so it can be sent back to the main worker.

      Parameters

      • error: string | Error

        The error raised by the worker.

      Returns string

      The error message.

      -

    Protected handleKillMessage

    Protected Abstract handleReadyMessage

    Protected handleKillMessage

    Protected Abstract handleReadyMessage

    Protected handleTaskFunctionOperationMessage

    hasTaskFunction

    Returns void

    Protected handleTaskFunctionOperationMessage

    hasTaskFunction

    listTaskFunctionsProperties

    listTaskFunctionsProperties

    Protected messageListener

    Protected messageListener

    removeTaskFunction

    Returns void

    removeTaskFunction

    Protected Readonly run

    Protected Readonly run

    Protected Readonly runAsync

    • runAsync(fn, task): void

    • Runs the given task function asynchronously.

      +

    Returns void

    Protected Readonly runAsync

    Protected Readonly runSync

    • runSync(fn, task): void

    • Runs the given task function synchronously.

      +

    Returns void

    Protected Readonly runSync

    Protected sendTaskFunctionsPropertiesToMainWorker

    Protected Abstract sendToMainWorker

    • sendToMainWorker(message): void

    • Sends a message to main worker.

      +

    Returns void

    Protected sendTaskFunctionsPropertiesToMainWorker

    Protected Abstract sendToMainWorker

    setDefaultTaskFunction

    Returns void

    setDefaultTaskFunction

    Private startCheckActive

    Private stopCheckActive

    Private updateLastTaskTimestamp

    Settings

    Member Visibility

    Theme

    On This Page

    constructoractiveIntervalidisMainlastTaskTimestampmainWorkeroptsstatisticstaskFunctionsaddTaskFunctionbeginTaskPerformancecheckActivecheckMessageWorkerIdcheckTaskFunctionscheckWorkerOptionsendTaskPerformancegetMainWorkerhandleErrorhandleKillMessagehandleReadyMessagehandleTaskFunctionOperationMessagehasTaskFunctionlistTaskFunctionsPropertiesmessageListenerremoveTaskFunctionrunrunAsyncrunSyncsendTaskFunctionsPropertiesToMainWorkersendToMainWorkersetDefaultTaskFunctionstartCheckActivestopCheckActiveupdateLastTaskTimestamp
    \ No newline at end of file +

    Private startCheckActive

    Private stopCheckActive

    Private updateLastTaskTimestamp

    Settings

    Member Visibility

    Theme

    On This Page

    constructoractiveIntervalidisMainlastTaskTimestampmainWorkeroptsstatisticstaskFunctionsaddTaskFunctionbeginTaskPerformancecheckActivecheckMessageWorkerIdcheckTaskFunctionscheckWorkerOptionsendTaskPerformancegetMainWorkerhandleErrorhandleKillMessagehandleReadyMessagehandleTaskFunctionOperationMessagehasTaskFunctionlistTaskFunctionsPropertiesmessageListenerremoveTaskFunctionrunrunAsyncrunSyncsendTaskFunctionsPropertiesToMainWorkersendToMainWorkersetDefaultTaskFunctionstartCheckActivestopCheckActiveupdateLastTaskTimestamp
    \ No newline at end of file diff --git a/docs/classes/CircularBuffer.html b/docs/classes/CircularBuffer.html index 5cda4cf5..a9113443 100644 --- a/docs/classes/CircularBuffer.html +++ b/docs/classes/CircularBuffer.html @@ -1,16 +1,28 @@ -CircularBuffer | poolifier - v4.0.11

    Class CircularBuffer<T>

    Circular buffer

    -

    Type Parameters

    • T

    Constructors

    constructor +CircularBuffer | poolifier - v4.0.12

    Class CircularBufferInternal

    Circular buffer designed for positive numbers.

    +

    Constructors

    constructor

    Properties

    items maxArrayIdx readIdx +size writeIdx

    Methods

    checkSize +empty +full +get put toArray -

    Constructors

    constructor

    Properties

    Private items

    items: (undefined | T)[]

    Private Readonly maxArrayIdx

    maxArrayIdx: number

    Private Readonly readIdx

    readIdx: number

    Private writeIdx

    writeIdx: number

    Methods

    Private checkSize

    put

    toArray

    Settings

    Member Visibility

    Theme

    On This Page

    constructoritemsmaxArrayIdxreadIdxwriteIdxcheckSizeputtoArray
    \ No newline at end of file +

    Constructors

    constructor

    Properties

    Private items

    items: Float32Array

    Private Readonly maxArrayIdx

    maxArrayIdx: number

    Private readIdx

    readIdx: number

    size

    size: number

    Private writeIdx

    writeIdx: number

    Methods

    Private checkSize

    empty

    • empty(): boolean

    • Checks whether the buffer is empty.

      +

      Returns boolean

      Whether the buffer is empty.

      +

    full

    • full(): boolean

    • Checks whether the buffer is full.

      +

      Returns boolean

      Whether the buffer is full.

      +

    get

    • get(): undefined | number

    • Gets number from buffer.

      +

      Returns undefined | number

      Number from buffer.

      +

    put

    • put(number): void

    • Puts number into buffer.

      +

      Parameters

      • number: number

        Number to put into buffer.

        +

      Returns void

    toArray

    Settings

    Member Visibility

    Theme

    On This Page

    constructoritemsmaxArrayIdxreadIdxsizewriteIdxcheckSizeemptyfullgetputtoArray
    \ No newline at end of file diff --git a/docs/classes/ClusterWorker.html b/docs/classes/ClusterWorker.html index 35c001da..50ca9f7f 100644 --- a/docs/classes/ClusterWorker.html +++ b/docs/classes/ClusterWorker.html @@ -1,4 +1,4 @@ -ClusterWorker | poolifier - v4.0.11

    Class ClusterWorker<Data, Response>

    A cluster worker used by a poolifier ClusterPool.

    +ClusterWorker | poolifier - v4.0.12

    Class ClusterWorker<Data, Response>

    A cluster worker used by a poolifier ClusterPool.

    When this worker is inactive for more than the given maxInactiveTime, it will send a termination request to its main worker.

    If you use a DynamicClusterPool the extra workers that were created will be terminated, @@ -7,7 +7,7 @@ but the minimum number of workers will be guaranteed.

    Since

    2.0.0

    Type Parameters

    • Data = unknown

      Type of data this worker receives from pool's execution. This can only be structured-cloneable data.

    • Response = unknown

      Type of response the worker sends back to the main worker. This can only be structured-cloneable data.

      -

    Hierarchy (view full)

    Constructors

    constructor +

    Hierarchy (view full)

    Constructors

    constructor

    Properties

    activeInterval? isMain lastTaskTimestamp @@ -34,49 +34,49 @@ but the minimum number of workers will be guaranteed.

    Constructors

    constructor

    Properties

    Protected Optional activeInterval

    activeInterval?: Timeout

    Handler id of the activeInterval worker activity check.

    -

    Protected Readonly isMain

    isMain: undefined | boolean

    Whether this is the main worker or not.

    -

    Protected lastTaskTimestamp

    lastTaskTimestamp: number

    Timestamp of the last task processed by this worker.

    -

    Protected opts

    opts: WorkerOptions = DEFAULT_WORKER_OPTIONS

    Options for the worker.

    -

    Protected Optional statistics

    statistics?: WorkerStatistics

    Performance statistics computation requirements.

    -

    Protected taskFunctions

    taskFunctions: Map<string, TaskFunctionObject<Data, Response>>

    Task function object(s) processed by the worker when the pool's execution function is invoked.

    -

    Accessors

    Protected id

    Methods

    addTaskFunction

    Returns ClusterWorker<Data, Response>

    Properties

    Protected Optional activeInterval

    activeInterval?: Timeout

    Handler id of the activeInterval worker activity check.

    +

    Protected Readonly isMain

    isMain: undefined | boolean

    Whether this is the main worker or not.

    +

    Protected lastTaskTimestamp

    lastTaskTimestamp: number

    Timestamp of the last task processed by this worker.

    +

    Protected opts

    opts: WorkerOptions = DEFAULT_WORKER_OPTIONS

    Options for the worker.

    +

    Protected Optional statistics

    statistics?: WorkerStatistics

    Performance statistics computation requirements.

    +

    Protected taskFunctions

    taskFunctions: Map<string, TaskFunctionObject<Data, Response>>

    Task function object(s) processed by the worker when the pool's execution function is invoked.

    +

    Accessors

    Protected id

    Methods

    addTaskFunction

    Protected getMainWorker

    Protected getMainWorker

    Protected handleError

    Protected handleError

    • handleError(error): string

    • Handles an error and convert it to a string so it can be sent back to the main worker.

      Parameters

      • error: string | Error

        The error raised by the worker.

      Returns string

      The error message.

      -

    Protected handleKillMessage

    Protected handleReadyMessage

    Protected handleKillMessage

    Protected handleReadyMessage

    Protected handleTaskFunctionOperationMessage

    hasTaskFunction

    Returns void

    Protected handleTaskFunctionOperationMessage

    hasTaskFunction

    listTaskFunctionsProperties

    listTaskFunctionsProperties

    Protected messageListener

    Protected messageListener

    removeTaskFunction

    Returns void

    removeTaskFunction

    Protected Readonly run

    Protected Readonly run

    Protected Readonly runAsync

    • runAsync(fn, task): void

    • Runs the given task function asynchronously.

      +

    Returns void

    Protected Readonly runAsync

    Protected Readonly runSync

    • runSync(fn, task): void

    • Runs the given task function synchronously.

      +

    Returns void

    Protected Readonly runSync

    Protected sendTaskFunctionsPropertiesToMainWorker

    Protected Readonly sendToMainWorker

    • sendToMainWorker(message): void

    • Sends a message to main worker.

      +

    Returns void

    Protected sendTaskFunctionsPropertiesToMainWorker

    Protected Readonly sendToMainWorker

    setDefaultTaskFunction

    Returns void

    setDefaultTaskFunction

    Settings

    Member Visibility

    Theme

    On This Page

    constructoractiveIntervalisMainlastTaskTimestampoptsstatisticstaskFunctionsidaddTaskFunctiongetMainWorkerhandleErrorhandleKillMessagehandleReadyMessagehandleTaskFunctionOperationMessagehasTaskFunctionlistTaskFunctionsPropertiesmessageListenerremoveTaskFunctionrunrunAsyncrunSyncsendTaskFunctionsPropertiesToMainWorkersendToMainWorkersetDefaultTaskFunction
    \ No newline at end of file +

    Settings

    Member Visibility

    Theme

    On This Page

    constructoractiveIntervalisMainlastTaskTimestampoptsstatisticstaskFunctionsidaddTaskFunctiongetMainWorkerhandleErrorhandleKillMessagehandleReadyMessagehandleTaskFunctionOperationMessagehasTaskFunctionlistTaskFunctionsPropertiesmessageListenerremoveTaskFunctionrunrunAsyncrunSyncsendTaskFunctionsPropertiesToMainWorkersendToMainWorkersetDefaultTaskFunction
    \ No newline at end of file diff --git a/docs/classes/DynamicClusterPool.html b/docs/classes/DynamicClusterPool.html index 3149c487..6eb7c4ff 100644 --- a/docs/classes/DynamicClusterPool.html +++ b/docs/classes/DynamicClusterPool.html @@ -1,11 +1,11 @@ -DynamicClusterPool | poolifier - v4.0.11

    Class DynamicClusterPool<Data, Response>

    A cluster pool with a dynamic number of workers, but a guaranteed minimum number of workers.

    +DynamicClusterPool | poolifier - v4.0.12

    Class DynamicClusterPool<Data, Response>

    A cluster pool with a dynamic number of workers, but a guaranteed minimum number of workers.

    This cluster pool creates new workers when the others are busy, up to the maximum number of workers. When the maximum number of workers is reached and workers are busy, an event is emitted. If you want to listen to this event, use the pool's emitter.

    Author

    Christopher Quadflieg

    Since

    2.0.0

    Type Parameters

    • Data = unknown

      Type of data sent to the worker. This can only be structured-cloneable data.

    • Response = unknown

      Type of execution response. This can only be structured-cloneable data.

      -

    Hierarchy (view full)

    Constructors

    constructor +

    Hierarchy (view full)

    Constructors

    constructor

    Properties

    emitter? filePath maximumNumberOfWorkers? @@ -59,7 +59,7 @@ When the maximum number of workers is reached and workers are busy, an event is
  • max: number

    Maximum number of workers that can be created by this pool.

  • filePath: string

    Path to an implementation of a ClusterWorker file, which can be relative or absolute.

  • opts: ClusterPoolOptions = {}

    Options for this dynamic cluster pool.

    -

    • Returns DynamicClusterPool<Data, Response>

    Properties

    Optional emitter

    emitter?: EventEmitterAsyncResource

    Pool event emitter integrated with async resource. +

    Returns DynamicClusterPool<Data, Response>

    Properties

    Optional emitter

    emitter?: EventEmitterAsyncResource

    Pool event emitter integrated with async resource. The async tracking tooling identifier is poolifier:<PoolType>-<WorkerType>-pool.

    Events that can currently be listened to:

      @@ -72,72 +72,72 @@ The async tracking tooling identifier is poolifier:<PoolType>-<Wo
    • 'taskError': Emitted when an error occurs while executing a task.
    • 'backPressure': Emitted when all worker nodes have back pressure (i.e. their tasks queue is full: queue size >= maximum queue size).
    -

    Protected Readonly filePath

    filePath: string

    Path to the worker file.

    -

    Protected Optional Readonly maximumNumberOfWorkers

    maximumNumberOfWorkers?: number

    Maximum number of workers that this pool manages.

    -

    Protected Readonly minimumNumberOfWorkers

    minimumNumberOfWorkers: number

    Minimum number of workers that this pool manages.

    -

    Protected Readonly opts

    opts: PoolOptions<Worker>

    Options for the pool.

    -

    Protected promiseResponseMap

    promiseResponseMap: Map<`${string}-${string}-${string}-${string}-${string}`, PromiseResponseWrapper<Response>> = ...

    The task execution response promise map:

    +

    Protected Readonly filePath

    filePath: string

    Path to the worker file.

    +

    Protected Optional Readonly maximumNumberOfWorkers

    maximumNumberOfWorkers?: number

    Maximum number of workers that this pool manages.

    +

    Protected Readonly minimumNumberOfWorkers

    minimumNumberOfWorkers: number

    Minimum number of workers that this pool manages.

    +

    Protected Readonly opts

    opts: PoolOptions<Worker>

    Options for the pool.

    +

    Protected promiseResponseMap

    promiseResponseMap: Map<`${string}-${string}-${string}-${string}-${string}`, PromiseResponseWrapper<Response>> = ...

    The task execution response promise map:

    • key: The message id of each submitted task.
    • value: An object that contains task's worker node key, execution response promise resolve and reject callbacks, async resource.

    When we receive a message from the worker, we get a map entry with the promise resolve/reject bound to the message id.

    -

    Protected Optional workerChoiceStrategiesContext

    workerChoiceStrategiesContext?: WorkerChoiceStrategiesContext<Worker, Data, Response>

    Worker choice strategies context referencing worker choice algorithms implementation.

    -

    Readonly Internal workerNodes

    workerNodes: IWorkerNode<Worker, Data>[] = []

    Pool worker nodes.

    -

    Accessors

    Protected busy

    Protected Optional workerChoiceStrategiesContext

    workerChoiceStrategiesContext?: WorkerChoiceStrategiesContext<Worker, Data, Response>

    Worker choice strategies context referencing worker choice algorithms implementation.

    +

    Readonly Internal workerNodes

    workerNodes: IWorkerNode<Worker, Data>[] = []

    Pool worker nodes.

    +

    Accessors

    Protected busy

    • get busy(): boolean

    • Whether the pool is busy or not.

      The pool busyness boolean status.

      -

      Returns boolean

    Protected empty

    Protected full

    Protected empty

    Protected full

    • get full(): boolean

    • Whether the pool is full or not.

      The pool filling boolean status.

      -

      Returns boolean

    info

    Private ready

    Protected type

    info

    Private ready

    Protected type

    • get type(): "fixed" | "dynamic"

    • The pool type.

      If it is 'dynamic', it provides the max property.

      -

      Returns "fixed" | "dynamic"

    Private utilization

    • get utilization(): number

    • The approximate pool utilization.

      +

      Returns "fixed" | "dynamic"

    Private utilization

    • get utilization(): number

    • The approximate pool utilization.

      Returns number

      The pool utilization.

      -

    Protected worker

    • get worker(): "thread" | "cluster"

    • The worker type.

      -

      Returns "thread" | "cluster"

    Methods

    addTaskFunction

    Protected afterTaskExecutionHook

    • afterTaskExecutionHook(workerNodeKey, message): void

    • Hook executed after the worker task execution. +

    Protected worker

    • get worker(): "thread" | "cluster"

    • The worker type.

      +

      Returns "thread" | "cluster"

    Methods

    addTaskFunction

    Protected afterTaskExecutionHook

    Protected afterWorkerNodeSetup

    • afterWorkerNodeSetup(workerNodeKey): void

    • Method hooked up after a worker node has been newly created. +

    Returns void

    Protected afterWorkerNodeSetup

    Protected beforeTaskExecutionHook

    • beforeTaskExecutionHook(workerNodeKey, task): void

    • Hook executed before the worker task execution. +

    Returns void

    Protected beforeTaskExecutionHook

    Protected checkAndEmitDynamicWorkerCreationEvents

    Protected createAndSetupDynamicWorkerNode

    • createAndSetupDynamicWorkerNode(): number

    • Creates a new, completely set up dynamic worker node.

      +

    Returns void

    Protected checkAndEmitDynamicWorkerCreationEvents

    Protected createAndSetupDynamicWorkerNode

    Protected createAndSetupWorkerNode

    Protected createAndSetupWorkerNode

    Protected deregisterWorkerMessageListener

    Protected deregisterWorkerMessageListener

    destroy

    Protected destroyWorkerNode

    • destroyWorkerNode(workerNodeKey): Promise<void>

    • Terminates the worker node given its worker node key.

      +

    Returns void

    destroy

    Protected destroyWorkerNode

    enableTasksQueue

    execute

    Protected flagWorkerNodeAsNotReady

    Protected flushTasksQueue

    Protected getWorkerInfo

    • getWorkerInfo(workerNodeKey): undefined | WorkerInfo

    • Gets the worker information given its worker node key.

      +

    Returns Promise<void>

    enableTasksQueue

    execute

    Protected flagWorkerNodeAsNotReady

    Protected flushTasksQueue

    Protected getWorkerInfo

    hasTaskFunction

    Protected internalBusy

    hasTaskFunction

    Protected internalBusy

    Protected isMain

    Protected isMain

    listTaskFunctionsProperties

    Protected registerOnceWorkerMessageListener

    listTaskFunctionsProperties

    Protected registerOnceWorkerMessageListener

    Protected registerWorkerMessageListener

    • registerWorkerMessageListener<Message>(workerNodeKey, listener): void

    • Registers a listener callback on the worker given its worker node key.

      +

    Returns void

    Protected registerWorkerMessageListener

    removeTaskFunction

    Protected sendStartupMessageToWorker

    • sendStartupMessageToWorker(workerNodeKey): void

    • Sends the startup message to worker given its worker node key.

      +

    Returns void

    removeTaskFunction

    Protected sendStartupMessageToWorker

    Protected sendToWorker

    • sendToWorker(workerNodeKey, message): void

    • Sends a message to worker given its worker node key.

      +

    Returns void

    Protected sendToWorker

    setDefaultTaskFunction

    setTasksQueueOptions

    setWorkerChoiceStrategy

    setWorkerChoiceStrategyOptions

    Protected setupHook

    • setupHook(): void

    • Setup hook to execute code before worker nodes are created in the abstract constructor. +

    Returns void

    setDefaultTaskFunction

    setTasksQueueOptions

    setWorkerChoiceStrategy

    setWorkerChoiceStrategyOptions

    Protected setupHook

    Protected shallCreateDynamicWorker

    Protected shallCreateDynamicWorker

    start

    Protected Readonly workerMessageListener

    Settings

    Member Visibility

    Theme

    On This Page

    constructoremitterfilePathmaximumNumberOfWorkersminimumNumberOfWorkersoptspromiseResponseMapworkerChoiceStrategiesContextworkerNodesbusyemptyfullinforeadytypeutilizationworkeraddTaskFunctionafterTaskExecutionHookafterWorkerNodeSetupbeforeTaskExecutionHookcheckAndEmitDynamicWorkerCreationEventscreateAndSetupDynamicWorkerNodecreateAndSetupWorkerNodederegisterWorkerMessageListenerdestroydestroyWorkerNodeenableTasksQueueexecuteflagWorkerNodeAsNotReadyflushTasksQueuegetWorkerInfohasTaskFunctioninternalBusyisMainlistTaskFunctionsPropertiesregisterOnceWorkerMessageListenerregisterWorkerMessageListenerremoveTaskFunctionsendStartupMessageToWorkersendToWorkersetDefaultTaskFunctionsetTasksQueueOptionssetWorkerChoiceStrategysetWorkerChoiceStrategyOptionssetupHookshallCreateDynamicWorkerstartworkerMessageListener
    \ No newline at end of file +

    start

    Protected Readonly workerMessageListener

    Settings

    Member Visibility

    Theme

    On This Page

    constructoremitterfilePathmaximumNumberOfWorkersminimumNumberOfWorkersoptspromiseResponseMapworkerChoiceStrategiesContextworkerNodesbusyemptyfullinforeadytypeutilizationworkeraddTaskFunctionafterTaskExecutionHookafterWorkerNodeSetupbeforeTaskExecutionHookcheckAndEmitDynamicWorkerCreationEventscreateAndSetupDynamicWorkerNodecreateAndSetupWorkerNodederegisterWorkerMessageListenerdestroydestroyWorkerNodeenableTasksQueueexecuteflagWorkerNodeAsNotReadyflushTasksQueuegetWorkerInfohasTaskFunctioninternalBusyisMainlistTaskFunctionsPropertiesregisterOnceWorkerMessageListenerregisterWorkerMessageListenerremoveTaskFunctionsendStartupMessageToWorkersendToWorkersetDefaultTaskFunctionsetTasksQueueOptionssetWorkerChoiceStrategysetWorkerChoiceStrategyOptionssetupHookshallCreateDynamicWorkerstartworkerMessageListener
    \ No newline at end of file diff --git a/docs/classes/DynamicThreadPool.html b/docs/classes/DynamicThreadPool.html index fd6d3988..65b16ce6 100644 --- a/docs/classes/DynamicThreadPool.html +++ b/docs/classes/DynamicThreadPool.html @@ -1,11 +1,11 @@ -DynamicThreadPool | poolifier - v4.0.11

    Class DynamicThreadPool<Data, Response>

    A thread pool with a dynamic number of threads, but a guaranteed minimum number of threads.

    +DynamicThreadPool | poolifier - v4.0.12

    Class DynamicThreadPool<Data, Response>

    A thread pool with a dynamic number of threads, but a guaranteed minimum number of threads.

    This thread pool creates new threads when the others are busy, up to the maximum number of threads. When the maximum number of threads is reached and workers are busy, an event is emitted. If you want to listen to this event, use the pool's emitter.

    Author

    Alessandro Pio Ardizio

    Since

    0.0.1

    Type Parameters

    • Data = unknown

      Type of data sent to the worker. This can only be structured-cloneable data.

    • Response = unknown

      Type of execution response. This can only be structured-cloneable data.

      -

    Hierarchy (view full)

    Constructors

    constructor +

    Hierarchy (view full)

    Constructors

    constructor

    Properties

    emitter? filePath maximumNumberOfWorkers? @@ -59,7 +59,7 @@ When the maximum number of threads is reached and workers are busy, an event is
  • max: number

    Maximum number of threads that can be created by this pool.

  • filePath: string

    Path to an implementation of a ThreadWorker file, which can be relative or absolute.

  • opts: ThreadPoolOptions = {}

    Options for this dynamic thread pool.

    -

    • Returns DynamicThreadPool<Data, Response>

    Properties

    Optional emitter

    emitter?: EventEmitterAsyncResource

    Pool event emitter integrated with async resource. +

    Returns DynamicThreadPool<Data, Response>

    Properties

    Optional emitter

    emitter?: EventEmitterAsyncResource

    Pool event emitter integrated with async resource. The async tracking tooling identifier is poolifier:<PoolType>-<WorkerType>-pool.

    Events that can currently be listened to:

      @@ -72,73 +72,73 @@ The async tracking tooling identifier is poolifier:<PoolType>-<Wo
    • 'taskError': Emitted when an error occurs while executing a task.
    • 'backPressure': Emitted when all worker nodes have back pressure (i.e. their tasks queue is full: queue size >= maximum queue size).
    -

    Protected Readonly filePath

    filePath: string

    Path to the worker file.

    -

    Protected Optional Readonly maximumNumberOfWorkers

    maximumNumberOfWorkers?: number

    Maximum number of workers that this pool manages.

    -

    Protected Readonly minimumNumberOfWorkers

    minimumNumberOfWorkers: number

    Minimum number of workers that this pool manages.

    -

    Protected Readonly opts

    opts: PoolOptions<Worker>

    Options for the pool.

    -

    Protected promiseResponseMap

    promiseResponseMap: Map<`${string}-${string}-${string}-${string}-${string}`, PromiseResponseWrapper<Response>> = ...

    The task execution response promise map:

    +

    Protected Readonly filePath

    filePath: string

    Path to the worker file.

    +

    Protected Optional Readonly maximumNumberOfWorkers

    maximumNumberOfWorkers?: number

    Maximum number of workers that this pool manages.

    +

    Protected Readonly minimumNumberOfWorkers

    minimumNumberOfWorkers: number

    Minimum number of workers that this pool manages.

    +

    Protected Readonly opts

    opts: PoolOptions<Worker>

    Options for the pool.

    +

    Protected promiseResponseMap

    promiseResponseMap: Map<`${string}-${string}-${string}-${string}-${string}`, PromiseResponseWrapper<Response>> = ...

    The task execution response promise map:

    • key: The message id of each submitted task.
    • value: An object that contains task's worker node key, execution response promise resolve and reject callbacks, async resource.

    When we receive a message from the worker, we get a map entry with the promise resolve/reject bound to the message id.

    -

    Protected Optional workerChoiceStrategiesContext

    workerChoiceStrategiesContext?: WorkerChoiceStrategiesContext<Worker, Data, Response>

    Worker choice strategies context referencing worker choice algorithms implementation.

    -

    Readonly Internal workerNodes

    workerNodes: IWorkerNode<Worker, Data>[] = []

    Pool worker nodes.

    -

    Accessors

    Protected busy

    Protected Optional workerChoiceStrategiesContext

    workerChoiceStrategiesContext?: WorkerChoiceStrategiesContext<Worker, Data, Response>

    Worker choice strategies context referencing worker choice algorithms implementation.

    +

    Readonly Internal workerNodes

    workerNodes: IWorkerNode<Worker, Data>[] = []

    Pool worker nodes.

    +

    Accessors

    Protected busy

    • get busy(): boolean

    • Whether the pool is busy or not.

      The pool busyness boolean status.

      -

      Returns boolean

    Protected empty

    Protected full

    Protected empty

    Protected full

    • get full(): boolean

    • Whether the pool is full or not.

      The pool filling boolean status.

      -

      Returns boolean

    info

    Private ready

    Protected type

    info

    Private ready

    Protected type

    • get type(): "fixed" | "dynamic"

    • The pool type.

      If it is 'dynamic', it provides the max property.

      -

      Returns "fixed" | "dynamic"

    Private utilization

    • get utilization(): number

    • The approximate pool utilization.

      +

      Returns "fixed" | "dynamic"

    Private utilization

    • get utilization(): number

    • The approximate pool utilization.

      Returns number

      The pool utilization.

      -

    Protected worker

    • get worker(): "thread" | "cluster"

    • The worker type.

      -

      Returns "thread" | "cluster"

    Methods

    addTaskFunction

    Protected afterTaskExecutionHook

    • afterTaskExecutionHook(workerNodeKey, message): void

    • Hook executed after the worker task execution. +

    Protected worker

    • get worker(): "thread" | "cluster"

    • The worker type.

      +

      Returns "thread" | "cluster"

    Methods

    addTaskFunction

    Protected afterTaskExecutionHook

    Protected afterWorkerNodeSetup

    • afterWorkerNodeSetup(workerNodeKey): void

    • Method hooked up after a worker node has been newly created. +

    Returns void

    Protected afterWorkerNodeSetup

    Protected beforeTaskExecutionHook

    • beforeTaskExecutionHook(workerNodeKey, task): void

    • Hook executed before the worker task execution. +

    Returns void

    Protected beforeTaskExecutionHook

    Protected checkAndEmitDynamicWorkerCreationEvents

    Protected createAndSetupDynamicWorkerNode

    • createAndSetupDynamicWorkerNode(): number

    • Creates a new, completely set up dynamic worker node.

      +

    Returns void

    Protected checkAndEmitDynamicWorkerCreationEvents

    Protected createAndSetupDynamicWorkerNode

    Protected createAndSetupWorkerNode

    Protected createAndSetupWorkerNode

    Protected deregisterWorkerMessageListener

    Protected deregisterWorkerMessageListener

    destroy

    Protected destroyWorkerNode

    • destroyWorkerNode(workerNodeKey): Promise<void>

    • Terminates the worker node given its worker node key.

      +

    Returns void

    destroy

    Protected destroyWorkerNode

    enableTasksQueue

    execute

    Protected flagWorkerNodeAsNotReady

    Protected flushTasksQueue

    Protected getWorkerInfo

    • getWorkerInfo(workerNodeKey): undefined | WorkerInfo

    • Gets the worker information given its worker node key.

      +

    Returns Promise<void>

    enableTasksQueue

    execute

    Protected flagWorkerNodeAsNotReady

    Protected flushTasksQueue

    Protected getWorkerInfo

    hasTaskFunction

    Protected internalBusy

    hasTaskFunction

    Protected internalBusy

    Protected isMain

    Protected isMain

    listTaskFunctionsProperties

    Protected registerOnceWorkerMessageListener

    listTaskFunctionsProperties

    Protected registerOnceWorkerMessageListener

    Protected registerWorkerMessageListener

    • registerWorkerMessageListener<Message>(workerNodeKey, listener): void

    • Registers a listener callback on the worker given its worker node key.

      +

    Returns void

    Protected registerWorkerMessageListener

    removeTaskFunction

    Protected sendStartupMessageToWorker

    • sendStartupMessageToWorker(workerNodeKey): void

    • Sends the startup message to worker given its worker node key.

      +

    Returns void

    removeTaskFunction

    Protected sendStartupMessageToWorker

    Protected sendToWorker

    • sendToWorker(workerNodeKey, message, transferList?): void

    • Sends a message to worker given its worker node key.

      +

    Returns void

    Protected sendToWorker

    • sendToWorker(workerNodeKey, message, transferList?): void

    • Sends a message to worker given its worker node key.

      Parameters

      • workerNodeKey: number

        The worker node key.

      • message: MessageValue<Data, unknown>

        The message.

      • Optional transferList: readonly TransferListItem[]

        The optional array of transferable objects.

        -

      Returns void

    setDefaultTaskFunction

    setTasksQueueOptions

    setWorkerChoiceStrategy

    setWorkerChoiceStrategyOptions

    Protected setupHook

    • setupHook(): void

    • Setup hook to execute code before worker nodes are created in the abstract constructor. +

    Returns void

    setDefaultTaskFunction

    setTasksQueueOptions

    setWorkerChoiceStrategy

    setWorkerChoiceStrategyOptions

    Protected setupHook

    Protected shallCreateDynamicWorker

    Protected shallCreateDynamicWorker

    start

    Protected Readonly workerMessageListener

    Settings

    Member Visibility

    Theme

    On This Page

    constructoremitterfilePathmaximumNumberOfWorkersminimumNumberOfWorkersoptspromiseResponseMapworkerChoiceStrategiesContextworkerNodesbusyemptyfullinforeadytypeutilizationworkeraddTaskFunctionafterTaskExecutionHookafterWorkerNodeSetupbeforeTaskExecutionHookcheckAndEmitDynamicWorkerCreationEventscreateAndSetupDynamicWorkerNodecreateAndSetupWorkerNodederegisterWorkerMessageListenerdestroydestroyWorkerNodeenableTasksQueueexecuteflagWorkerNodeAsNotReadyflushTasksQueuegetWorkerInfohasTaskFunctioninternalBusyisMainlistTaskFunctionsPropertiesregisterOnceWorkerMessageListenerregisterWorkerMessageListenerremoveTaskFunctionsendStartupMessageToWorkersendToWorkersetDefaultTaskFunctionsetTasksQueueOptionssetWorkerChoiceStrategysetWorkerChoiceStrategyOptionssetupHookshallCreateDynamicWorkerstartworkerMessageListener
    \ No newline at end of file +

    start

    Protected Readonly workerMessageListener

    Settings

    Member Visibility

    Theme

    On This Page

    constructoremitterfilePathmaximumNumberOfWorkersminimumNumberOfWorkersoptspromiseResponseMapworkerChoiceStrategiesContextworkerNodesbusyemptyfullinforeadytypeutilizationworkeraddTaskFunctionafterTaskExecutionHookafterWorkerNodeSetupbeforeTaskExecutionHookcheckAndEmitDynamicWorkerCreationEventscreateAndSetupDynamicWorkerNodecreateAndSetupWorkerNodederegisterWorkerMessageListenerdestroydestroyWorkerNodeenableTasksQueueexecuteflagWorkerNodeAsNotReadyflushTasksQueuegetWorkerInfohasTaskFunctioninternalBusyisMainlistTaskFunctionsPropertiesregisterOnceWorkerMessageListenerregisterWorkerMessageListenerremoveTaskFunctionsendStartupMessageToWorkersendToWorkersetDefaultTaskFunctionsetTasksQueueOptionssetWorkerChoiceStrategysetWorkerChoiceStrategyOptionssetupHookshallCreateDynamicWorkerstartworkerMessageListener
    \ No newline at end of file diff --git a/docs/classes/FixedClusterPool.html b/docs/classes/FixedClusterPool.html index 7db2df4b..12518c57 100644 --- a/docs/classes/FixedClusterPool.html +++ b/docs/classes/FixedClusterPool.html @@ -1,9 +1,9 @@ -FixedClusterPool | poolifier - v4.0.11

    Class FixedClusterPool<Data, Response>

    A cluster pool with a fixed number of workers.

    +FixedClusterPool | poolifier - v4.0.12

    Class FixedClusterPool<Data, Response>

    A cluster pool with a fixed number of workers.

    Author

    Christopher Quadflieg

    Since

    2.0.0

    Type Parameters

    • Data = unknown

      Type of data sent to the worker. This can only be structured-cloneable data.

    • Response = unknown

      Type of execution response. This can only be structured-cloneable data.

      -

    Hierarchy (view full)

    Constructors

    constructor +

    Hierarchy (view full)

    Constructors

    constructor

    Properties

    emitter? filePath maximumNumberOfWorkers? @@ -56,7 +56,7 @@

    Type Parameters

    • Data = unknown
    • Response = unknown

    Parameters

    • numberOfWorkers: number

      Number of workers for this pool.

    • filePath: string

      Path to an implementation of a ClusterWorker file, which can be relative or absolute.

    • opts: ClusterPoolOptions = {}

      Options for this fixed cluster pool.

      -
    • Optional maximumNumberOfWorkers: number

    Returns FixedClusterPool<Data, Response>

    Properties

    Optional emitter

    emitter?: EventEmitterAsyncResource

    Pool event emitter integrated with async resource. +

  • Optional maximumNumberOfWorkers: number

    • Returns FixedClusterPool<Data, Response>

    Properties

    Optional emitter

    emitter?: EventEmitterAsyncResource

    Pool event emitter integrated with async resource. The async tracking tooling identifier is poolifier:<PoolType>-<WorkerType>-pool.

    Events that can currently be listened to:

      @@ -69,72 +69,72 @@ The async tracking tooling identifier is poolifier:<PoolType>-<Wo
    • 'taskError': Emitted when an error occurs while executing a task.
    • 'backPressure': Emitted when all worker nodes have back pressure (i.e. their tasks queue is full: queue size >= maximum queue size).
    -

    Protected Readonly filePath

    filePath: string

    Path to the worker file.

    -

    Protected Optional Readonly maximumNumberOfWorkers

    maximumNumberOfWorkers?: number

    Maximum number of workers that this pool manages.

    -

    Protected Readonly minimumNumberOfWorkers

    minimumNumberOfWorkers: number

    Minimum number of workers that this pool manages.

    -

    Protected Readonly opts

    opts: PoolOptions<Worker>

    Options for the pool.

    -

    Protected promiseResponseMap

    promiseResponseMap: Map<`${string}-${string}-${string}-${string}-${string}`, PromiseResponseWrapper<Response>> = ...

    The task execution response promise map:

    +

    Protected Readonly filePath

    filePath: string

    Path to the worker file.

    +

    Protected Optional Readonly maximumNumberOfWorkers

    maximumNumberOfWorkers?: number

    Maximum number of workers that this pool manages.

    +

    Protected Readonly minimumNumberOfWorkers

    minimumNumberOfWorkers: number

    Minimum number of workers that this pool manages.

    +

    Protected Readonly opts

    opts: PoolOptions<Worker>

    Options for the pool.

    +

    Protected promiseResponseMap

    promiseResponseMap: Map<`${string}-${string}-${string}-${string}-${string}`, PromiseResponseWrapper<Response>> = ...

    The task execution response promise map:

    • key: The message id of each submitted task.
    • value: An object that contains task's worker node key, execution response promise resolve and reject callbacks, async resource.

    When we receive a message from the worker, we get a map entry with the promise resolve/reject bound to the message id.

    -

    Protected Optional workerChoiceStrategiesContext

    workerChoiceStrategiesContext?: WorkerChoiceStrategiesContext<Worker, Data, Response>

    Worker choice strategies context referencing worker choice algorithms implementation.

    -

    Readonly Internal workerNodes

    workerNodes: IWorkerNode<Worker, Data>[] = []

    Pool worker nodes.

    -

    Accessors

    Protected busy

    Protected Optional workerChoiceStrategiesContext

    workerChoiceStrategiesContext?: WorkerChoiceStrategiesContext<Worker, Data, Response>

    Worker choice strategies context referencing worker choice algorithms implementation.

    +

    Readonly Internal workerNodes

    workerNodes: IWorkerNode<Worker, Data>[] = []

    Pool worker nodes.

    +

    Accessors

    Protected busy

    • get busy(): boolean

    • Whether the pool is busy or not.

      The pool busyness boolean status.

      -

      Returns boolean

    Protected empty

    Protected full

    Protected empty

    Protected full

    • get full(): boolean

    • Whether the pool is full or not.

      The pool filling boolean status.

      -

      Returns boolean

    info

    Private ready

    Protected type

    info

    Private ready

    Protected type

    • get type(): "fixed" | "dynamic"

    • The pool type.

      If it is 'dynamic', it provides the max property.

      -

      Returns "fixed" | "dynamic"

    Private utilization

    • get utilization(): number

    • The approximate pool utilization.

      +

      Returns "fixed" | "dynamic"

    Private utilization

    • get utilization(): number

    • The approximate pool utilization.

      Returns number

      The pool utilization.

      -

    Protected worker

    • get worker(): "thread" | "cluster"

    • The worker type.

      -

      Returns "thread" | "cluster"

    Methods

    addTaskFunction

    Protected afterTaskExecutionHook

    • afterTaskExecutionHook(workerNodeKey, message): void

    • Hook executed after the worker task execution. +

    Protected worker

    • get worker(): "thread" | "cluster"

    • The worker type.

      +

      Returns "thread" | "cluster"

    Methods

    addTaskFunction

    Protected afterTaskExecutionHook

    Protected afterWorkerNodeSetup

    • afterWorkerNodeSetup(workerNodeKey): void

    • Method hooked up after a worker node has been newly created. +

    Returns void

    Protected afterWorkerNodeSetup

    Protected beforeTaskExecutionHook

    • beforeTaskExecutionHook(workerNodeKey, task): void

    • Hook executed before the worker task execution. +

    Returns void

    Protected beforeTaskExecutionHook

    Protected checkAndEmitDynamicWorkerCreationEvents

    Protected createAndSetupDynamicWorkerNode

    • createAndSetupDynamicWorkerNode(): number

    • Creates a new, completely set up dynamic worker node.

      +

    Returns void

    Protected checkAndEmitDynamicWorkerCreationEvents

    Protected createAndSetupDynamicWorkerNode

    Protected createAndSetupWorkerNode

    Protected createAndSetupWorkerNode

    Protected deregisterWorkerMessageListener

    Protected deregisterWorkerMessageListener

    destroy

    Protected destroyWorkerNode

    • destroyWorkerNode(workerNodeKey): Promise<void>

    • Terminates the worker node given its worker node key.

      +

    Returns void

    destroy

    Protected destroyWorkerNode

    enableTasksQueue

    execute

    Protected flagWorkerNodeAsNotReady

    Protected flushTasksQueue

    Protected getWorkerInfo

    • getWorkerInfo(workerNodeKey): undefined | WorkerInfo

    • Gets the worker information given its worker node key.

      +

    Returns Promise<void>

    enableTasksQueue

    execute

    Protected flagWorkerNodeAsNotReady

    Protected flushTasksQueue

    Protected getWorkerInfo

    hasTaskFunction

    Protected internalBusy

    hasTaskFunction

    Protected internalBusy

    Protected isMain

    Protected isMain

    listTaskFunctionsProperties

    Protected registerOnceWorkerMessageListener

    listTaskFunctionsProperties

    Protected registerOnceWorkerMessageListener

    Protected registerWorkerMessageListener

    • registerWorkerMessageListener<Message>(workerNodeKey, listener): void

    • Registers a listener callback on the worker given its worker node key.

      +

    Returns void

    Protected registerWorkerMessageListener

    removeTaskFunction

    Protected sendStartupMessageToWorker

    • sendStartupMessageToWorker(workerNodeKey): void

    • Sends the startup message to worker given its worker node key.

      +

    Returns void

    removeTaskFunction

    Protected sendStartupMessageToWorker

    Protected sendToWorker

    • sendToWorker(workerNodeKey, message): void

    • Sends a message to worker given its worker node key.

      +

    Returns void

    Protected sendToWorker

    setDefaultTaskFunction

    setTasksQueueOptions

    setWorkerChoiceStrategy

    setWorkerChoiceStrategyOptions

    Protected setupHook

    • setupHook(): void

    • Setup hook to execute code before worker nodes are created in the abstract constructor. +

    Returns void

    setDefaultTaskFunction

    setTasksQueueOptions

    setWorkerChoiceStrategy

    setWorkerChoiceStrategyOptions

    Protected setupHook

    Protected shallCreateDynamicWorker

    Protected shallCreateDynamicWorker

    start

    Protected Readonly workerMessageListener

    Settings

    Member Visibility

    Theme

    On This Page

    constructoremitterfilePathmaximumNumberOfWorkersminimumNumberOfWorkersoptspromiseResponseMapworkerChoiceStrategiesContextworkerNodesbusyemptyfullinforeadytypeutilizationworkeraddTaskFunctionafterTaskExecutionHookafterWorkerNodeSetupbeforeTaskExecutionHookcheckAndEmitDynamicWorkerCreationEventscreateAndSetupDynamicWorkerNodecreateAndSetupWorkerNodederegisterWorkerMessageListenerdestroydestroyWorkerNodeenableTasksQueueexecuteflagWorkerNodeAsNotReadyflushTasksQueuegetWorkerInfohasTaskFunctioninternalBusyisMainlistTaskFunctionsPropertiesregisterOnceWorkerMessageListenerregisterWorkerMessageListenerremoveTaskFunctionsendStartupMessageToWorkersendToWorkersetDefaultTaskFunctionsetTasksQueueOptionssetWorkerChoiceStrategysetWorkerChoiceStrategyOptionssetupHookshallCreateDynamicWorkerstartworkerMessageListener
    \ No newline at end of file +

    start

    Protected Readonly workerMessageListener

    Settings

    Member Visibility

    Theme

    On This Page

    constructoremitterfilePathmaximumNumberOfWorkersminimumNumberOfWorkersoptspromiseResponseMapworkerChoiceStrategiesContextworkerNodesbusyemptyfullinforeadytypeutilizationworkeraddTaskFunctionafterTaskExecutionHookafterWorkerNodeSetupbeforeTaskExecutionHookcheckAndEmitDynamicWorkerCreationEventscreateAndSetupDynamicWorkerNodecreateAndSetupWorkerNodederegisterWorkerMessageListenerdestroydestroyWorkerNodeenableTasksQueueexecuteflagWorkerNodeAsNotReadyflushTasksQueuegetWorkerInfohasTaskFunctioninternalBusyisMainlistTaskFunctionsPropertiesregisterOnceWorkerMessageListenerregisterWorkerMessageListenerremoveTaskFunctionsendStartupMessageToWorkersendToWorkersetDefaultTaskFunctionsetTasksQueueOptionssetWorkerChoiceStrategysetWorkerChoiceStrategyOptionssetupHookshallCreateDynamicWorkerstartworkerMessageListener
    \ No newline at end of file diff --git a/docs/classes/FixedThreadPool.html b/docs/classes/FixedThreadPool.html index 181ca7fb..5fdaa928 100644 --- a/docs/classes/FixedThreadPool.html +++ b/docs/classes/FixedThreadPool.html @@ -1,9 +1,9 @@ -FixedThreadPool | poolifier - v4.0.11

    Class FixedThreadPool<Data, Response>

    A thread pool with a fixed number of threads.

    +FixedThreadPool | poolifier - v4.0.12

    Class FixedThreadPool<Data, Response>

    A thread pool with a fixed number of threads.

    Author

    Alessandro Pio Ardizio

    Since

    0.0.1

    Type Parameters

    • Data = unknown

      Type of data sent to the worker. This can only be structured-cloneable data.

    • Response = unknown

      Type of execution response. This can only be structured-cloneable data.

      -

    Hierarchy (view full)

    Constructors

    constructor +

    Hierarchy (view full)

    Constructors

    constructor

    Properties

    emitter? filePath maximumNumberOfWorkers? @@ -56,7 +56,7 @@

    Type Parameters

    • Data = unknown
    • Response = unknown

    Parameters

    • numberOfThreads: number

      Number of threads for this pool.

    • filePath: string

      Path to an implementation of a ThreadWorker file, which can be relative or absolute.

    • opts: ThreadPoolOptions = {}

      Options for this fixed thread pool.

      -
    • Optional maximumNumberOfThreads: number

    Returns FixedThreadPool<Data, Response>

    Properties

    Optional emitter

    emitter?: EventEmitterAsyncResource

    Pool event emitter integrated with async resource. +

  • Optional maximumNumberOfThreads: number

    • Returns FixedThreadPool<Data, Response>

    Properties

    Optional emitter

    emitter?: EventEmitterAsyncResource

    Pool event emitter integrated with async resource. The async tracking tooling identifier is poolifier:<PoolType>-<WorkerType>-pool.

    Events that can currently be listened to:

      @@ -69,73 +69,73 @@ The async tracking tooling identifier is poolifier:<PoolType>-<Wo
    • 'taskError': Emitted when an error occurs while executing a task.
    • 'backPressure': Emitted when all worker nodes have back pressure (i.e. their tasks queue is full: queue size >= maximum queue size).
    -

    Protected Readonly filePath

    filePath: string

    Path to the worker file.

    -

    Protected Optional Readonly maximumNumberOfWorkers

    maximumNumberOfWorkers?: number

    Maximum number of workers that this pool manages.

    -

    Protected Readonly minimumNumberOfWorkers

    minimumNumberOfWorkers: number

    Minimum number of workers that this pool manages.

    -

    Protected Readonly opts

    opts: PoolOptions<Worker>

    Options for the pool.

    -

    Protected promiseResponseMap

    promiseResponseMap: Map<`${string}-${string}-${string}-${string}-${string}`, PromiseResponseWrapper<Response>> = ...

    The task execution response promise map:

    +

    Protected Readonly filePath

    filePath: string

    Path to the worker file.

    +

    Protected Optional Readonly maximumNumberOfWorkers

    maximumNumberOfWorkers?: number

    Maximum number of workers that this pool manages.

    +

    Protected Readonly minimumNumberOfWorkers

    minimumNumberOfWorkers: number

    Minimum number of workers that this pool manages.

    +

    Protected Readonly opts

    opts: PoolOptions<Worker>

    Options for the pool.

    +

    Protected promiseResponseMap

    promiseResponseMap: Map<`${string}-${string}-${string}-${string}-${string}`, PromiseResponseWrapper<Response>> = ...

    The task execution response promise map:

    • key: The message id of each submitted task.
    • value: An object that contains task's worker node key, execution response promise resolve and reject callbacks, async resource.

    When we receive a message from the worker, we get a map entry with the promise resolve/reject bound to the message id.

    -

    Protected Optional workerChoiceStrategiesContext

    workerChoiceStrategiesContext?: WorkerChoiceStrategiesContext<Worker, Data, Response>

    Worker choice strategies context referencing worker choice algorithms implementation.

    -

    Readonly Internal workerNodes

    workerNodes: IWorkerNode<Worker, Data>[] = []

    Pool worker nodes.

    -

    Accessors

    Protected busy

    Protected Optional workerChoiceStrategiesContext

    workerChoiceStrategiesContext?: WorkerChoiceStrategiesContext<Worker, Data, Response>

    Worker choice strategies context referencing worker choice algorithms implementation.

    +

    Readonly Internal workerNodes

    workerNodes: IWorkerNode<Worker, Data>[] = []

    Pool worker nodes.

    +

    Accessors

    Protected busy

    • get busy(): boolean

    • Whether the pool is busy or not.

      The pool busyness boolean status.

      -

      Returns boolean

    Protected empty

    Protected full

    Protected empty

    Protected full

    • get full(): boolean

    • Whether the pool is full or not.

      The pool filling boolean status.

      -

      Returns boolean

    info

    Private ready

    Protected type

    info

    Private ready

    Protected type

    • get type(): "fixed" | "dynamic"

    • The pool type.

      If it is 'dynamic', it provides the max property.

      -

      Returns "fixed" | "dynamic"

    Private utilization

    • get utilization(): number

    • The approximate pool utilization.

      +

      Returns "fixed" | "dynamic"

    Private utilization

    • get utilization(): number

    • The approximate pool utilization.

      Returns number

      The pool utilization.

      -

    Protected worker

    • get worker(): "thread" | "cluster"

    • The worker type.

      -

      Returns "thread" | "cluster"

    Methods

    addTaskFunction

    Protected afterTaskExecutionHook

    • afterTaskExecutionHook(workerNodeKey, message): void

    • Hook executed after the worker task execution. +

    Protected worker

    • get worker(): "thread" | "cluster"

    • The worker type.

      +

      Returns "thread" | "cluster"

    Methods

    addTaskFunction

    Protected afterTaskExecutionHook

    Protected afterWorkerNodeSetup

    • afterWorkerNodeSetup(workerNodeKey): void

    • Method hooked up after a worker node has been newly created. +

    Returns void

    Protected afterWorkerNodeSetup

    Protected beforeTaskExecutionHook

    • beforeTaskExecutionHook(workerNodeKey, task): void

    • Hook executed before the worker task execution. +

    Returns void

    Protected beforeTaskExecutionHook

    Protected checkAndEmitDynamicWorkerCreationEvents

    Protected createAndSetupDynamicWorkerNode

    • createAndSetupDynamicWorkerNode(): number

    • Creates a new, completely set up dynamic worker node.

      +

    Returns void

    Protected checkAndEmitDynamicWorkerCreationEvents

    Protected createAndSetupDynamicWorkerNode

    Protected createAndSetupWorkerNode

    Protected createAndSetupWorkerNode

    Protected deregisterWorkerMessageListener

    Protected deregisterWorkerMessageListener

    destroy

    Protected destroyWorkerNode

    • destroyWorkerNode(workerNodeKey): Promise<void>

    • Terminates the worker node given its worker node key.

      +

    Returns void

    destroy

    Protected destroyWorkerNode

    enableTasksQueue

    execute

    Protected flagWorkerNodeAsNotReady

    Protected flushTasksQueue

    Protected getWorkerInfo

    • getWorkerInfo(workerNodeKey): undefined | WorkerInfo

    • Gets the worker information given its worker node key.

      +

    Returns Promise<void>

    enableTasksQueue

    execute

    Protected flagWorkerNodeAsNotReady

    Protected flushTasksQueue

    Protected getWorkerInfo

    hasTaskFunction

    Protected internalBusy

    hasTaskFunction

    Protected internalBusy

    Protected isMain

    Protected isMain

    listTaskFunctionsProperties

    Protected registerOnceWorkerMessageListener

    listTaskFunctionsProperties

    Protected registerOnceWorkerMessageListener

    Protected registerWorkerMessageListener

    • registerWorkerMessageListener<Message>(workerNodeKey, listener): void

    • Registers a listener callback on the worker given its worker node key.

      +

    Returns void

    Protected registerWorkerMessageListener

    removeTaskFunction

    Protected sendStartupMessageToWorker

    • sendStartupMessageToWorker(workerNodeKey): void

    • Sends the startup message to worker given its worker node key.

      +

    Returns void

    removeTaskFunction

    Protected sendStartupMessageToWorker

    Protected sendToWorker

    • sendToWorker(workerNodeKey, message, transferList?): void

    • Sends a message to worker given its worker node key.

      +

    Returns void

    Protected sendToWorker

    • sendToWorker(workerNodeKey, message, transferList?): void

    • Sends a message to worker given its worker node key.

      Parameters

      • workerNodeKey: number

        The worker node key.

      • message: MessageValue<Data, unknown>

        The message.

      • Optional transferList: readonly TransferListItem[]

        The optional array of transferable objects.

        -

      Returns void

    setDefaultTaskFunction

    setTasksQueueOptions

    setWorkerChoiceStrategy

    setWorkerChoiceStrategyOptions

    Protected setupHook

    • setupHook(): void

    • Setup hook to execute code before worker nodes are created in the abstract constructor. +

    Returns void

    setDefaultTaskFunction

    setTasksQueueOptions

    setWorkerChoiceStrategy

    setWorkerChoiceStrategyOptions

    Protected setupHook

    Protected shallCreateDynamicWorker

    Protected shallCreateDynamicWorker

    start

    Protected Readonly workerMessageListener

    Settings

    Member Visibility

    Theme

    On This Page

    constructoremitterfilePathmaximumNumberOfWorkersminimumNumberOfWorkersoptspromiseResponseMapworkerChoiceStrategiesContextworkerNodesbusyemptyfullinforeadytypeutilizationworkeraddTaskFunctionafterTaskExecutionHookafterWorkerNodeSetupbeforeTaskExecutionHookcheckAndEmitDynamicWorkerCreationEventscreateAndSetupDynamicWorkerNodecreateAndSetupWorkerNodederegisterWorkerMessageListenerdestroydestroyWorkerNodeenableTasksQueueexecuteflagWorkerNodeAsNotReadyflushTasksQueuegetWorkerInfohasTaskFunctioninternalBusyisMainlistTaskFunctionsPropertiesregisterOnceWorkerMessageListenerregisterWorkerMessageListenerremoveTaskFunctionsendStartupMessageToWorkersendToWorkersetDefaultTaskFunctionsetTasksQueueOptionssetWorkerChoiceStrategysetWorkerChoiceStrategyOptionssetupHookshallCreateDynamicWorkerstartworkerMessageListener
    \ No newline at end of file +

    start

    Protected Readonly workerMessageListener

    Settings

    Member Visibility

    Theme

    On This Page

    constructoremitterfilePathmaximumNumberOfWorkersminimumNumberOfWorkersoptspromiseResponseMapworkerChoiceStrategiesContextworkerNodesbusyemptyfullinforeadytypeutilizationworkeraddTaskFunctionafterTaskExecutionHookafterWorkerNodeSetupbeforeTaskExecutionHookcheckAndEmitDynamicWorkerCreationEventscreateAndSetupDynamicWorkerNodecreateAndSetupWorkerNodederegisterWorkerMessageListenerdestroydestroyWorkerNodeenableTasksQueueexecuteflagWorkerNodeAsNotReadyflushTasksQueuegetWorkerInfohasTaskFunctioninternalBusyisMainlistTaskFunctionsPropertiesregisterOnceWorkerMessageListenerregisterWorkerMessageListenerremoveTaskFunctionsendStartupMessageToWorkersendToWorkersetDefaultTaskFunctionsetTasksQueueOptionssetWorkerChoiceStrategysetWorkerChoiceStrategyOptionssetupHookshallCreateDynamicWorkerstartworkerMessageListener
    \ No newline at end of file diff --git a/docs/classes/PriorityQueue.html b/docs/classes/PriorityQueue.html index 3064f2cc..ff3fc09e 100644 --- a/docs/classes/PriorityQueue.html +++ b/docs/classes/PriorityQueue.html @@ -1,6 +1,6 @@ -PriorityQueue | poolifier - v4.0.11

    Class PriorityQueue<T>Internal

    Priority queue.

    +PriorityQueue | poolifier - v4.0.12

    Class PriorityQueue<T>Internal

    Priority queue.

    Type Parameters

    • T

      Type of priority queue data.

      -

    Constructors

    constructor +

    Constructors

    constructor

    Properties

    bucketSize maxSize nodeArray @@ -18,29 +18,29 @@

    Type Parameters

    • T

    Parameters

    • bucketSize: number = Number.POSITIVE_INFINITY

      Prioritized bucket size.

    Returns PriorityQueue<T>

    Default Value

    Number.POSITIVE_INFINITY
    -

    Properties

    Private Readonly bucketSize

    bucketSize: number

    Prioritized bucket size.

    -

    maxSize

    maxSize: number

    The maximum size of the priority queue.

    -

    Private nodeArray

    nodeArray: PriorityQueueNode<T>[]

    size

    size: number

    The size of the priority queue.

    -

    Accessors

    buckets

    Methods

    [iterator]

    Properties

    Private Readonly bucketSize

    bucketSize: number

    Prioritized bucket size.

    +

    maxSize

    maxSize: number

    The maximum size of the priority queue.

    +

    Private nodeArray

    nodeArray: PriorityQueueNode<T>[]

    size

    size: number

    The size of the priority queue.

    +

    Accessors

    buckets

    Methods

    [iterator]

    clear

    Private decrementSize

    clear

    Private decrementSize

    • decrementSize(): number

    • Decrements the size of the priority queue.

      Returns number

      The new size of the priority queue.

      -

    dequeue

    dequeue

    • dequeue(bucket?): undefined | T

    • Dequeue data from the priority queue.

      Parameters

      • bucket: number = 0

        The prioritized bucket to dequeue from.

      Returns undefined | T

      The dequeued data or undefined if the priority queue is empty.

      Default Value

      0
      -

    enqueue

    enqueue

    • enqueue(data, priority?): number

    • Enqueue data into the priority queue.

      Parameters

      • data: T

        Data to enqueue.

      • Optional priority: number

        Priority of the data. Lower values have higher priority.

      Returns number

      The new size of the priority queue.

      -

    Private incrementSize

    Private incrementSize

    • incrementSize(): number

    • Increments the size of the priority queue.

      Returns number

      The new size of the priority queue.

      -

    peekFirst

    peekFirst

    • peekFirst(): undefined | T

    • Peeks at the first data.

      Returns undefined | T

      The first data or undefined if the priority queue is empty.

      -

    peekLast

    peekLast

    • peekLast(): undefined | T

    • Peeks at the last data.

      Returns undefined | T

      The last data or undefined if the priority queue is empty.

      -

    Settings

    Member Visibility

    Theme

    On This Page

    constructorbucketSizemaxSizenodeArraysizebuckets[iterator]cleardecrementSizedequeueenqueueincrementSizepeekFirstpeekLast
    \ No newline at end of file +

    Settings

    Member Visibility

    Theme

    On This Page

    constructorbucketSizemaxSizenodeArraysizebuckets[iterator]cleardecrementSizedequeueenqueueincrementSizepeekFirstpeekLast
    \ No newline at end of file diff --git a/docs/classes/ThreadWorker.html b/docs/classes/ThreadWorker.html index 151f0600..df3bcfcd 100644 --- a/docs/classes/ThreadWorker.html +++ b/docs/classes/ThreadWorker.html @@ -1,4 +1,4 @@ -ThreadWorker | poolifier - v4.0.11

    Class ThreadWorker<Data, Response>

    A thread worker used by a poolifier ThreadPool.

    +ThreadWorker | poolifier - v4.0.12

    Class ThreadWorker<Data, Response>

    A thread worker used by a poolifier ThreadPool.

    When this worker is inactive for more than the given maxInactiveTime, it will send a termination request to its main thread.

    If you use a DynamicThreadPool the extra workers that were created will be terminated, @@ -7,7 +7,7 @@ but the minimum number of workers will be guaranteed.

    Since

    0.0.1

    Type Parameters

    • Data = unknown

      Type of data this worker receives from pool's execution. This can only be structured-cloneable data.

    • Response = unknown

      Type of response the worker sends back to the main thread. This can only be structured-cloneable data.

      -

    Hierarchy (view full)

    Constructors

    constructor +

    Hierarchy (view full)

    Constructors

    constructor

    Properties

    activeInterval? isMain lastTaskTimestamp @@ -35,50 +35,50 @@ but the minimum number of workers will be guaranteed.

    Constructors

    constructor

    Properties

    Protected Optional activeInterval

    activeInterval?: Timeout

    Handler id of the activeInterval worker activity check.

    -

    Protected Readonly isMain

    isMain: undefined | boolean

    Whether this is the main worker or not.

    -

    Protected lastTaskTimestamp

    lastTaskTimestamp: number

    Timestamp of the last task processed by this worker.

    -

    Protected opts

    opts: WorkerOptions = DEFAULT_WORKER_OPTIONS

    Options for the worker.

    -

    Private Optional port

    port?: MessagePort

    Message port used to communicate with the main worker.

    -

    Protected Optional statistics

    statistics?: WorkerStatistics

    Performance statistics computation requirements.

    -

    Protected taskFunctions

    taskFunctions: Map<string, TaskFunctionObject<Data, Response>>

    Task function object(s) processed by the worker when the pool's execution function is invoked.

    -

    Accessors

    Protected id

    Methods

    addTaskFunction

    Returns ThreadWorker<Data, Response>

    Properties

    Protected Optional activeInterval

    activeInterval?: Timeout

    Handler id of the activeInterval worker activity check.

    +

    Protected Readonly isMain

    isMain: undefined | boolean

    Whether this is the main worker or not.

    +

    Protected lastTaskTimestamp

    lastTaskTimestamp: number

    Timestamp of the last task processed by this worker.

    +

    Protected opts

    opts: WorkerOptions = DEFAULT_WORKER_OPTIONS

    Options for the worker.

    +

    Private Optional port

    port?: MessagePort

    Message port used to communicate with the main worker.

    +

    Protected Optional statistics

    statistics?: WorkerStatistics

    Performance statistics computation requirements.

    +

    Protected taskFunctions

    taskFunctions: Map<string, TaskFunctionObject<Data, Response>>

    Task function object(s) processed by the worker when the pool's execution function is invoked.

    +

    Accessors

    Protected id

    Methods

    addTaskFunction

    Protected getMainWorker

    Protected getMainWorker

    Protected handleError

    Protected handleError

    • handleError(error): string

    • Handles an error and convert it to a string so it can be sent back to the main worker.

      Parameters

      • error: string | Error

        The error raised by the worker.

      Returns string

      The error message.

      -

    Protected handleKillMessage

    Protected handleReadyMessage

    Protected handleKillMessage

    Protected handleReadyMessage

    Protected handleTaskFunctionOperationMessage

    hasTaskFunction

    Returns void

    Protected handleTaskFunctionOperationMessage

    hasTaskFunction

    listTaskFunctionsProperties

    listTaskFunctionsProperties

    Protected messageListener

    Protected messageListener

    removeTaskFunction

    Returns void

    removeTaskFunction

    Protected Readonly run

    Protected Readonly run

    Protected Readonly runAsync

    • runAsync(fn, task): void

    • Runs the given task function asynchronously.

      +

    Returns void

    Protected Readonly runAsync

    Protected Readonly runSync

    • runSync(fn, task): void

    • Runs the given task function synchronously.

      +

    Returns void

    Protected Readonly runSync

    Protected sendTaskFunctionsPropertiesToMainWorker

    Protected Readonly sendToMainWorker

    • sendToMainWorker(message): void

    • Sends a message to main worker.

      +

    Returns void

    Protected sendTaskFunctionsPropertiesToMainWorker

    Protected Readonly sendToMainWorker

    setDefaultTaskFunction

    Returns void

    setDefaultTaskFunction

    Settings

    Member Visibility

    Theme

    On This Page

    constructoractiveIntervalisMainlastTaskTimestampoptsportstatisticstaskFunctionsidaddTaskFunctiongetMainWorkerhandleErrorhandleKillMessagehandleReadyMessagehandleTaskFunctionOperationMessagehasTaskFunctionlistTaskFunctionsPropertiesmessageListenerremoveTaskFunctionrunrunAsyncrunSyncsendTaskFunctionsPropertiesToMainWorkersendToMainWorkersetDefaultTaskFunction
    \ No newline at end of file +

    Settings

    Member Visibility

    Theme

    On This Page

    constructoractiveIntervalisMainlastTaskTimestampoptsportstatisticstaskFunctionsidaddTaskFunctiongetMainWorkerhandleErrorhandleKillMessagehandleReadyMessagehandleTaskFunctionOperationMessagehasTaskFunctionlistTaskFunctionsPropertiesmessageListenerremoveTaskFunctionrunrunAsyncrunSyncsendTaskFunctionsPropertiesToMainWorkersendToMainWorkersetDefaultTaskFunction
    \ No newline at end of file diff --git a/docs/classes/WorkerChoiceStrategiesContext.html b/docs/classes/WorkerChoiceStrategiesContext.html index f3009970..92f0fb5f 100644 --- a/docs/classes/WorkerChoiceStrategiesContext.html +++ b/docs/classes/WorkerChoiceStrategiesContext.html @@ -1,8 +1,8 @@ -WorkerChoiceStrategiesContext | poolifier - v4.0.11

    Class WorkerChoiceStrategiesContext<Worker, Data, Response>

    The worker choice strategies context.

    +WorkerChoiceStrategiesContext | poolifier - v4.0.12

    Class WorkerChoiceStrategiesContext<Worker, Data, Response>

    The worker choice strategies context.

    Type Parameters

    • Worker extends IWorker

      Type of worker.

    • Data = unknown

      Type of data sent to the worker. This can only be structured-cloneable data.

    • Response = unknown

      Type of execution response. This can only be structured-cloneable data.

      -

    Constructors

    constructor +

    Constructors

    constructor

    Properties

    defaultWorkerChoiceStrategy pool retries @@ -27,45 +27,45 @@
  • Optional opts: WorkerChoiceStrategyOptions

    The worker choice strategy options.

    • Returns WorkerChoiceStrategiesContext<Worker, Data, Response>

    Default Value

    [WorkerChoiceStrategies.ROUND_ROBIN]
    -

    Properties

    Private defaultWorkerChoiceStrategy

    defaultWorkerChoiceStrategy: "ROUND_ROBIN" | "LEAST_USED" | "LEAST_BUSY" | "LEAST_ELU" | "FAIR_SHARE" | "WEIGHTED_ROUND_ROBIN" | "INTERLEAVED_WEIGHTED_ROUND_ROBIN"

    The default worker choice strategy in the context.

    -

    Private Readonly pool

    pool: IPool<Worker, Data, Response>

    The pool instance.

    -

    Private Readonly retries

    retries: number

    The maximum number of worker choice strategies execution retries.

    -

    retriesCount

    retriesCount: number

    The number of worker choice strategies execution retries.

    -

    Private Readonly workerChoiceStrategies

    workerChoiceStrategies: Map<"ROUND_ROBIN" | "LEAST_USED" | "LEAST_BUSY" | "LEAST_ELU" | "FAIR_SHARE" | "WEIGHTED_ROUND_ROBIN" | "INTERLEAVED_WEIGHTED_ROUND_ROBIN", IWorkerChoiceStrategy>

    The worker choice strategies registered in the context.

    -

    Private workerChoiceStrategiesPolicy

    workerChoiceStrategiesPolicy: StrategyPolicy

    The active worker choice strategies in the context policy.

    -

    Private workerChoiceStrategiesTaskStatisticsRequirements

    workerChoiceStrategiesTaskStatisticsRequirements: TaskStatisticsRequirements

    The active worker choice strategies in the context task statistics requirements.

    -

    Methods

    Private addWorkerChoiceStrategy

    Properties

    Private defaultWorkerChoiceStrategy

    defaultWorkerChoiceStrategy: "ROUND_ROBIN" | "LEAST_USED" | "LEAST_BUSY" | "LEAST_ELU" | "FAIR_SHARE" | "WEIGHTED_ROUND_ROBIN" | "INTERLEAVED_WEIGHTED_ROUND_ROBIN"

    The default worker choice strategy in the context.

    +

    Private Readonly pool

    pool: IPool<Worker, Data, Response>

    The pool instance.

    +

    Private Readonly retries

    retries: number

    The maximum number of worker choice strategies execution retries.

    +

    retriesCount

    retriesCount: number

    The number of worker choice strategies execution retries.

    +

    Private Readonly workerChoiceStrategies

    workerChoiceStrategies: Map<"ROUND_ROBIN" | "LEAST_USED" | "LEAST_BUSY" | "LEAST_ELU" | "FAIR_SHARE" | "WEIGHTED_ROUND_ROBIN" | "INTERLEAVED_WEIGHTED_ROUND_ROBIN", IWorkerChoiceStrategy>

    The worker choice strategies registered in the context.

    +

    Private workerChoiceStrategiesPolicy

    workerChoiceStrategiesPolicy: StrategyPolicy

    The active worker choice strategies in the context policy.

    +

    Private workerChoiceStrategiesTaskStatisticsRequirements

    workerChoiceStrategiesTaskStatisticsRequirements: TaskStatisticsRequirements

    The active worker choice strategies in the context task statistics requirements.

    +

    Methods

    Private addWorkerChoiceStrategy

    • addWorkerChoiceStrategy(workerChoiceStrategy, pool, opts?): Map<"ROUND_ROBIN" | "LEAST_USED" | "LEAST_BUSY" | "LEAST_ELU" | "FAIR_SHARE" | "WEIGHTED_ROUND_ROBIN" | "INTERLEAVED_WEIGHTED_ROUND_ROBIN", IWorkerChoiceStrategy>

    • Adds a worker choice strategy to the context.

      Parameters

      • workerChoiceStrategy: "ROUND_ROBIN" | "LEAST_USED" | "LEAST_BUSY" | "LEAST_ELU" | "FAIR_SHARE" | "WEIGHTED_ROUND_ROBIN" | "INTERLEAVED_WEIGHTED_ROUND_ROBIN"

        The worker choice strategy to add.

      • pool: IPool<Worker, Data, Response>
      • Optional opts: WorkerChoiceStrategyOptions

        The worker choice strategy options.

      Returns Map<"ROUND_ROBIN" | "LEAST_USED" | "LEAST_BUSY" | "LEAST_ELU" | "FAIR_SHARE" | "WEIGHTED_ROUND_ROBIN" | "INTERLEAVED_WEIGHTED_ROUND_ROBIN", IWorkerChoiceStrategy>

      The worker choice strategies.

      -

    execute

    execute

    • execute(workerChoiceStrategy?): number

    • Executes the given worker choice strategy in the context algorithm.

      Parameters

      • workerChoiceStrategy: "ROUND_ROBIN" | "LEAST_USED" | "LEAST_BUSY" | "LEAST_ELU" | "FAIR_SHARE" | "WEIGHTED_ROUND_ROBIN" | "INTERLEAVED_WEIGHTED_ROUND_ROBIN" = ...

        The worker choice strategy algorithm to execute.

      Returns number

      The key of the worker node.

      Default Value

      this.defaultWorkerChoiceStrategy

      Throws

      https://nodejs.org/api/errors.html#class-error If after computed retries the worker node key is null or undefined.

      -

    Private executeStrategy

    Private executeStrategy

    getPolicy

    getPolicy

    getTaskStatisticsRequirements

    getTaskStatisticsRequirements

    remove

    remove

    Private removeWorkerChoiceStrategy

    Private removeWorkerChoiceStrategy

    • removeWorkerChoiceStrategy(workerChoiceStrategy): boolean

    • Removes a worker choice strategy from the context.

      Parameters

      • workerChoiceStrategy: "ROUND_ROBIN" | "LEAST_USED" | "LEAST_BUSY" | "LEAST_ELU" | "FAIR_SHARE" | "WEIGHTED_ROUND_ROBIN" | "INTERLEAVED_WEIGHTED_ROUND_ROBIN"

        The worker choice strategy to remove.

      Returns boolean

      true if the worker choice strategy is removed, false otherwise.

      -

    setDefaultWorkerChoiceStrategy

    setDefaultWorkerChoiceStrategy

    • setDefaultWorkerChoiceStrategy(workerChoiceStrategy, opts?): void

    • Sets the default worker choice strategy to use in the context.

      Parameters

      • workerChoiceStrategy: "ROUND_ROBIN" | "LEAST_USED" | "LEAST_BUSY" | "LEAST_ELU" | "FAIR_SHARE" | "WEIGHTED_ROUND_ROBIN" | "INTERLEAVED_WEIGHTED_ROUND_ROBIN"

        The default worker choice strategy to set.

      • Optional opts: WorkerChoiceStrategyOptions

        The worker choice strategy options.

        -

      Returns void

    setOptions

    • setOptions(opts): void

    • Sets the active worker choice strategies in the context options.

      +

    Returns void

    setOptions

    syncWorkerChoiceStrategies

    • syncWorkerChoiceStrategies(workerChoiceStrategies, opts?): void

    • Synchronizes the active worker choice strategies in the context with the given worker choice strategies.

      +

    Returns void

    syncWorkerChoiceStrategies

    • syncWorkerChoiceStrategies(workerChoiceStrategies, opts?): void

    • Synchronizes the active worker choice strategies in the context with the given worker choice strategies.

      Parameters

      • workerChoiceStrategies: Set<"ROUND_ROBIN" | "LEAST_USED" | "LEAST_BUSY" | "LEAST_ELU" | "FAIR_SHARE" | "WEIGHTED_ROUND_ROBIN" | "INTERLEAVED_WEIGHTED_ROUND_ROBIN">

        The worker choice strategies to synchronize.

      • Optional opts: WorkerChoiceStrategyOptions

        The worker choice strategy options.

        -

      Returns void

    update

    • update(workerNodeKey): boolean

    • Updates the worker node key in the active worker choice strategies in the context internals.

      +

    Returns void

    update

    Settings

    Member Visibility

    Theme

    On This Page

    constructordefaultWorkerChoiceStrategypoolretriesretriesCountworkerChoiceStrategiesworkerChoiceStrategiesPolicyworkerChoiceStrategiesTaskStatisticsRequirementsaddWorkerChoiceStrategyexecuteexecuteStrategygetPolicygetTaskStatisticsRequirementsremoveremoveWorkerChoiceStrategysetDefaultWorkerChoiceStrategysetOptionssyncWorkerChoiceStrategiesupdate
    \ No newline at end of file +

    Settings

    Member Visibility

    Theme

    On This Page

    constructordefaultWorkerChoiceStrategypoolretriesretriesCountworkerChoiceStrategiesworkerChoiceStrategiesPolicyworkerChoiceStrategiesTaskStatisticsRequirementsaddWorkerChoiceStrategyexecuteexecuteStrategygetPolicygetTaskStatisticsRequirementsremoveremoveWorkerChoiceStrategysetDefaultWorkerChoiceStrategysetOptionssyncWorkerChoiceStrategiesupdate
    \ No newline at end of file diff --git a/docs/functions/availableParallelism.html b/docs/functions/availableParallelism.html index e68e8f33..ee60216e 100644 --- a/docs/functions/availableParallelism.html +++ b/docs/functions/availableParallelism.html @@ -1,4 +1,4 @@ -availableParallelism | poolifier - v4.0.11

    Function availableParallelism

    • availableParallelism(): number

    • Returns safe host OS optimized estimate of the default amount of parallelism a pool should use. +availableParallelism | poolifier - v4.0.12

      Function availableParallelism

      • availableParallelism(): number

      • Returns safe host OS optimized estimate of the default amount of parallelism a pool should use. Always returns a value greater than zero.

        Returns number

        The host OS optimized maximum pool size.

        -

      Settings

      Member Visibility

      Theme

      \ No newline at end of file +

    Settings

    Member Visibility

    Theme

    \ No newline at end of file diff --git a/docs/hierarchy.html b/docs/hierarchy.html index 8fdf2f9e..eb89c4b6 100644 --- a/docs/hierarchy.html +++ b/docs/hierarchy.html @@ -1 +1 @@ -poolifier - v4.0.11

    poolifier - v4.0.11

    Class Hierarchy

    Settings

    Member Visibility

    Theme

    \ No newline at end of file +poolifier - v4.0.12

    poolifier - v4.0.12

    Class Hierarchy

    Settings

    Member Visibility

    Theme

    \ No newline at end of file diff --git a/docs/index.html b/docs/index.html index 340009fc..3bd93950 100644 --- a/docs/index.html +++ b/docs/index.html @@ -1,4 +1,4 @@ -poolifier - v4.0.11

    poolifier - v4.0.11

    Index

    Classes

    AbstractPool +poolifier - v4.0.12

    poolifier - v4.0.12

    Index

    Classes

    AbstractPool AbstractWorker CircularBuffer ClusterWorker @@ -66,4 +66,4 @@ WorkerChoiceStrategies WorkerTypes

    Functions

    availableParallelism -

    Settings

    Member Visibility

    Theme

    \ No newline at end of file +

    Settings

    Member Visibility

    Theme

    \ No newline at end of file diff --git a/docs/interfaces/EventLoopUtilizationMeasurementStatistics.html b/docs/interfaces/EventLoopUtilizationMeasurementStatistics.html index e471a4e3..04ed4003 100644 --- a/docs/interfaces/EventLoopUtilizationMeasurementStatistics.html +++ b/docs/interfaces/EventLoopUtilizationMeasurementStatistics.html @@ -1,5 +1,5 @@ -EventLoopUtilizationMeasurementStatistics | poolifier - v4.0.11

    Interface EventLoopUtilizationMeasurementStatisticsInternal

    Event loop utilization measurement statistics.

    -
    interface EventLoopUtilizationMeasurementStatistics {
        active: MeasurementStatistics;
        idle: MeasurementStatistics;
        utilization?: number;
    }

    Properties

    active +EventLoopUtilizationMeasurementStatistics | poolifier - v4.0.12

    Interface EventLoopUtilizationMeasurementStatisticsInternal

    Event loop utilization measurement statistics.

    +
    interface EventLoopUtilizationMeasurementStatistics {
        active: MeasurementStatistics;
        idle: MeasurementStatistics;
        utilization?: number;
    }

    Properties

    active idle utilization? -

    Properties

    Readonly active

    active: MeasurementStatistics

    Readonly idle

    idle: MeasurementStatistics

    Optional utilization

    utilization?: number

    Settings

    Member Visibility

    Theme

    On This Page

    activeidleutilization
    \ No newline at end of file +

    Properties

    Readonly active

    active: MeasurementStatistics

    Readonly idle

    idle: MeasurementStatistics

    Optional utilization

    utilization?: number

    Settings

    Member Visibility

    Theme

    On This Page

    activeidleutilization
    \ No newline at end of file diff --git a/docs/interfaces/IPool.html b/docs/interfaces/IPool.html index 9b39b834..7ee0b13d 100644 --- a/docs/interfaces/IPool.html +++ b/docs/interfaces/IPool.html @@ -1,8 +1,8 @@ -IPool | poolifier - v4.0.11

    Interface IPool<Worker, Data, Response>

    Contract definition for a poolifier pool.

    +IPool | poolifier - v4.0.12

    Interface IPool<Worker, Data, Response>

    Contract definition for a poolifier pool.

    interface IPool<Worker, Data, Response> {
        addTaskFunction: ((name, fn) => Promise<boolean>);
        destroy: (() => Promise<void>);
        emitter?: EventEmitterAsyncResource;
        enableTasksQueue: ((enable, tasksQueueOptions?) => void);
        execute: ((data?, name?, transferList?) => Promise<Response>);
        hasTaskFunction: ((name) => boolean);
        info: PoolInfo;
        listTaskFunctionsProperties: (() => TaskFunctionProperties[]);
        removeTaskFunction: ((name) => Promise<boolean>);
        setDefaultTaskFunction: ((name) => Promise<boolean>);
        setTasksQueueOptions: ((tasksQueueOptions) => void);
        setWorkerChoiceStrategy: ((workerChoiceStrategy, workerChoiceStrategyOptions?) => void);
        setWorkerChoiceStrategyOptions: ((workerChoiceStrategyOptions) => boolean);
        start: (() => void);
        workerNodes: IWorkerNode<Worker, Data>[];
    }

    Type Parameters

    • Worker extends IWorker

      Type of worker which manages this pool.

    • Data = unknown

      Type of data sent to the worker. This can only be structured-cloneable data.

    • Response = unknown

      Type of execution response. This can only be structured-cloneable data.

      -

    Implemented by

    Properties

    addTaskFunction +

    Implemented by

    Properties

    addTaskFunction destroy emitter? enableTasksQueue @@ -24,8 +24,8 @@ If a task function with the same name already exists, it will be overwritten.

    Returns Promise<boolean>

    Returns

    true if the task function was added, false otherwise.

    Throws

    https://nodejs.org/api/errors.html#class-typeerror If the name parameter is not a string or an empty string.

    Throws

    https://nodejs.org/api/errors.html#class-typeerror If the fn parameter is not a function or task function object.

    -

    Readonly destroy

    destroy: (() => Promise<void>)

    Terminates all workers in this pool.

    -

    Type declaration

      • (): Promise<void>

      • Returns Promise<void>

    Optional Readonly emitter

    emitter?: EventEmitterAsyncResource

    Pool event emitter integrated with async resource. +

    Readonly destroy

    destroy: (() => Promise<void>)

    Terminates all workers in this pool.

    +

    Type declaration

      • (): Promise<void>

      • Returns Promise<void>

    Optional Readonly emitter

    emitter?: EventEmitterAsyncResource

    Pool event emitter integrated with async resource. The async tracking tooling identifier is poolifier:<PoolType>-<WorkerType>-pool.

    Events that can currently be listened to:

      @@ -38,34 +38,34 @@ The async tracking tooling identifier is poolifier:<PoolType>-<Wo
    • 'taskError': Emitted when an error occurs while executing a task.
    • 'backPressure': Emitted when all worker nodes have back pressure (i.e. their tasks queue is full: queue size >= maximum queue size).
    -

    Readonly enableTasksQueue

    enableTasksQueue: ((enable, tasksQueueOptions?) => void)

    Enables/disables the worker node tasks queue in this pool.

    +

    Readonly enableTasksQueue

    enableTasksQueue: ((enable, tasksQueueOptions?) => void)

    Enables/disables the worker node tasks queue in this pool.

    Type declaration

      • (enable, tasksQueueOptions?): void

      • Parameters

        • enable: boolean

          Whether to enable or disable the worker node tasks queue.

        • Optional tasksQueueOptions: TasksQueueOptions

          The worker node tasks queue options.

          -

        Returns void

    Readonly execute

    execute: ((data?, name?, transferList?) => Promise<Response>)

    Executes the specified function in the worker constructor with the task data input parameter.

    +

    Returns void

    Readonly execute

    execute: ((data?, name?, transferList?) => Promise<Response>)

    Executes the specified function in the worker constructor with the task data input parameter.

    Type declaration

      • (data?, name?, transferList?): Promise<Response>

      • Parameters

        • Optional data: Data

          The optional task input data for the specified task function. This can only be structured-cloneable data.

        • Optional name: string

          The optional name of the task function to execute. If not specified, the default task function will be executed.

        • Optional transferList: readonly TransferListItem[]

          An optional array of transferable objects to transfer ownership of. Ownership of the transferred objects is given to the chosen pool's worker_threads worker and they should not be used in the main thread afterwards.

        Returns Promise<Response>

    Returns

    Promise that will be fulfilled when the task is completed.

    -

    Readonly hasTaskFunction

    hasTaskFunction: ((name) => boolean)

    Whether the specified task function exists in this pool.

    +

    Readonly hasTaskFunction

    hasTaskFunction: ((name) => boolean)

    Whether the specified task function exists in this pool.

    Type declaration

      • (name): boolean

      • Parameters

        • name: string

          The name of the task function.

        Returns boolean

    Returns

    true if the task function exists, false otherwise.

    -

    Readonly info

    info: PoolInfo

    Pool information.

    -

    Readonly listTaskFunctionsProperties

    listTaskFunctionsProperties: (() => TaskFunctionProperties[])

    Lists the properties of task functions available in this pool.

    +

    Readonly info

    info: PoolInfo

    Pool information.

    +

    Readonly listTaskFunctionsProperties

    listTaskFunctionsProperties: (() => TaskFunctionProperties[])

    Lists the properties of task functions available in this pool.

    Type declaration

    Returns

    The properties of task functions available in this pool.

    -

    Readonly removeTaskFunction

    removeTaskFunction: ((name) => Promise<boolean>)

    Removes a task function from this pool.

    +

    Readonly removeTaskFunction

    removeTaskFunction: ((name) => Promise<boolean>)

    Removes a task function from this pool.

    Type declaration

      • (name): Promise<boolean>

      • Parameters

        • name: string

          The name of the task function.

        Returns Promise<boolean>

    Returns

    true if the task function was removed, false otherwise.

    -

    Readonly setDefaultTaskFunction

    setDefaultTaskFunction: ((name) => Promise<boolean>)

    Sets the default task function in this pool.

    +

    Readonly setDefaultTaskFunction

    setDefaultTaskFunction: ((name) => Promise<boolean>)

    Sets the default task function in this pool.

    Type declaration

      • (name): Promise<boolean>

      • Parameters

        • name: string

          The name of the task function.

        Returns Promise<boolean>

    Returns

    true if the default task function was set, false otherwise.

    -

    Readonly setTasksQueueOptions

    setTasksQueueOptions: ((tasksQueueOptions) => void)

    Sets the worker node tasks queue options in this pool.

    +

    Readonly setTasksQueueOptions

    setTasksQueueOptions: ((tasksQueueOptions) => void)

    Sets the worker node tasks queue options in this pool.

    Type declaration

      • (tasksQueueOptions): void

      • Parameters

        Returns void

    Readonly setWorkerChoiceStrategy

    setWorkerChoiceStrategy: ((workerChoiceStrategy, workerChoiceStrategyOptions?) => void)

    Sets the default worker choice strategy in this pool.

    +

    Returns void

    Readonly setWorkerChoiceStrategy

    setWorkerChoiceStrategy: ((workerChoiceStrategy, workerChoiceStrategyOptions?) => void)

    Sets the default worker choice strategy in this pool.

    Type declaration

      • (workerChoiceStrategy, workerChoiceStrategyOptions?): void

      • Parameters

        • workerChoiceStrategy: "ROUND_ROBIN" | "LEAST_USED" | "LEAST_BUSY" | "LEAST_ELU" | "FAIR_SHARE" | "WEIGHTED_ROUND_ROBIN" | "INTERLEAVED_WEIGHTED_ROUND_ROBIN"

          The default worker choice strategy.

        • Optional workerChoiceStrategyOptions: WorkerChoiceStrategyOptions

          The worker choice strategy options.

          -

        Returns void

    Readonly setWorkerChoiceStrategyOptions

    setWorkerChoiceStrategyOptions: ((workerChoiceStrategyOptions) => boolean)

    Sets the worker choice strategy options in this pool.

    +

    Returns void

    Readonly setWorkerChoiceStrategyOptions

    setWorkerChoiceStrategyOptions: ((workerChoiceStrategyOptions) => boolean)

    Sets the worker choice strategy options in this pool.

    Type declaration

      • (workerChoiceStrategyOptions): boolean

      • Parameters

        Returns boolean

    Returns

    true if the worker choice strategy options were set, false otherwise.

    -

    Readonly start

    start: (() => void)

    Starts the minimum number of workers in this pool.

    -

    Type declaration

      • (): void

      • Returns void

    Readonly Internal workerNodes

    workerNodes: IWorkerNode<Worker, Data>[]

    Pool worker nodes.

    -

    Settings

    Member Visibility

    Theme

    On This Page

    addTaskFunctiondestroyemitterenableTasksQueueexecutehasTaskFunctioninfolistTaskFunctionsPropertiesremoveTaskFunctionsetDefaultTaskFunctionsetTasksQueueOptionssetWorkerChoiceStrategysetWorkerChoiceStrategyOptionsstartworkerNodes
    \ No newline at end of file +

    Readonly start

    start: (() => void)

    Starts the minimum number of workers in this pool.

    +

    Type declaration

      • (): void

      • Returns void

    Readonly Internal workerNodes

    workerNodes: IWorkerNode<Worker, Data>[]

    Pool worker nodes.

    +

    Settings

    Member Visibility

    Theme

    On This Page

    addTaskFunctiondestroyemitterenableTasksQueueexecutehasTaskFunctioninfolistTaskFunctionsPropertiesremoveTaskFunctionsetDefaultTaskFunctionsetTasksQueueOptionssetWorkerChoiceStrategysetWorkerChoiceStrategyOptionsstartworkerNodes
    \ No newline at end of file diff --git a/docs/interfaces/IWorker.html b/docs/interfaces/IWorker.html index b3f69c2b..da141b9a 100644 --- a/docs/interfaces/IWorker.html +++ b/docs/interfaces/IWorker.html @@ -1,5 +1,5 @@ -IWorker | poolifier - v4.0.11

    Interface IWorker

    Worker interface.

    -
    interface IWorker {
        disconnect?: (() => void);
        id?: number;
        kill?: ((signal?) => void);
        on: ((event, handler) => this);
        once: ((event, handler) => this);
        terminate?: (() => Promise<number>);
        threadId?: number;
        unref?: (() => void);
        [captureRejectionSymbol]?<K>(error, event, ...args): void;
        addListener<K>(eventName, listener): this;
        emit<K>(eventName, ...args): boolean;
        eventNames(): (string | symbol)[];
        getMaxListeners(): number;
        listenerCount<K>(eventName, listener?): number;
        listeners<K>(eventName): Function[];
        off<K>(eventName, listener): this;
        prependListener<K>(eventName, listener): this;
        prependOnceListener<K>(eventName, listener): this;
        rawListeners<K>(eventName): Function[];
        removeAllListeners(eventName?): this;
        removeListener<K>(eventName, listener): this;
        setMaxListeners(n): this;
    }

    Hierarchy

    • EventEmitter
      • IWorker

    Properties

    disconnect? +IWorker | poolifier - v4.0.12

    Interface IWorker

    Worker interface.

    +
    interface IWorker {
        disconnect?: (() => void);
        id?: number;
        kill?: ((signal?) => void);
        on: ((event, handler) => this);
        once: ((event, handler) => this);
        terminate?: (() => Promise<number>);
        threadId?: number;
        unref?: (() => void);
        [captureRejectionSymbol]?<K>(error, event, ...args): void;
        addListener<K>(eventName, listener): this;
        emit<K>(eventName, ...args): boolean;
        eventNames(): (string | symbol)[];
        getMaxListeners(): number;
        listenerCount<K>(eventName, listener?): number;
        listeners<K>(eventName): Function[];
        off<K>(eventName, listener): this;
        prependListener<K>(eventName, listener): this;
        prependOnceListener<K>(eventName, listener): this;
        rawListeners<K>(eventName): Function[];
        removeAllListeners(eventName?): this;
        removeListener<K>(eventName, listener): this;
        setMaxListeners(n): this;
    }

    Hierarchy

    • EventEmitter
      • IWorker

    Properties

    disconnect? id? kill? on @@ -22,21 +22,21 @@ removeListener setMaxListeners

    Properties

    Optional Readonly disconnect

    disconnect?: (() => void)

    Cluster worker disconnect.

    -

    Type declaration

      • (): void

      • Returns void

    Optional Readonly id

    id?: number

    Cluster worker id.

    -

    Optional Readonly kill

    kill?: ((signal?) => void)

    Cluster worker kill.

    -

    Type declaration

      • (signal?): void

      • Parameters

        • Optional signal: string

        Returns void

    Readonly on

    on: ((event, handler) => this)

    Registers an event handler.

    +

    Type declaration

      • (): void

      • Returns void

    Optional Readonly id

    id?: number

    Cluster worker id.

    +

    Optional Readonly kill

    kill?: ((signal?) => void)

    Cluster worker kill.

    +

    Type declaration

      • (signal?): void

      • Parameters

        • Optional signal: string

        Returns void

    Readonly on

    on: ((event, handler) => this)

    Registers an event handler.

    Type declaration

      • (event, handler): this

      • Parameters

        Returns this

    Readonly once

    once: ((event, handler) => this)

    Registers once an event handler.

    +

    Returns this

    Readonly once

    once: ((event, handler) => this)

    Registers once an event handler.

    Type declaration

      • (event, handler): this

      • Parameters

        Returns this

    Optional Readonly terminate

    terminate?: (() => Promise<number>)

    Stop all JavaScript execution in the worker thread as soon as possible. +

    Returns this

    Optional Readonly terminate

    terminate?: (() => Promise<number>)

    Stop all JavaScript execution in the worker thread as soon as possible. Returns a Promise for the exit code that is fulfilled when the 'exit' event is emitted.

    -

    Type declaration

      • (): Promise<number>

      • Returns Promise<number>

    Optional Readonly threadId

    threadId?: number

    Worker thread worker id.

    -

    Optional Readonly unref

    unref?: (() => void)

    Calling unref() on a worker allows the thread to exit if this is the only +

    Type declaration

      • (): Promise<number>

      • Returns Promise<number>

    Optional Readonly threadId

    threadId?: number

    Worker thread worker id.

    +

    Optional Readonly unref

    unref?: (() => void)

    Calling unref() on a worker allows the thread to exit if this is the only active handle in the event system. If the worker is already unref()ed callingunref() again has no effect.

    Type declaration

      • (): void

      • Returns void

    Since

    v10.5.0

    -

    Methods

    Optional [captureRejectionSymbol]

    • [captureRejectionSymbol]<K>(error, event, ...args): void

    • Type Parameters

      • K

      Parameters

      • error: Error
      • event: string | symbol
      • Rest ...args: AnyRest

      Returns void

    addListener

    Methods

    Optional [captureRejectionSymbol]

    • [captureRejectionSymbol]<K>(error, event, ...args): void

    • Type Parameters

      • K

      Parameters

      • error: Error
      • event: string | symbol
      • Rest ...args: AnyRest

      Returns void

    addListener

    • addListener<K>(eventName, listener): this

    • Alias for emitter.on(eventName, listener).

      Type Parameters

      • K

      Parameters

      • eventName: string | symbol
      • listener: ((...args) => void)
          • (...args): void

          • Parameters

            • Rest ...args: any[]

            Returns void

      Returns this

      Since

      v0.1.26

    emit

    • emit<K>(eventName, ...args): boolean

    • Synchronously calls each of the listeners registered for the event named eventName, in the order they were registered, passing the supplied arguments to each.

      @@ -123,4 +123,4 @@ memory leaks. The emitter.setMaxListeners() method allows the limit modified for this specific EventEmitter instance. The value can be set to Infinity (or 0) to indicate an unlimited number of listeners.

      Returns a reference to the EventEmitter, so that calls can be chained.

      Parameters

      • n: number

      Returns this

      Since

      v0.3.5

      -

    Settings

    Member Visibility

    Theme

    On This Page

    disconnectidkillononceterminatethreadIdunref[captureRejectionSymbol]addListeneremiteventNamesgetMaxListenerslistenerCountlistenersoffprependListenerprependOnceListenerrawListenersremoveAllListenersremoveListenersetMaxListeners
    \ No newline at end of file +

    Settings

    Member Visibility

    Theme

    On This Page

    disconnectidkillononceterminatethreadIdunref[captureRejectionSymbol]addListeneremiteventNamesgetMaxListenerslistenerCountlistenersoffprependListenerprependOnceListenerrawListenersremoveAllListenersremoveListenersetMaxListeners
    \ No newline at end of file diff --git a/docs/interfaces/IWorkerChoiceStrategy.html b/docs/interfaces/IWorkerChoiceStrategy.html index 5fc54af4..0e789370 100644 --- a/docs/interfaces/IWorkerChoiceStrategy.html +++ b/docs/interfaces/IWorkerChoiceStrategy.html @@ -1,5 +1,5 @@ -IWorkerChoiceStrategy | poolifier - v4.0.11

    Interface IWorkerChoiceStrategyInternal

    Worker choice strategy interface.

    -
    interface IWorkerChoiceStrategy {
        choose: (() => undefined | number);
        remove: ((workerNodeKey) => boolean);
        reset: (() => boolean);
        setOptions: ((opts) => void);
        strategyPolicy: StrategyPolicy;
        taskStatisticsRequirements: TaskStatisticsRequirements;
        update: ((workerNodeKey) => boolean);
    }

    Properties

    choose +IWorkerChoiceStrategy | poolifier - v4.0.12

    Interface IWorkerChoiceStrategyInternal

    Worker choice strategy interface.

    +
    interface IWorkerChoiceStrategy {
        choose: (() => undefined | number);
        remove: ((workerNodeKey) => boolean);
        reset: (() => boolean);
        setOptions: ((opts) => void);
        strategyPolicy: StrategyPolicy;
        taskStatisticsRequirements: TaskStatisticsRequirements;
        update: ((workerNodeKey) => boolean);
    }

    Properties

    choose remove reset setOptions @@ -10,16 +10,16 @@ If no worker nodes are not eligible, undefined is returned. If undefined is returned, the caller retry.

    Type declaration

      • (): undefined | number

      • Returns undefined | number

    Returns

    The worker node key or undefined.

    -

    Readonly remove

    remove: ((workerNodeKey) => boolean)

    Removes the worker node key from strategy internals.

    +

    Readonly remove

    remove: ((workerNodeKey) => boolean)

    Removes the worker node key from strategy internals.

    Type declaration

      • (workerNodeKey): boolean

      • Parameters

        • workerNodeKey: number

          The worker node key.

        Returns boolean

    Returns

    true if the worker node key is removed, false otherwise.

    -

    Readonly reset

    reset: (() => boolean)

    Resets strategy internals.

    +

    Readonly reset

    reset: (() => boolean)

    Resets strategy internals.

    Type declaration

      • (): boolean

      • Returns boolean

    Returns

    true if the reset is successful, false otherwise.

    -

    Readonly setOptions

    setOptions: ((opts) => void)

    Sets the worker choice strategy options.

    +

    Readonly setOptions

    setOptions: ((opts) => void)

    Sets the worker choice strategy options.

    Type declaration

    Readonly strategyPolicy

    strategyPolicy: StrategyPolicy

    Strategy policy.

    -

    Readonly taskStatisticsRequirements

    taskStatisticsRequirements: TaskStatisticsRequirements

    Tasks statistics requirements.

    -

    Readonly update

    update: ((workerNodeKey) => boolean)

    Updates the worker node key strategy internals. +

    Returns void

    Readonly strategyPolicy

    strategyPolicy: StrategyPolicy

    Strategy policy.

    +

    Readonly taskStatisticsRequirements

    taskStatisticsRequirements: TaskStatisticsRequirements

    Tasks statistics requirements.

    +

    Readonly update

    update: ((workerNodeKey) => boolean)

    Updates the worker node key strategy internals. This is called after a task has been executed on a worker node.

    Type declaration

      • (workerNodeKey): boolean

      • Parameters

        • workerNodeKey: number

        Returns boolean

    Returns

    true if the update is successful, false otherwise.

    -

    Settings

    Member Visibility

    Theme

    On This Page

    chooseremoveresetsetOptionsstrategyPolicytaskStatisticsRequirementsupdate
    \ No newline at end of file +

    Settings

    Member Visibility

    Theme

    On This Page

    chooseremoveresetsetOptionsstrategyPolicytaskStatisticsRequirementsupdate
    \ No newline at end of file diff --git a/docs/interfaces/IWorkerNode.html b/docs/interfaces/IWorkerNode.html index ef1a95be..a36a43f7 100644 --- a/docs/interfaces/IWorkerNode.html +++ b/docs/interfaces/IWorkerNode.html @@ -1,7 +1,7 @@ -IWorkerNode | poolifier - v4.0.11

    Interface IWorkerNode<Worker, Data>Internal

    Worker node interface.

    +IWorkerNode | poolifier - v4.0.12

    Interface IWorkerNode<Worker, Data>Internal

    Worker node interface.

    interface IWorkerNode<Worker, Data> {
        clearTasksQueue: (() => void);
        deleteTaskFunctionWorkerUsage: ((name) => boolean);
        dequeueLastPrioritizedTask: (() => undefined | Task<Data>);
        dequeueTask: ((bucket?) => undefined | Task<Data>);
        enqueueTask: ((task) => number);
        getTaskFunctionWorkerUsage: ((name) => undefined | WorkerUsage);
        hasBackPressure: (() => boolean);
        info: WorkerInfo;
        messageChannel?: MessageChannel;
        registerOnceWorkerEventHandler: ((event, handler) => void);
        registerWorkerEventHandler: ((event, handler) => void);
        strategyData?: StrategyData;
        tasksQueueBackPressureSize: number;
        tasksQueueSize: (() => number);
        terminate: (() => Promise<void>);
        usage: WorkerUsage;
        worker: Worker;
        [captureRejectionSymbol]?<K>(error, event, ...args): void;
        addListener<K>(eventName, listener): this;
        emit<K>(eventName, ...args): boolean;
        eventNames(): (string | symbol)[];
        getMaxListeners(): number;
        listenerCount<K>(eventName, listener?): number;
        listeners<K>(eventName): Function[];
        off<K>(eventName, listener): this;
        on<K>(eventName, listener): this;
        once<K>(eventName, listener): this;
        prependListener<K>(eventName, listener): this;
        prependOnceListener<K>(eventName, listener): this;
        rawListeners<K>(eventName): Function[];
        removeAllListeners(eventName?): this;
        removeListener<K>(eventName, listener): this;
        setMaxListeners(n): this;
    }

    Type Parameters

    • Worker extends IWorker

      Type of worker.

    • Data = unknown

      Type of data sent to the worker. This can only be structured-cloneable data.

      -

    Hierarchy

    • EventEmitter
      • IWorkerNode

    Properties

    clearTasksQueue +

    Hierarchy

    • EventEmitter
      • IWorkerNode

    Properties

    clearTasksQueue deleteTaskFunctionWorkerUsage dequeueLastPrioritizedTask dequeueTask @@ -35,42 +35,42 @@ removeListener setMaxListeners

    Properties

    Readonly clearTasksQueue

    clearTasksQueue: (() => void)

    Clears tasks queue.

    -

    Type declaration

      • (): void

      • Returns void

    Readonly deleteTaskFunctionWorkerUsage

    deleteTaskFunctionWorkerUsage: ((name) => boolean)

    Deletes task function worker usage statistics.

    +

    Type declaration

      • (): void

      • Returns void

    Readonly deleteTaskFunctionWorkerUsage

    deleteTaskFunctionWorkerUsage: ((name) => boolean)

    Deletes task function worker usage statistics.

    Type declaration

      • (name): boolean

      • Parameters

        • name: string

          The task function name.

        Returns boolean

    Returns

    true if the task function worker usage statistics were deleted, false otherwise.

    -

    Readonly dequeueLastPrioritizedTask

    dequeueLastPrioritizedTask: (() => undefined | Task<Data>)

    Dequeue last prioritized task.

    +

    Readonly dequeueLastPrioritizedTask

    dequeueLastPrioritizedTask: (() => undefined | Task<Data>)

    Dequeue last prioritized task.

    Type declaration

    Returns

    The dequeued task.

    -

    Readonly dequeueTask

    dequeueTask: ((bucket?) => undefined | Task<Data>)

    Dequeue task.

    +

    Readonly dequeueTask

    dequeueTask: ((bucket?) => undefined | Task<Data>)

    Dequeue task.

    Type declaration

      • (bucket?): undefined | Task<Data>

      • Parameters

        • Optional bucket: number

          The prioritized bucket to dequeue from.

        Returns undefined | Task<Data>

    Default Value

    0

    Returns

    The dequeued task.

    -

    Readonly enqueueTask

    enqueueTask: ((task) => number)

    Enqueue task.

    +

    Readonly enqueueTask

    enqueueTask: ((task) => number)

    Enqueue task.

    Type declaration

      • (task): number

      • Parameters

        Returns number

    Returns

    The tasks queue size.

    -

    Readonly getTaskFunctionWorkerUsage

    getTaskFunctionWorkerUsage: ((name) => undefined | WorkerUsage)

    Gets task function worker usage statistics.

    +

    Readonly getTaskFunctionWorkerUsage

    getTaskFunctionWorkerUsage: ((name) => undefined | WorkerUsage)

    Gets task function worker usage statistics.

    Type declaration

    Returns

    The task function worker usage statistics if the task function worker usage statistics are initialized, undefined otherwise.

    -

    Readonly hasBackPressure

    hasBackPressure: (() => boolean)

    Whether the worker node has back pressure (i.e. its tasks queue is full).

    +

    Readonly hasBackPressure

    hasBackPressure: (() => boolean)

    Whether the worker node has back pressure (i.e. its tasks queue is full).

    Type declaration

      • (): boolean

      • Returns boolean

    Returns

    true if the worker node has back pressure, false otherwise.

    -

    Readonly info

    info: WorkerInfo

    Worker info.

    -

    Optional Readonly messageChannel

    messageChannel?: MessageChannel

    Message channel (worker thread only).

    -

    Readonly registerOnceWorkerEventHandler

    registerOnceWorkerEventHandler: ((event, handler) => void)

    Registers once a worker event handler.

    +

    Readonly info

    info: WorkerInfo

    Worker info.

    +

    Optional Readonly messageChannel

    messageChannel?: MessageChannel

    Message channel (worker thread only).

    +

    Readonly registerOnceWorkerEventHandler

    registerOnceWorkerEventHandler: ((event, handler) => void)

    Registers once a worker event handler.

    Type declaration

      • (event, handler): void

      • Parameters

        Returns void

    Readonly registerWorkerEventHandler

    registerWorkerEventHandler: ((event, handler) => void)

    Registers a worker event handler.

    +

    Returns void

    Readonly registerWorkerEventHandler

    registerWorkerEventHandler: ((event, handler) => void)

    Registers a worker event handler.

    Type declaration

      • (event, handler): void

      • Parameters

        Returns void

    Optional strategyData

    strategyData?: StrategyData

    Worker choice strategy data. +

    Returns void

    Optional strategyData

    strategyData?: StrategyData

    Worker choice strategy data. This is used to store data that are specific to the worker choice strategy.

    -

    tasksQueueBackPressureSize

    tasksQueueBackPressureSize: number

    Tasks queue back pressure size. +

    tasksQueueBackPressureSize

    tasksQueueBackPressureSize: number

    Tasks queue back pressure size. This is the number of tasks that can be enqueued before the worker node has back pressure.

    -

    Readonly tasksQueueSize

    tasksQueueSize: (() => number)

    Tasks queue size.

    +

    Readonly tasksQueueSize

    tasksQueueSize: (() => number)

    Tasks queue size.

    Type declaration

      • (): number

      • Returns number

    Returns

    The tasks queue size.

    -

    Readonly terminate

    terminate: (() => Promise<void>)

    Terminates the worker node.

    -

    Type declaration

      • (): Promise<void>

      • Returns Promise<void>

    Readonly usage

    usage: WorkerUsage

    Worker usage statistics.

    -

    Readonly worker

    worker: Worker

    Worker.

    -

    Methods

    Optional [captureRejectionSymbol]

    • [captureRejectionSymbol]<K>(error, event, ...args): void

    • Type Parameters

      • K

      Parameters

      • error: Error
      • event: string | symbol
      • Rest ...args: AnyRest

      Returns void

    addListener

    Readonly terminate

    terminate: (() => Promise<void>)

    Terminates the worker node.

    +

    Type declaration

      • (): Promise<void>

      • Returns Promise<void>

    Readonly usage

    usage: WorkerUsage

    Worker usage statistics.

    +

    Readonly worker

    worker: Worker

    Worker.

    +

    Methods

    Optional [captureRejectionSymbol]

    • [captureRejectionSymbol]<K>(error, event, ...args): void

    • Type Parameters

      • K

      Parameters

      • error: Error
      • event: string | symbol
      • Rest ...args: AnyRest

      Returns void

    addListener

    • addListener<K>(eventName, listener): this

    • Alias for emitter.on(eventName, listener).

      Type Parameters

      • K

      Parameters

      • eventName: string | symbol
      • listener: ((...args) => void)
          • (...args): void

          • Parameters

            • Rest ...args: any[]

            Returns void

      Returns this

      Since

      v0.1.26

    emit

    • emit<K>(eventName, ...args): boolean

    • Synchronously calls each of the listeners registered for the event named eventName, in the order they were registered, passing the supplied arguments to each.

      @@ -183,4 +183,4 @@ memory leaks. The emitter.setMaxListeners() method allows the limit modified for this specific EventEmitter instance. The value can be set to Infinity (or 0) to indicate an unlimited number of listeners.

      Returns a reference to the EventEmitter, so that calls can be chained.

      Parameters

      • n: number

      Returns this

      Since

      v0.3.5

      -

    Settings

    Member Visibility

    Theme

    On This Page

    clearTasksQueuedeleteTaskFunctionWorkerUsagedequeueLastPrioritizedTaskdequeueTaskenqueueTaskgetTaskFunctionWorkerUsagehasBackPressureinfomessageChannelregisterOnceWorkerEventHandlerregisterWorkerEventHandlerstrategyDatatasksQueueBackPressureSizetasksQueueSizeterminateusageworker[captureRejectionSymbol]addListeneremiteventNamesgetMaxListenerslistenerCountlistenersoffononceprependListenerprependOnceListenerrawListenersremoveAllListenersremoveListenersetMaxListeners
    \ No newline at end of file +

    Settings

    Member Visibility

    Theme

    On This Page

    clearTasksQueuedeleteTaskFunctionWorkerUsagedequeueLastPrioritizedTaskdequeueTaskenqueueTaskgetTaskFunctionWorkerUsagehasBackPressureinfomessageChannelregisterOnceWorkerEventHandlerregisterWorkerEventHandlerstrategyDatatasksQueueBackPressureSizetasksQueueSizeterminateusageworker[captureRejectionSymbol]addListeneremiteventNamesgetMaxListenerslistenerCountlistenersoffononceprependListenerprependOnceListenerrawListenersremoveAllListenersremoveListenersetMaxListeners
    \ No newline at end of file diff --git a/docs/interfaces/MeasurementOptions.html b/docs/interfaces/MeasurementOptions.html index 9f1a5324..540dd2b2 100644 --- a/docs/interfaces/MeasurementOptions.html +++ b/docs/interfaces/MeasurementOptions.html @@ -1,4 +1,4 @@ -MeasurementOptions | poolifier - v4.0.11

    Interface MeasurementOptions

    Measurement options.

    -
    interface MeasurementOptions {
        median: boolean;
    }

    Properties

    median +MeasurementOptions | poolifier - v4.0.12

    Interface MeasurementOptions

    Measurement options.

    +
    interface MeasurementOptions {
        median: boolean;
    }

    Properties

    median

    Properties

    Readonly median

    median: boolean

    Set measurement median.

    -

    Settings

    Member Visibility

    Theme

    On This Page

    median
    \ No newline at end of file +

    Settings

    Member Visibility

    Theme

    On This Page

    median
    \ No newline at end of file diff --git a/docs/interfaces/MeasurementStatistics.html b/docs/interfaces/MeasurementStatistics.html index f69df114..b649cc82 100644 --- a/docs/interfaces/MeasurementStatistics.html +++ b/docs/interfaces/MeasurementStatistics.html @@ -1,14 +1,14 @@ -MeasurementStatistics | poolifier - v4.0.11

    Interface MeasurementStatisticsInternal

    Measurement statistics.

    -
    interface MeasurementStatistics {
        aggregate?: number;
        average?: number;
        history: CircularBuffer<number>;
        maximum?: number;
        median?: number;
        minimum?: number;
    }

    Properties

    aggregate? +MeasurementStatistics | poolifier - v4.0.12

    Interface MeasurementStatisticsInternal

    Measurement statistics.

    +
    interface MeasurementStatistics {
        aggregate?: number;
        average?: number;
        history: CircularBuffer;
        maximum?: number;
        median?: number;
        minimum?: number;
    }

    Properties

    aggregate? average? history maximum? median? minimum?

    Properties

    Optional aggregate

    aggregate?: number

    Measurement aggregate.

    -

    Optional average

    average?: number

    Measurement average.

    -

    Readonly history

    history: CircularBuffer<number>

    Measurement history.

    -

    Optional maximum

    maximum?: number

    Measurement maximum.

    -

    Optional median

    median?: number

    Measurement median.

    -

    Optional minimum

    minimum?: number

    Measurement minimum.

    -

    Settings

    Member Visibility

    Theme

    On This Page

    aggregateaveragehistorymaximummedianminimum
    \ No newline at end of file +

    Optional average

    average?: number

    Measurement average.

    +

    Readonly history

    history: CircularBuffer

    Measurement history.

    +

    Optional maximum

    maximum?: number

    Measurement maximum.

    +

    Optional median

    median?: number

    Measurement median.

    +

    Optional minimum

    minimum?: number

    Measurement minimum.

    +

    Settings

    Member Visibility

    Theme

    On This Page

    aggregateaveragehistorymaximummedianminimum
    \ No newline at end of file diff --git a/docs/interfaces/MeasurementStatisticsRequirements.html b/docs/interfaces/MeasurementStatisticsRequirements.html index 46c2900f..f5479d35 100644 --- a/docs/interfaces/MeasurementStatisticsRequirements.html +++ b/docs/interfaces/MeasurementStatisticsRequirements.html @@ -1,8 +1,8 @@ -MeasurementStatisticsRequirements | poolifier - v4.0.11

    Interface MeasurementStatisticsRequirementsInternal

    Measurement statistics requirements.

    -
    interface MeasurementStatisticsRequirements {
        aggregate: boolean;
        average: boolean;
        median: boolean;
    }

    Properties

    aggregate +MeasurementStatisticsRequirements | poolifier - v4.0.12

    Interface MeasurementStatisticsRequirementsInternal

    Measurement statistics requirements.

    +
    interface MeasurementStatisticsRequirements {
        aggregate: boolean;
        average: boolean;
        median: boolean;
    }

    Properties

    aggregate average median

    Properties

    aggregate

    aggregate: boolean

    Requires measurement aggregate.

    -

    average

    average: boolean

    Requires measurement average.

    -

    median

    median: boolean

    Requires measurement median.

    -

    Settings

    Member Visibility

    Theme

    On This Page

    aggregateaveragemedian
    \ No newline at end of file +

    average

    average: boolean

    Requires measurement average.

    +

    median

    median: boolean

    Requires measurement median.

    +

    Settings

    Member Visibility

    Theme

    On This Page

    aggregateaveragemedian
    \ No newline at end of file diff --git a/docs/interfaces/MessageValue.html b/docs/interfaces/MessageValue.html index 9b81cccd..eb671776 100644 --- a/docs/interfaces/MessageValue.html +++ b/docs/interfaces/MessageValue.html @@ -1,7 +1,7 @@ -MessageValue | poolifier - v4.0.11

    Interface MessageValue<Data, ErrorData>Internal

    Message object that is passed between main worker and worker.

    +MessageValue | poolifier - v4.0.12

    Interface MessageValue<Data, ErrorData>Internal

    Message object that is passed between main worker and worker.

    interface MessageValue<Data, ErrorData> {
        checkActive?: boolean;
        data?: Data;
        kill?: true | "success" | "SOFT" | "HARD" | "failure";
        name?: string;
        port?: MessagePort;
        priority?: number;
        ready?: boolean;
        statistics?: WorkerStatistics;
        strategy?: "ROUND_ROBIN" | "LEAST_USED" | "LEAST_BUSY" | "LEAST_ELU" | "FAIR_SHARE" | "WEIGHTED_ROUND_ROBIN" | "INTERLEAVED_WEIGHTED_ROUND_ROBIN";
        taskFunction?: string;
        taskFunctionOperation?: "add" | "default" | "remove";
        taskFunctionOperationStatus?: boolean;
        taskFunctionProperties?: TaskFunctionProperties;
        taskFunctionsProperties?: TaskFunctionProperties[];
        taskId?: `${string}-${string}-${string}-${string}-${string}`;
        taskPerformance?: TaskPerformance;
        timestamp?: number;
        transferList?: readonly TransferListItem[];
        workerError?: WorkerError<ErrorData>;
        workerId?: number;
    }

    Type Parameters

    • Data = unknown

      Type of data sent to the worker or execution response. This can only be structured-cloneable data.

    • ErrorData = unknown

      Type of data sent to the worker triggering an error. This can only be structured-cloneable data.

      -

    Hierarchy (view full)

    Properties

    checkActive? +

    Hierarchy (view full)

    Properties

    checkActive? data? kill? name? @@ -22,30 +22,30 @@ workerError? workerId?

    Properties

    Optional Readonly checkActive

    checkActive?: boolean

    Whether the worker starts or stops its activity check.

    -

    Optional Readonly data

    data?: Data

    Task input data that will be passed to the worker.

    -

    Optional Readonly kill

    kill?: true | "success" | "SOFT" | "HARD" | "failure"

    Kill code.

    -

    Optional Readonly name

    name?: string

    Task name.

    -

    Optional Readonly port

    port?: MessagePort

    Message port.

    -

    Optional Readonly priority

    priority?: number

    Task priority. Lower values have higher priority.

    +

    Optional Readonly data

    data?: Data

    Task input data that will be passed to the worker.

    +

    Optional Readonly kill

    kill?: true | "success" | "SOFT" | "HARD" | "failure"

    Kill code.

    +

    Optional Readonly name

    name?: string

    Task name.

    +

    Optional Readonly port

    port?: MessagePort

    Message port.

    +

    Optional Readonly priority

    priority?: number

    Task priority. Lower values have higher priority.

    Default Value

    0
    -

    Optional Readonly ready

    ready?: boolean

    Whether the worker is ready or not.

    -

    Optional Readonly statistics

    statistics?: WorkerStatistics

    Whether the worker computes the given statistics or not.

    -

    Optional Readonly strategy

    strategy?: "ROUND_ROBIN" | "LEAST_USED" | "LEAST_BUSY" | "LEAST_ELU" | "FAIR_SHARE" | "WEIGHTED_ROUND_ROBIN" | "INTERLEAVED_WEIGHTED_ROUND_ROBIN"

    Task worker choice strategy.

    -

    Optional Readonly taskFunction

    taskFunction?: string

    Task function serialized to string.

    -

    Optional Readonly taskFunctionOperation

    taskFunctionOperation?: "add" | "default" | "remove"

    Task function operation:

    +

    Optional Readonly ready

    ready?: boolean

    Whether the worker is ready or not.

    +

    Optional Readonly statistics

    statistics?: WorkerStatistics

    Whether the worker computes the given statistics or not.

    +

    Optional Readonly strategy

    strategy?: "ROUND_ROBIN" | "LEAST_USED" | "LEAST_BUSY" | "LEAST_ELU" | "FAIR_SHARE" | "WEIGHTED_ROUND_ROBIN" | "INTERLEAVED_WEIGHTED_ROUND_ROBIN"

    Task worker choice strategy.

    +

    Optional Readonly taskFunction

    taskFunction?: string

    Task function serialized to string.

    +

    Optional Readonly taskFunctionOperation

    taskFunctionOperation?: "add" | "default" | "remove"

    Task function operation:

    • 'add' - Add a task function.
    • 'remove' - Remove a task function.
    • 'default' - Set a task function as default.
    -

    Optional Readonly taskFunctionOperationStatus

    taskFunctionOperationStatus?: boolean

    Whether the task function operation is successful or not.

    -

    Optional Readonly taskFunctionProperties

    taskFunctionProperties?: TaskFunctionProperties

    Task function properties.

    -

    Optional Readonly taskFunctionsProperties

    taskFunctionsProperties?: TaskFunctionProperties[]

    Task functions properties.

    -

    Optional Readonly taskId

    taskId?: `${string}-${string}-${string}-${string}-${string}`

    Task UUID.

    -

    Optional Readonly taskPerformance

    taskPerformance?: TaskPerformance

    Task performance.

    -

    Optional Readonly timestamp

    timestamp?: number

    Timestamp.

    -

    Optional Readonly transferList

    transferList?: readonly TransferListItem[]

    Array of transferable objects.

    -

    Optional Readonly workerError

    workerError?: WorkerError<ErrorData>

    Worker error.

    -

    Optional Readonly workerId

    workerId?: number

    Worker id.

    -

    Settings

    Member Visibility

    Theme

    On This Page

    checkActivedatakillnameportpriorityreadystatisticsstrategytaskFunctiontaskFunctionOperationtaskFunctionOperationStatustaskFunctionPropertiestaskFunctionsPropertiestaskIdtaskPerformancetimestamptransferListworkerErrorworkerId
    \ No newline at end of file +

    Optional Readonly taskFunctionOperationStatus

    taskFunctionOperationStatus?: boolean

    Whether the task function operation is successful or not.

    +

    Optional Readonly taskFunctionProperties

    taskFunctionProperties?: TaskFunctionProperties

    Task function properties.

    +

    Optional Readonly taskFunctionsProperties

    taskFunctionsProperties?: TaskFunctionProperties[]

    Task functions properties.

    +

    Optional Readonly taskId

    taskId?: `${string}-${string}-${string}-${string}-${string}`

    Task UUID.

    +

    Optional Readonly taskPerformance

    taskPerformance?: TaskPerformance

    Task performance.

    +

    Optional Readonly timestamp

    timestamp?: number

    Timestamp.

    +

    Optional Readonly transferList

    transferList?: readonly TransferListItem[]

    Array of transferable objects.

    +

    Optional Readonly workerError

    workerError?: WorkerError<ErrorData>

    Worker error.

    +

    Optional Readonly workerId

    workerId?: number

    Worker id.

    +

    Settings

    Member Visibility

    Theme

    On This Page

    checkActivedatakillnameportpriorityreadystatisticsstrategytaskFunctiontaskFunctionOperationtaskFunctionOperationStatustaskFunctionPropertiestaskFunctionsPropertiestaskIdtaskPerformancetimestamptransferListworkerErrorworkerId
    \ No newline at end of file diff --git a/docs/interfaces/PoolInfo.html b/docs/interfaces/PoolInfo.html index 3b1eebcc..fff37404 100644 --- a/docs/interfaces/PoolInfo.html +++ b/docs/interfaces/PoolInfo.html @@ -1,5 +1,5 @@ -PoolInfo | poolifier - v4.0.11

    Interface PoolInfo

    Pool information.

    -
    interface PoolInfo {
        backPressure?: boolean;
        busyWorkerNodes: number;
        defaultStrategy: "ROUND_ROBIN" | "LEAST_USED" | "LEAST_BUSY" | "LEAST_ELU" | "FAIR_SHARE" | "WEIGHTED_ROUND_ROBIN" | "INTERLEAVED_WEIGHTED_ROUND_ROBIN";
        elu?: {
            active: {
                average?: number;
                maximum: number;
                median?: number;
                minimum: number;
            };
            idle: {
                average?: number;
                maximum: number;
                median?: number;
                minimum: number;
            };
            utilization: {
                average?: number;
                median?: number;
            };
        };
        executedTasks: number;
        executingTasks: number;
        failedTasks: number;
        idleWorkerNodes: number;
        maxQueuedTasks?: number;
        maxSize: number;
        minSize: number;
        queuedTasks?: number;
        ready: boolean;
        runTime?: {
            average?: number;
            maximum: number;
            median?: number;
            minimum: number;
        };
        started: boolean;
        stealingWorkerNodes?: number;
        stolenTasks?: number;
        strategyRetries: number;
        type: "fixed" | "dynamic";
        utilization?: number;
        version: string;
        waitTime?: {
            average?: number;
            maximum: number;
            median?: number;
            minimum: number;
        };
        worker: "thread" | "cluster";
        workerNodes: number;
    }

    Properties

    backPressure? +PoolInfo | poolifier - v4.0.12

    Interface PoolInfo

    Pool information.

    +
    interface PoolInfo {
        backPressure?: boolean;
        busyWorkerNodes: number;
        defaultStrategy: "ROUND_ROBIN" | "LEAST_USED" | "LEAST_BUSY" | "LEAST_ELU" | "FAIR_SHARE" | "WEIGHTED_ROUND_ROBIN" | "INTERLEAVED_WEIGHTED_ROUND_ROBIN";
        elu?: {
            active: {
                average?: number;
                maximum: number;
                median?: number;
                minimum: number;
            };
            idle: {
                average?: number;
                maximum: number;
                median?: number;
                minimum: number;
            };
            utilization: {
                average?: number;
                median?: number;
            };
        };
        executedTasks: number;
        executingTasks: number;
        failedTasks: number;
        idleWorkerNodes: number;
        maxQueuedTasks?: number;
        maxSize: number;
        minSize: number;
        queuedTasks?: number;
        ready: boolean;
        runTime?: {
            average?: number;
            maximum: number;
            median?: number;
            minimum: number;
        };
        started: boolean;
        stealingWorkerNodes?: number;
        stolenTasks?: number;
        strategyRetries: number;
        type: "fixed" | "dynamic";
        utilization?: number;
        version: string;
        waitTime?: {
            average?: number;
            maximum: number;
            median?: number;
            minimum: number;
        };
        worker: "thread" | "cluster";
        workerNodes: number;
    }

    Properties

    backPressure? busyWorkerNodes defaultStrategy elu? @@ -23,9 +23,9 @@ waitTime? worker workerNodes -

    Properties

    Optional Readonly backPressure

    backPressure?: boolean

    Readonly busyWorkerNodes

    busyWorkerNodes: number

    Pool busy worker nodes.

    -

    Readonly defaultStrategy

    defaultStrategy: "ROUND_ROBIN" | "LEAST_USED" | "LEAST_BUSY" | "LEAST_ELU" | "FAIR_SHARE" | "WEIGHTED_ROUND_ROBIN" | "INTERLEAVED_WEIGHTED_ROUND_ROBIN"

    Optional Readonly elu

    elu?: {
        active: {
            average?: number;
            maximum: number;
            median?: number;
            minimum: number;
        };
        idle: {
            average?: number;
            maximum: number;
            median?: number;
            minimum: number;
        };
        utilization: {
            average?: number;
            median?: number;
        };
    }

    Type declaration

    • active: {
          average?: number;
          maximum: number;
          median?: number;
          minimum: number;
      }
      • Optional Readonly average?: number
      • Readonly maximum: number
      • Optional Readonly median?: number
      • Readonly minimum: number
    • idle: {
          average?: number;
          maximum: number;
          median?: number;
          minimum: number;
      }
      • Optional Readonly average?: number
      • Readonly maximum: number
      • Optional Readonly median?: number
      • Readonly minimum: number
    • utilization: {
          average?: number;
          median?: number;
      }
      • Optional Readonly average?: number
      • Optional Readonly median?: number

    Readonly executedTasks

    executedTasks: number

    Readonly executingTasks

    executingTasks: number

    Readonly failedTasks

    failedTasks: number

    Readonly idleWorkerNodes

    idleWorkerNodes: number

    Pool idle worker nodes.

    -

    Optional Readonly maxQueuedTasks

    maxQueuedTasks?: number

    Readonly maxSize

    maxSize: number

    Readonly minSize

    minSize: number

    Optional Readonly queuedTasks

    queuedTasks?: number

    Readonly ready

    ready: boolean

    Optional Readonly runTime

    runTime?: {
        average?: number;
        maximum: number;
        median?: number;
        minimum: number;
    }

    Type declaration

    • Optional Readonly average?: number
    • Readonly maximum: number
    • Optional Readonly median?: number
    • Readonly minimum: number

    Readonly started

    started: boolean

    Optional Readonly stealingWorkerNodes

    stealingWorkerNodes?: number

    Pool stealing worker nodes.

    -

    Optional Readonly stolenTasks

    stolenTasks?: number

    Readonly strategyRetries

    strategyRetries: number

    Readonly type

    type: "fixed" | "dynamic"

    Optional Readonly utilization

    utilization?: number

    Pool utilization.

    -

    Readonly version

    version: string

    Optional Readonly waitTime

    waitTime?: {
        average?: number;
        maximum: number;
        median?: number;
        minimum: number;
    }

    Type declaration

    • Optional Readonly average?: number
    • Readonly maximum: number
    • Optional Readonly median?: number
    • Readonly minimum: number

    Readonly worker

    worker: "thread" | "cluster"

    Readonly workerNodes

    workerNodes: number

    Pool total worker nodes.

    -

    Settings

    Member Visibility

    Theme

    On This Page

    backPressurebusyWorkerNodesdefaultStrategyeluexecutedTasksexecutingTasksfailedTasksidleWorkerNodesmaxQueuedTasksmaxSizeminSizequeuedTasksreadyrunTimestartedstealingWorkerNodesstolenTasksstrategyRetriestypeutilizationversionwaitTimeworkerworkerNodes
    \ No newline at end of file +

    Properties

    Optional Readonly backPressure

    backPressure?: boolean

    Readonly busyWorkerNodes

    busyWorkerNodes: number

    Pool busy worker nodes.

    +

    Readonly defaultStrategy

    defaultStrategy: "ROUND_ROBIN" | "LEAST_USED" | "LEAST_BUSY" | "LEAST_ELU" | "FAIR_SHARE" | "WEIGHTED_ROUND_ROBIN" | "INTERLEAVED_WEIGHTED_ROUND_ROBIN"

    Optional Readonly elu

    elu?: {
        active: {
            average?: number;
            maximum: number;
            median?: number;
            minimum: number;
        };
        idle: {
            average?: number;
            maximum: number;
            median?: number;
            minimum: number;
        };
        utilization: {
            average?: number;
            median?: number;
        };
    }

    Type declaration

    • active: {
          average?: number;
          maximum: number;
          median?: number;
          minimum: number;
      }
      • Optional Readonly average?: number
      • Readonly maximum: number
      • Optional Readonly median?: number
      • Readonly minimum: number
    • idle: {
          average?: number;
          maximum: number;
          median?: number;
          minimum: number;
      }
      • Optional Readonly average?: number
      • Readonly maximum: number
      • Optional Readonly median?: number
      • Readonly minimum: number
    • utilization: {
          average?: number;
          median?: number;
      }
      • Optional Readonly average?: number
      • Optional Readonly median?: number

    Readonly executedTasks

    executedTasks: number

    Readonly executingTasks

    executingTasks: number

    Readonly failedTasks

    failedTasks: number

    Readonly idleWorkerNodes

    idleWorkerNodes: number

    Pool idle worker nodes.

    +

    Optional Readonly maxQueuedTasks

    maxQueuedTasks?: number

    Readonly maxSize

    maxSize: number

    Readonly minSize

    minSize: number

    Optional Readonly queuedTasks

    queuedTasks?: number

    Readonly ready

    ready: boolean

    Optional Readonly runTime

    runTime?: {
        average?: number;
        maximum: number;
        median?: number;
        minimum: number;
    }

    Type declaration

    • Optional Readonly average?: number
    • Readonly maximum: number
    • Optional Readonly median?: number
    • Readonly minimum: number

    Readonly started

    started: boolean

    Optional Readonly stealingWorkerNodes

    stealingWorkerNodes?: number

    Pool stealing worker nodes.

    +

    Optional Readonly stolenTasks

    stolenTasks?: number

    Readonly strategyRetries

    strategyRetries: number

    Readonly type

    type: "fixed" | "dynamic"

    Optional Readonly utilization

    utilization?: number

    Pool utilization.

    +

    Readonly version

    version: string

    Optional Readonly waitTime

    waitTime?: {
        average?: number;
        maximum: number;
        median?: number;
        minimum: number;
    }

    Type declaration

    • Optional Readonly average?: number
    • Readonly maximum: number
    • Optional Readonly median?: number
    • Readonly minimum: number

    Readonly worker

    worker: "thread" | "cluster"

    Readonly workerNodes

    workerNodes: number

    Pool total worker nodes.

    +

    Settings

    Member Visibility

    Theme

    On This Page

    backPressurebusyWorkerNodesdefaultStrategyeluexecutedTasksexecutingTasksfailedTasksidleWorkerNodesmaxQueuedTasksmaxSizeminSizequeuedTasksreadyrunTimestartedstealingWorkerNodesstolenTasksstrategyRetriestypeutilizationversionwaitTimeworkerworkerNodes
    \ No newline at end of file diff --git a/docs/interfaces/PoolOptions.html b/docs/interfaces/PoolOptions.html index 2ebe13ff..46498cd5 100644 --- a/docs/interfaces/PoolOptions.html +++ b/docs/interfaces/PoolOptions.html @@ -1,6 +1,6 @@ -PoolOptions | poolifier - v4.0.11

    Interface PoolOptions<Worker>

    Options for a poolifier pool.

    +PoolOptions | poolifier - v4.0.12

    Interface PoolOptions<Worker>

    Options for a poolifier pool.

    interface PoolOptions<Worker> {
        enableEvents?: boolean;
        enableTasksQueue?: boolean;
        env?: Record<string, unknown>;
        errorHandler?: ErrorHandler<Worker>;
        exitHandler?: ExitHandler<Worker>;
        messageHandler?: MessageHandler<Worker>;
        onlineHandler?: OnlineHandler<Worker>;
        restartWorkerOnError?: boolean;
        settings?: ClusterSettings;
        startWorkers?: boolean;
        tasksQueueOptions?: TasksQueueOptions;
        workerChoiceStrategy?: "ROUND_ROBIN" | "LEAST_USED" | "LEAST_BUSY" | "LEAST_ELU" | "FAIR_SHARE" | "WEIGHTED_ROUND_ROBIN" | "INTERLEAVED_WEIGHTED_ROUND_ROBIN";
        workerChoiceStrategyOptions?: WorkerChoiceStrategyOptions;
        workerOptions?: WorkerOptions;
    }

    Type Parameters

    • Worker extends IWorker

      Type of worker.

      -

    Properties

    enableEvents? +

    Properties

    enableEvents? enableTasksQueue? env? errorHandler? @@ -17,30 +17,30 @@

    Properties

    Optional enableEvents

    enableEvents?: boolean

    Pool events integrated with async resource emission.

    Default Value

    true
    -

    Optional enableTasksQueue

    enableTasksQueue?: boolean

    Pool worker node tasks queue.

    +

    Optional enableTasksQueue

    enableTasksQueue?: boolean

    Pool worker node tasks queue.

    Default Value

    false
    -

    Optional env

    env?: Record<string, unknown>

    Key/value pairs to add to worker process environment.

    +

    Optional env

    env?: Record<string, unknown>

    Key/value pairs to add to worker process environment.

    See

    https://nodejs.org/api/cluster.html#cluster_cluster_fork_env

    -

    Optional errorHandler

    errorHandler?: ErrorHandler<Worker>

    A function that will listen for error event on each worker.

    +

    Optional errorHandler

    errorHandler?: ErrorHandler<Worker>

    A function that will listen for error event on each worker.

    Default Value

    () => {}

    -

    Optional exitHandler

    exitHandler?: ExitHandler<Worker>

    A function that will listen for exit event on each worker.

    +

    Optional exitHandler

    exitHandler?: ExitHandler<Worker>

    A function that will listen for exit event on each worker.

    Default Value

    () => {}

    -

    Optional messageHandler

    messageHandler?: MessageHandler<Worker>

    A function that will listen for message event on each worker.

    +

    Optional messageHandler

    messageHandler?: MessageHandler<Worker>

    A function that will listen for message event on each worker.

    Default Value

    () => {}

    -

    Optional onlineHandler

    onlineHandler?: OnlineHandler<Worker>

    A function that will listen for online event on each worker.

    +

    Optional onlineHandler

    onlineHandler?: OnlineHandler<Worker>

    A function that will listen for online event on each worker.

    Default Value

    () => {}

    -

    Optional restartWorkerOnError

    restartWorkerOnError?: boolean

    Restart worker on error.

    -

    Optional settings

    settings?: ClusterSettings

    Cluster settings.

    +

    Optional restartWorkerOnError

    restartWorkerOnError?: boolean

    Restart worker on error.

    +

    Optional settings

    settings?: ClusterSettings

    Cluster settings.

    See

    https://nodejs.org/api/cluster.html#cluster_cluster_settings

    -

    Optional startWorkers

    startWorkers?: boolean

    Whether to start the minimum number of workers at pool initialization.

    +

    Optional startWorkers

    startWorkers?: boolean

    Whether to start the minimum number of workers at pool initialization.

    Default Value

    true
    -

    Optional tasksQueueOptions

    tasksQueueOptions?: TasksQueueOptions

    Pool worker node tasks queue options.

    -

    Optional workerChoiceStrategy

    workerChoiceStrategy?: "ROUND_ROBIN" | "LEAST_USED" | "LEAST_BUSY" | "LEAST_ELU" | "FAIR_SHARE" | "WEIGHTED_ROUND_ROBIN" | "INTERLEAVED_WEIGHTED_ROUND_ROBIN"

    The default worker choice strategy to use in this pool.

    +

    Optional tasksQueueOptions

    tasksQueueOptions?: TasksQueueOptions

    Pool worker node tasks queue options.

    +

    Optional workerChoiceStrategy

    workerChoiceStrategy?: "ROUND_ROBIN" | "LEAST_USED" | "LEAST_BUSY" | "LEAST_ELU" | "FAIR_SHARE" | "WEIGHTED_ROUND_ROBIN" | "INTERLEAVED_WEIGHTED_ROUND_ROBIN"

    The default worker choice strategy to use in this pool.

    Default Value

    WorkerChoiceStrategies.ROUND_ROBIN
    -

    Optional workerChoiceStrategyOptions

    workerChoiceStrategyOptions?: WorkerChoiceStrategyOptions

    The worker choice strategy options.

    -

    Optional workerOptions

    workerOptions?: WorkerOptions

    Worker options.

    +

    Optional workerChoiceStrategyOptions

    workerChoiceStrategyOptions?: WorkerChoiceStrategyOptions

    The worker choice strategy options.

    +

    Optional workerOptions

    workerOptions?: WorkerOptions

    Worker options.

    See

    https://nodejs.org/api/worker_threads.html#new-workerfilename-options

    -

    Settings

    Member Visibility

    Theme

    On This Page

    enableEventsenableTasksQueueenverrorHandlerexitHandlermessageHandleronlineHandlerrestartWorkerOnErrorsettingsstartWorkerstasksQueueOptionsworkerChoiceStrategyworkerChoiceStrategyOptionsworkerOptions
    \ No newline at end of file +

    Settings

    Member Visibility

    Theme

    On This Page

    enableEventsenableTasksQueueenverrorHandlerexitHandlermessageHandleronlineHandlerrestartWorkerOnErrorsettingsstartWorkerstasksQueueOptionsworkerChoiceStrategyworkerChoiceStrategyOptionsworkerOptions
    \ No newline at end of file diff --git a/docs/interfaces/PriorityQueueNode.html b/docs/interfaces/PriorityQueueNode.html index 690f0c7f..140fa817 100644 --- a/docs/interfaces/PriorityQueueNode.html +++ b/docs/interfaces/PriorityQueueNode.html @@ -1,5 +1,5 @@ -PriorityQueueNode | poolifier - v4.0.11

    Interface PriorityQueueNode<T>Internal

    Priority queue node.

    +PriorityQueueNode | poolifier - v4.0.12

    Interface PriorityQueueNode<T>Internal

    Priority queue node.

    interface PriorityQueueNode<T> {
        data: T;
        priority: number;
    }

    Type Parameters

    • T

      Type of priority queue node data.

      -

    Properties

    data +

    Properties

    data priority -

    Properties

    data

    data: T

    priority

    priority: number

    Settings

    Member Visibility

    Theme

    On This Page

    datapriority
    \ No newline at end of file +

    Properties

    data

    data: T

    priority

    priority: number

    Settings

    Member Visibility

    Theme

    On This Page

    datapriority
    \ No newline at end of file diff --git a/docs/interfaces/PromiseResponseWrapper.html b/docs/interfaces/PromiseResponseWrapper.html index 082e31a6..00aba48b 100644 --- a/docs/interfaces/PromiseResponseWrapper.html +++ b/docs/interfaces/PromiseResponseWrapper.html @@ -1,11 +1,11 @@ -PromiseResponseWrapper | poolifier - v4.0.11

    Interface PromiseResponseWrapper<Response>Internal

    An object holding the task execution response promise resolve/reject callbacks.

    +PromiseResponseWrapper | poolifier - v4.0.12

    Interface PromiseResponseWrapper<Response>Internal

    An object holding the task execution response promise resolve/reject callbacks.

    interface PromiseResponseWrapper<Response> {
        asyncResource?: AsyncResource;
        reject: ((reason?) => void);
        resolve: ((value) => void);
        workerNodeKey: number;
    }

    Type Parameters

    • Response = unknown

      Type of execution response. This can only be structured-cloneable data.

      -

    Properties

    asyncResource? +

    Properties

    asyncResource? reject resolve workerNodeKey

    Properties

    Optional Readonly asyncResource

    asyncResource?: AsyncResource

    The asynchronous resource used to track the task execution.

    -

    Readonly reject

    reject: ((reason?) => void)

    Reject callback to reject the promise.

    -

    Type declaration

      • (reason?): void

      • Parameters

        • Optional reason: unknown

        Returns void

    Readonly resolve

    resolve: ((value) => void)

    Resolve callback to fulfill the promise.

    -

    Type declaration

    Readonly workerNodeKey

    workerNodeKey: number

    The worker node key executing the task.

    -

    Settings

    Member Visibility

    Theme

    On This Page

    asyncResourcerejectresolveworkerNodeKey
    \ No newline at end of file +

    Readonly reject

    reject: ((reason?) => void)

    Reject callback to reject the promise.

    +

    Type declaration

      • (reason?): void

      • Parameters

        • Optional reason: unknown

        Returns void

    Readonly resolve

    resolve: ((value) => void)

    Resolve callback to fulfill the promise.

    +

    Type declaration

    Readonly workerNodeKey

    workerNodeKey: number

    The worker node key executing the task.

    +

    Settings

    Member Visibility

    Theme

    On This Page

    asyncResourcerejectresolveworkerNodeKey
    \ No newline at end of file diff --git a/docs/interfaces/StrategyData.html b/docs/interfaces/StrategyData.html index 24ac7347..405a2a52 100644 --- a/docs/interfaces/StrategyData.html +++ b/docs/interfaces/StrategyData.html @@ -1,3 +1,3 @@ -StrategyData | poolifier - v4.0.11

    Interface StrategyDataInternal

    Worker choice strategy data.

    -
    interface StrategyData {
        virtualTaskEndTimestamp?: number;
    }

    Properties

    virtualTaskEndTimestamp? -

    Properties

    Optional virtualTaskEndTimestamp

    virtualTaskEndTimestamp?: number

    Settings

    Member Visibility

    Theme

    On This Page

    virtualTaskEndTimestamp
    \ No newline at end of file +StrategyData | poolifier - v4.0.12

    Interface StrategyDataInternal

    Worker choice strategy data.

    +
    interface StrategyData {
        virtualTaskEndTimestamp?: number;
    }

    Properties

    virtualTaskEndTimestamp? +

    Properties

    Optional virtualTaskEndTimestamp

    virtualTaskEndTimestamp?: number

    Settings

    Member Visibility

    Theme

    On This Page

    virtualTaskEndTimestamp
    \ No newline at end of file diff --git a/docs/interfaces/StrategyPolicy.html b/docs/interfaces/StrategyPolicy.html index 643f36d4..b14ab1c5 100644 --- a/docs/interfaces/StrategyPolicy.html +++ b/docs/interfaces/StrategyPolicy.html @@ -1,6 +1,6 @@ -StrategyPolicy | poolifier - v4.0.11

    Interface StrategyPolicyInternal

    Strategy policy.

    -
    interface StrategyPolicy {
        dynamicWorkerReady: boolean;
        dynamicWorkerUsage: boolean;
    }

    Properties

    dynamicWorkerReady +StrategyPolicy | poolifier - v4.0.12

    Interface StrategyPolicyInternal

    Strategy policy.

    +
    interface StrategyPolicy {
        dynamicWorkerReady: boolean;
        dynamicWorkerUsage: boolean;
    }

    Properties

    dynamicWorkerReady dynamicWorkerUsage

    Properties

    Readonly dynamicWorkerReady

    dynamicWorkerReady: boolean

    Expects the newly created dynamic worker to be flagged as ready.

    -

    Readonly dynamicWorkerUsage

    dynamicWorkerUsage: boolean

    Expects tasks execution on the newly created dynamic worker.

    -

    Settings

    Member Visibility

    Theme

    On This Page

    dynamicWorkerReadydynamicWorkerUsage
    \ No newline at end of file +

    Readonly dynamicWorkerUsage

    dynamicWorkerUsage: boolean

    Expects tasks execution on the newly created dynamic worker.

    +

    Settings

    Member Visibility

    Theme

    On This Page

    dynamicWorkerReadydynamicWorkerUsage
    \ No newline at end of file diff --git a/docs/interfaces/Task.html b/docs/interfaces/Task.html index 1d9a2d01..5151a219 100644 --- a/docs/interfaces/Task.html +++ b/docs/interfaces/Task.html @@ -1,6 +1,6 @@ -Task | poolifier - v4.0.11

    Interface Task<Data>Internal

    Message object that is passed as a task between main worker and worker.

    +Task | poolifier - v4.0.12

    Interface Task<Data>Internal

    Message object that is passed as a task between main worker and worker.

    interface Task<Data> {
        data?: Data;
        name?: string;
        priority?: number;
        strategy?: "ROUND_ROBIN" | "LEAST_USED" | "LEAST_BUSY" | "LEAST_ELU" | "FAIR_SHARE" | "WEIGHTED_ROUND_ROBIN" | "INTERLEAVED_WEIGHTED_ROUND_ROBIN";
        taskId?: `${string}-${string}-${string}-${string}-${string}`;
        timestamp?: number;
        transferList?: readonly TransferListItem[];
    }

    Type Parameters

    • Data = unknown

      Type of data sent to the worker. This can only be structured-cloneable data.

      -

    Hierarchy (view full)

    Properties

    data? +

    Hierarchy (view full)

    Properties

    data? name? priority? strategy? @@ -8,12 +8,12 @@ timestamp? transferList?

    Properties

    Optional Readonly data

    data?: Data

    Task input data that will be passed to the worker.

    -

    Optional Readonly name

    name?: string

    Task name.

    -

    Optional Readonly priority

    priority?: number

    Task priority. Lower values have higher priority.

    +

    Optional Readonly name

    name?: string

    Task name.

    +

    Optional Readonly priority

    priority?: number

    Task priority. Lower values have higher priority.

    Default Value

    0
    -

    Optional Readonly strategy

    strategy?: "ROUND_ROBIN" | "LEAST_USED" | "LEAST_BUSY" | "LEAST_ELU" | "FAIR_SHARE" | "WEIGHTED_ROUND_ROBIN" | "INTERLEAVED_WEIGHTED_ROUND_ROBIN"

    Task worker choice strategy.

    -

    Optional Readonly taskId

    taskId?: `${string}-${string}-${string}-${string}-${string}`

    Task UUID.

    -

    Optional Readonly timestamp

    timestamp?: number

    Timestamp.

    -

    Optional Readonly transferList

    transferList?: readonly TransferListItem[]

    Array of transferable objects.

    -

    Settings

    Member Visibility

    Theme

    On This Page

    datanameprioritystrategytaskIdtimestamptransferList
    \ No newline at end of file +

    Optional Readonly strategy

    strategy?: "ROUND_ROBIN" | "LEAST_USED" | "LEAST_BUSY" | "LEAST_ELU" | "FAIR_SHARE" | "WEIGHTED_ROUND_ROBIN" | "INTERLEAVED_WEIGHTED_ROUND_ROBIN"

    Task worker choice strategy.

    +

    Optional Readonly taskId

    taskId?: `${string}-${string}-${string}-${string}-${string}`

    Task UUID.

    +

    Optional Readonly timestamp

    timestamp?: number

    Timestamp.

    +

    Optional Readonly transferList

    transferList?: readonly TransferListItem[]

    Array of transferable objects.

    +

    Settings

    Member Visibility

    Theme

    On This Page

    datanameprioritystrategytaskIdtimestamptransferList
    \ No newline at end of file diff --git a/docs/interfaces/TaskFunctionObject.html b/docs/interfaces/TaskFunctionObject.html index 841b4098..11bf991a 100644 --- a/docs/interfaces/TaskFunctionObject.html +++ b/docs/interfaces/TaskFunctionObject.html @@ -1,10 +1,10 @@ -TaskFunctionObject | poolifier - v4.0.11

    Interface TaskFunctionObject<Data, Response>

    Task function object.

    +TaskFunctionObject | poolifier - v4.0.12

    Interface TaskFunctionObject<Data, Response>

    Task function object.

    interface TaskFunctionObject<Data, Response> {
        priority?: number;
        strategy?: "ROUND_ROBIN" | "LEAST_USED" | "LEAST_BUSY" | "LEAST_ELU" | "FAIR_SHARE" | "WEIGHTED_ROUND_ROBIN" | "INTERLEAVED_WEIGHTED_ROUND_ROBIN";
        taskFunction: TaskFunction<Data, Response>;
    }

    Type Parameters

    • Data = unknown

      Type of data sent to the worker. This can only be structured-cloneable data.

    • Response = unknown

      Type of execution response. This can only be structured-cloneable data.

      -

    Properties

    priority? +

    Properties

    priority? strategy? taskFunction

    Properties

    Optional priority

    priority?: number

    Task function priority. Lower values have higher priority.

    -

    Optional strategy

    strategy?: "ROUND_ROBIN" | "LEAST_USED" | "LEAST_BUSY" | "LEAST_ELU" | "FAIR_SHARE" | "WEIGHTED_ROUND_ROBIN" | "INTERLEAVED_WEIGHTED_ROUND_ROBIN"

    Task function worker choice strategy.

    -

    taskFunction

    taskFunction: TaskFunction<Data, Response>

    Task function.

    -

    Settings

    Member Visibility

    Theme

    On This Page

    prioritystrategytaskFunction
    \ No newline at end of file +

    Optional strategy

    strategy?: "ROUND_ROBIN" | "LEAST_USED" | "LEAST_BUSY" | "LEAST_ELU" | "FAIR_SHARE" | "WEIGHTED_ROUND_ROBIN" | "INTERLEAVED_WEIGHTED_ROUND_ROBIN"

    Task function worker choice strategy.

    +

    taskFunction

    taskFunction: TaskFunction<Data, Response>

    Task function.

    +

    Settings

    Member Visibility

    Theme

    On This Page

    prioritystrategytaskFunction
    \ No newline at end of file diff --git a/docs/interfaces/TaskFunctionOperationResult.html b/docs/interfaces/TaskFunctionOperationResult.html index c0f4fae5..160a00e1 100644 --- a/docs/interfaces/TaskFunctionOperationResult.html +++ b/docs/interfaces/TaskFunctionOperationResult.html @@ -1,4 +1,4 @@ -TaskFunctionOperationResult | poolifier - v4.0.11

    Interface TaskFunctionOperationResult

    Task function operation result.

    -
    interface TaskFunctionOperationResult {
        error?: Error;
        status: boolean;
    }

    Properties

    error? +TaskFunctionOperationResult | poolifier - v4.0.12

    Interface TaskFunctionOperationResult

    Task function operation result.

    +
    interface TaskFunctionOperationResult {
        error?: Error;
        status: boolean;
    }

    Properties

    error? status -

    Properties

    Optional error

    error?: Error

    status

    status: boolean

    Settings

    Member Visibility

    Theme

    On This Page

    errorstatus
    \ No newline at end of file +

    Properties

    Optional error

    error?: Error

    status

    status: boolean

    Settings

    Member Visibility

    Theme

    On This Page

    errorstatus
    \ No newline at end of file diff --git a/docs/interfaces/TaskFunctionProperties.html b/docs/interfaces/TaskFunctionProperties.html index d0fad95f..22c0451a 100644 --- a/docs/interfaces/TaskFunctionProperties.html +++ b/docs/interfaces/TaskFunctionProperties.html @@ -1,8 +1,8 @@ -TaskFunctionProperties | poolifier - v4.0.11

    Interface TaskFunctionProperties

    Task function properties.

    -
    interface TaskFunctionProperties {
        name: string;
        priority?: number;
        strategy?: "ROUND_ROBIN" | "LEAST_USED" | "LEAST_BUSY" | "LEAST_ELU" | "FAIR_SHARE" | "WEIGHTED_ROUND_ROBIN" | "INTERLEAVED_WEIGHTED_ROUND_ROBIN";
    }

    Properties

    name +TaskFunctionProperties | poolifier - v4.0.12

    Interface TaskFunctionProperties

    Task function properties.

    +
    interface TaskFunctionProperties {
        name: string;
        priority?: number;
        strategy?: "ROUND_ROBIN" | "LEAST_USED" | "LEAST_BUSY" | "LEAST_ELU" | "FAIR_SHARE" | "WEIGHTED_ROUND_ROBIN" | "INTERLEAVED_WEIGHTED_ROUND_ROBIN";
    }

    Properties

    name priority? strategy?

    Properties

    Readonly name

    name: string

    Task function name.

    -

    Optional Readonly priority

    priority?: number

    Task function priority. Lower values have higher priority.

    -

    Optional Readonly strategy

    strategy?: "ROUND_ROBIN" | "LEAST_USED" | "LEAST_BUSY" | "LEAST_ELU" | "FAIR_SHARE" | "WEIGHTED_ROUND_ROBIN" | "INTERLEAVED_WEIGHTED_ROUND_ROBIN"

    Task function worker choice strategy.

    -

    Settings

    Member Visibility

    Theme

    On This Page

    nameprioritystrategy
    \ No newline at end of file +

    Optional Readonly priority

    priority?: number

    Task function priority. Lower values have higher priority.

    +

    Optional Readonly strategy

    strategy?: "ROUND_ROBIN" | "LEAST_USED" | "LEAST_BUSY" | "LEAST_ELU" | "FAIR_SHARE" | "WEIGHTED_ROUND_ROBIN" | "INTERLEAVED_WEIGHTED_ROUND_ROBIN"

    Task function worker choice strategy.

    +

    Settings

    Member Visibility

    Theme

    On This Page

    nameprioritystrategy
    \ No newline at end of file diff --git a/docs/interfaces/TaskPerformance.html b/docs/interfaces/TaskPerformance.html index 1509f1ef..3afc80fd 100644 --- a/docs/interfaces/TaskPerformance.html +++ b/docs/interfaces/TaskPerformance.html @@ -1,10 +1,10 @@ -TaskPerformance | poolifier - v4.0.11

    Interface TaskPerformanceInternal

    Task performance.

    -
    interface TaskPerformance {
        elu?: EventLoopUtilization;
        name: string;
        runTime?: number;
        timestamp: number;
    }

    Properties

    elu? +TaskPerformance | poolifier - v4.0.12

    Interface TaskPerformanceInternal

    Task performance.

    +
    interface TaskPerformance {
        elu?: EventLoopUtilization;
        name: string;
        runTime?: number;
        timestamp: number;
    }

    Properties

    elu? name runTime? timestamp

    Properties

    Optional Readonly elu

    elu?: EventLoopUtilization

    Task event loop utilization.

    -

    Readonly name

    name: string

    Task name.

    -

    Optional Readonly runTime

    runTime?: number

    Task runtime.

    -

    Readonly timestamp

    timestamp: number

    Task performance timestamp.

    -

    Settings

    Member Visibility

    Theme

    On This Page

    elunamerunTimetimestamp
    \ No newline at end of file +

    Readonly name

    name: string

    Task name.

    +

    Optional Readonly runTime

    runTime?: number

    Task runtime.

    +

    Readonly timestamp

    timestamp: number

    Task performance timestamp.

    +

    Settings

    Member Visibility

    Theme

    On This Page

    elunamerunTimetimestamp
    \ No newline at end of file diff --git a/docs/interfaces/TaskStatistics.html b/docs/interfaces/TaskStatistics.html index a676ea43..0f5c16fe 100644 --- a/docs/interfaces/TaskStatistics.html +++ b/docs/interfaces/TaskStatistics.html @@ -1,5 +1,5 @@ -TaskStatistics | poolifier - v4.0.11

    Interface TaskStatisticsInternal

    Task statistics.

    -
    interface TaskStatistics {
        executed: number;
        executing: number;
        failed: number;
        maxQueued?: number;
        queued: number;
        sequentiallyStolen: number;
        stolen: number;
    }

    Properties

    executed +TaskStatistics | poolifier - v4.0.12

    Interface TaskStatisticsInternal

    Task statistics.

    +
    interface TaskStatistics {
        executed: number;
        executing: number;
        failed: number;
        maxQueued?: number;
        queued: number;
        sequentiallyStolen: number;
        stolen: number;
    }

    Properties

    executed executing failed maxQueued? @@ -7,10 +7,10 @@ sequentiallyStolen stolen

    Properties

    executed

    executed: number

    Number of executed tasks.

    -

    executing

    executing: number

    Number of executing tasks.

    -

    failed

    failed: number

    Number of failed tasks.

    -

    Optional Readonly maxQueued

    maxQueued?: number

    Maximum number of queued tasks.

    -

    Readonly queued

    queued: number

    Number of queued tasks.

    -

    sequentiallyStolen

    sequentiallyStolen: number

    Number of sequentially stolen tasks.

    -

    stolen

    stolen: number

    Number of stolen tasks.

    -

    Settings

    Member Visibility

    Theme

    On This Page

    executedexecutingfailedmaxQueuedqueuedsequentiallyStolenstolen
    \ No newline at end of file +

    executing

    executing: number

    Number of executing tasks.

    +

    failed

    failed: number

    Number of failed tasks.

    +

    Optional Readonly maxQueued

    maxQueued?: number

    Maximum number of queued tasks.

    +

    Readonly queued

    queued: number

    Number of queued tasks.

    +

    sequentiallyStolen

    sequentiallyStolen: number

    Number of sequentially stolen tasks.

    +

    stolen

    stolen: number

    Number of stolen tasks.

    +

    Settings

    Member Visibility

    Theme

    On This Page

    executedexecutingfailedmaxQueuedqueuedsequentiallyStolenstolen
    \ No newline at end of file diff --git a/docs/interfaces/TaskStatisticsRequirements.html b/docs/interfaces/TaskStatisticsRequirements.html index f5986ba1..a94ac0f2 100644 --- a/docs/interfaces/TaskStatisticsRequirements.html +++ b/docs/interfaces/TaskStatisticsRequirements.html @@ -1,8 +1,8 @@ -TaskStatisticsRequirements | poolifier - v4.0.11

    Interface TaskStatisticsRequirementsInternal

    Pool worker node worker usage statistics requirements.

    -
    interface TaskStatisticsRequirements {
        elu: MeasurementStatisticsRequirements;
        runTime: MeasurementStatisticsRequirements;
        waitTime: MeasurementStatisticsRequirements;
    }

    Properties

    elu +TaskStatisticsRequirements | poolifier - v4.0.12

    Interface TaskStatisticsRequirementsInternal

    Pool worker node worker usage statistics requirements.

    +
    interface TaskStatisticsRequirements {
        elu: MeasurementStatisticsRequirements;
        runTime: MeasurementStatisticsRequirements;
        waitTime: MeasurementStatisticsRequirements;
    }

    Properties

    elu runTime waitTime

    Properties

    Readonly elu

    elu: MeasurementStatisticsRequirements

    Tasks event loop utilization requirements.

    -

    Readonly runTime

    runTime: MeasurementStatisticsRequirements

    Tasks runtime requirements.

    -

    Readonly waitTime

    waitTime: MeasurementStatisticsRequirements

    Tasks wait time requirements.

    -

    Settings

    Member Visibility

    Theme

    On This Page

    elurunTimewaitTime
    \ No newline at end of file +

    Readonly runTime

    runTime: MeasurementStatisticsRequirements

    Tasks runtime requirements.

    +

    Readonly waitTime

    waitTime: MeasurementStatisticsRequirements

    Tasks wait time requirements.

    +

    Settings

    Member Visibility

    Theme

    On This Page

    elurunTimewaitTime
    \ No newline at end of file diff --git a/docs/interfaces/TasksQueueOptions.html b/docs/interfaces/TasksQueueOptions.html index f20aba3b..42721c05 100644 --- a/docs/interfaces/TasksQueueOptions.html +++ b/docs/interfaces/TasksQueueOptions.html @@ -1,5 +1,5 @@ -TasksQueueOptions | poolifier - v4.0.11

    Interface TasksQueueOptions

    Worker node tasks queue options.

    -
    interface TasksQueueOptions {
        concurrency?: number;
        size?: number;
        taskStealing?: boolean;
        tasksFinishedTimeout?: number;
        tasksStealingOnBackPressure?: boolean;
    }

    Properties

    concurrency? +TasksQueueOptions | poolifier - v4.0.12

    Interface TasksQueueOptions

    Worker node tasks queue options.

    +
    interface TasksQueueOptions {
        concurrency?: number;
        size?: number;
        taskStealing?: boolean;
        tasksFinishedTimeout?: number;
        tasksStealingOnBackPressure?: boolean;
    }

    Properties

    concurrency? size? taskStealing? tasksFinishedTimeout? @@ -7,16 +7,16 @@

    Properties

    Optional Readonly concurrency

    concurrency?: number

    Maximum number of tasks that can be executed concurrently on a worker node.

    Default Value

    1
    -

    Optional Readonly size

    size?: number

    Maximum tasks queue size per worker node flagging it as back pressured.

    +

    Optional Readonly size

    size?: number

    Maximum tasks queue size per worker node flagging it as back pressured.

    Default Value

    (pool maximum size)^2
    -

    Optional Readonly taskStealing

    taskStealing?: boolean

    Whether to enable task stealing on idle.

    +

    Optional Readonly taskStealing

    taskStealing?: boolean

    Whether to enable task stealing on idle.

    Default Value

    true
    -

    Optional Readonly tasksFinishedTimeout

    tasksFinishedTimeout?: number

    Queued tasks finished timeout in milliseconds at worker node termination.

    +

    Optional Readonly tasksFinishedTimeout

    tasksFinishedTimeout?: number

    Queued tasks finished timeout in milliseconds at worker node termination.

    Default Value

    2000
    -

    Optional Readonly tasksStealingOnBackPressure

    tasksStealingOnBackPressure?: boolean

    Whether to enable tasks stealing under back pressure.

    +

    Optional Readonly tasksStealingOnBackPressure

    tasksStealingOnBackPressure?: boolean

    Whether to enable tasks stealing under back pressure.

    Default Value

    false
    -

    Settings

    Member Visibility

    Theme

    On This Page

    concurrencysizetaskStealingtasksFinishedTimeouttasksStealingOnBackPressure
    \ No newline at end of file +

    Settings

    Member Visibility

    Theme

    On This Page

    concurrencysizetaskStealingtasksFinishedTimeouttasksStealingOnBackPressure
    \ No newline at end of file diff --git a/docs/interfaces/WorkerChoiceStrategyOptions.html b/docs/interfaces/WorkerChoiceStrategyOptions.html index 260f0cc4..a32d6505 100644 --- a/docs/interfaces/WorkerChoiceStrategyOptions.html +++ b/docs/interfaces/WorkerChoiceStrategyOptions.html @@ -1,5 +1,5 @@ -WorkerChoiceStrategyOptions | poolifier - v4.0.11

    Interface WorkerChoiceStrategyOptions

    Worker choice strategy options.

    -
    interface WorkerChoiceStrategyOptions {
        elu?: MeasurementOptions;
        measurement?: "runTime" | "waitTime" | "elu";
        runTime?: MeasurementOptions;
        waitTime?: MeasurementOptions;
        weights?: Record<number, number>;
    }

    Properties

    elu? +WorkerChoiceStrategyOptions | poolifier - v4.0.12

    Interface WorkerChoiceStrategyOptions

    Worker choice strategy options.

    +
    interface WorkerChoiceStrategyOptions {
        elu?: MeasurementOptions;
        measurement?: "runTime" | "waitTime" | "elu";
        runTime?: MeasurementOptions;
        waitTime?: MeasurementOptions;
        weights?: Record<number, number>;
    }

    Properties

    elu? measurement? runTime? waitTime? @@ -7,15 +7,15 @@

    Properties

    Optional Readonly elu

    elu?: MeasurementOptions

    Event loop utilization options.

    Default Value

    { median: false }
    -

    Optional Readonly measurement

    measurement?: "runTime" | "waitTime" | "elu"

    Measurement to use in worker choice strategy supporting it.

    -

    Optional Readonly runTime

    runTime?: MeasurementOptions

    Runtime options.

    +

    Optional Readonly measurement

    measurement?: "runTime" | "waitTime" | "elu"

    Measurement to use in worker choice strategy supporting it.

    +

    Optional Readonly runTime

    runTime?: MeasurementOptions

    Runtime options.

    Default Value

    { median: false }
    -

    Optional Readonly waitTime

    waitTime?: MeasurementOptions

    Wait time options.

    +

    Optional Readonly waitTime

    waitTime?: MeasurementOptions

    Wait time options.

    Default Value

    { median: false }
    -

    Optional weights

    weights?: Record<number, number>

    Worker weights to use for weighted round robin worker selection strategies. +

    Optional weights

    weights?: Record<number, number>

    Worker weights to use for weighted round robin worker selection strategies. A weight is tasks maximum execution time in milliseconds for a worker node.

    Default Value

    Weights computed automatically given the CPU performance.
    -

    Settings

    Member Visibility

    Theme

    On This Page

    elumeasurementrunTimewaitTimeweights
    \ No newline at end of file +

    Settings

    Member Visibility

    Theme

    On This Page

    elumeasurementrunTimewaitTimeweights
    \ No newline at end of file diff --git a/docs/interfaces/WorkerError.html b/docs/interfaces/WorkerError.html index 38078b8d..bc2e8c69 100644 --- a/docs/interfaces/WorkerError.html +++ b/docs/interfaces/WorkerError.html @@ -1,9 +1,9 @@ -WorkerError | poolifier - v4.0.11

    Interface WorkerError<Data>

    Worker error.

    +WorkerError | poolifier - v4.0.12

    Interface WorkerError<Data>

    Worker error.

    interface WorkerError<Data> {
        data?: Data;
        message: string;
        name: string;
    }

    Type Parameters

    • Data = unknown

      Type of data sent to the worker triggering an error. This can only be structured-cloneable data.

      -

    Properties

    data? +

    Properties

    data? message name

    Properties

    Optional Readonly data

    data?: Data

    Data triggering the error.

    -

    Readonly message

    message: string

    Error message.

    -

    Readonly name

    name: string

    Task function name triggering the error.

    -

    Settings

    Member Visibility

    Theme

    On This Page

    datamessagename
    \ No newline at end of file +

    Readonly message

    message: string

    Error message.

    +

    Readonly name

    name: string

    Task function name triggering the error.

    +

    Settings

    Member Visibility

    Theme

    On This Page

    datamessagename
    \ No newline at end of file diff --git a/docs/interfaces/WorkerInfo.html b/docs/interfaces/WorkerInfo.html index fb885071..1093a908 100644 --- a/docs/interfaces/WorkerInfo.html +++ b/docs/interfaces/WorkerInfo.html @@ -1,5 +1,5 @@ -WorkerInfo | poolifier - v4.0.11

    Interface WorkerInfoInternal

    Worker information.

    -
    interface WorkerInfo {
        backPressure: boolean;
        dynamic: boolean;
        id: undefined | number;
        ready: boolean;
        stealing: boolean;
        taskFunctionsProperties?: TaskFunctionProperties[];
        type: "thread" | "cluster";
    }

    Properties

    backPressure +WorkerInfo | poolifier - v4.0.12

    Interface WorkerInfoInternal

    Worker information.

    +
    interface WorkerInfo {
        backPressure: boolean;
        dynamic: boolean;
        id: undefined | number;
        ready: boolean;
        stealing: boolean;
        taskFunctionsProperties?: TaskFunctionProperties[];
        type: "thread" | "cluster";
    }

    Properties

    backPressure dynamic id ready @@ -8,11 +8,11 @@ type

    Properties

    backPressure

    backPressure: boolean

    Back pressure flag. This flag is set to true when worker node tasks queue has back pressure.

    -

    dynamic

    dynamic: boolean

    Dynamic flag.

    -

    Readonly id

    id: undefined | number

    Worker id.

    -

    ready

    ready: boolean

    Ready flag.

    -

    stealing

    stealing: boolean

    Stealing flag. +

    dynamic

    dynamic: boolean

    Dynamic flag.

    +

    Readonly id

    id: undefined | number

    Worker id.

    +

    ready

    ready: boolean

    Ready flag.

    +

    stealing

    stealing: boolean

    Stealing flag. This flag is set to true when worker node is stealing tasks from another worker node.

    -

    Optional taskFunctionsProperties

    taskFunctionsProperties?: TaskFunctionProperties[]

    Task functions properties.

    -

    Readonly type

    type: "thread" | "cluster"

    Worker type.

    -

    Settings

    Member Visibility

    Theme

    On This Page

    backPressuredynamicidreadystealingtaskFunctionsPropertiestype
    \ No newline at end of file +

    Optional taskFunctionsProperties

    taskFunctionsProperties?: TaskFunctionProperties[]

    Task functions properties.

    +

    Readonly type

    type: "thread" | "cluster"

    Worker type.

    +

    Settings

    Member Visibility

    Theme

    On This Page

    backPressuredynamicidreadystealingtaskFunctionsPropertiestype
    \ No newline at end of file diff --git a/docs/interfaces/WorkerNodeEventDetail.html b/docs/interfaces/WorkerNodeEventDetail.html index 778896c0..93bb868d 100644 --- a/docs/interfaces/WorkerNodeEventDetail.html +++ b/docs/interfaces/WorkerNodeEventDetail.html @@ -1,4 +1,4 @@ -WorkerNodeEventDetail | poolifier - v4.0.11

    Interface WorkerNodeEventDetailInternal

    Worker node event detail.

    -
    interface WorkerNodeEventDetail {
        workerId?: number;
        workerNodeKey?: number;
    }

    Properties

    workerId? +WorkerNodeEventDetail | poolifier - v4.0.12

    Interface WorkerNodeEventDetailInternal

    Worker node event detail.

    +
    interface WorkerNodeEventDetail {
        workerId?: number;
        workerNodeKey?: number;
    }

    Properties

    workerId? workerNodeKey? -

    Properties

    Optional workerId

    workerId?: number

    Optional workerNodeKey

    workerNodeKey?: number

    Settings

    Member Visibility

    Theme

    On This Page

    workerIdworkerNodeKey
    \ No newline at end of file +

    Properties

    Optional workerId

    workerId?: number

    Optional workerNodeKey

    workerNodeKey?: number

    Settings

    Member Visibility

    Theme

    On This Page

    workerIdworkerNodeKey
    \ No newline at end of file diff --git a/docs/interfaces/WorkerNodeOptions.html b/docs/interfaces/WorkerNodeOptions.html index a767a92e..adc1afff 100644 --- a/docs/interfaces/WorkerNodeOptions.html +++ b/docs/interfaces/WorkerNodeOptions.html @@ -1,6 +1,6 @@ -WorkerNodeOptions | poolifier - v4.0.11

    Interface WorkerNodeOptionsInternal

    Worker node options.

    -
    interface WorkerNodeOptions {
        env?: Record<string, unknown>;
        tasksQueueBackPressureSize: undefined | number;
        tasksQueueBucketSize: undefined | number;
        workerOptions?: WorkerOptions;
    }

    Properties

    env? +WorkerNodeOptions | poolifier - v4.0.12

    Interface WorkerNodeOptionsInternal

    Worker node options.

    +
    interface WorkerNodeOptions {
        env?: Record<string, unknown>;
        tasksQueueBackPressureSize: undefined | number;
        tasksQueueBucketSize: undefined | number;
        workerOptions?: WorkerOptions;
    }

    Properties

    env? tasksQueueBackPressureSize tasksQueueBucketSize workerOptions? -

    Properties

    Optional env

    env?: Record<string, unknown>

    tasksQueueBackPressureSize

    tasksQueueBackPressureSize: undefined | number

    tasksQueueBucketSize

    tasksQueueBucketSize: undefined | number

    Optional workerOptions

    workerOptions?: WorkerOptions

    Settings

    Member Visibility

    Theme

    On This Page

    envtasksQueueBackPressureSizetasksQueueBucketSizeworkerOptions
    \ No newline at end of file +

    Properties

    Optional env

    env?: Record<string, unknown>

    tasksQueueBackPressureSize

    tasksQueueBackPressureSize: undefined | number

    tasksQueueBucketSize

    tasksQueueBucketSize: undefined | number

    Optional workerOptions

    workerOptions?: WorkerOptions

    Settings

    Member Visibility

    Theme

    On This Page

    envtasksQueueBackPressureSizetasksQueueBucketSizeworkerOptions
    \ No newline at end of file diff --git a/docs/interfaces/WorkerOptions.html b/docs/interfaces/WorkerOptions.html index 581b12b1..041845a7 100644 --- a/docs/interfaces/WorkerOptions.html +++ b/docs/interfaces/WorkerOptions.html @@ -1,5 +1,5 @@ -WorkerOptions | poolifier - v4.0.11

    Interface WorkerOptions

    Options for workers.

    -
    interface WorkerOptions {
        killBehavior?: "SOFT" | "HARD";
        killHandler?: KillHandler;
        maxInactiveTime?: number;
    }

    Properties

    killBehavior? +WorkerOptions | poolifier - v4.0.12

    Interface WorkerOptions

    Options for workers.

    +
    interface WorkerOptions {
        killBehavior?: "SOFT" | "HARD";
        killHandler?: KillHandler;
        maxInactiveTime?: number;
    }

    Properties

    killBehavior? killHandler? maxInactiveTime?

    Properties

    Optional killBehavior

    killBehavior?: "SOFT" | "HARD"

    killBehavior dictates if your worker will be deleted in case a task is active on it.

    @@ -10,9 +10,9 @@

    This option only apply to the newly created workers.

    Default Value

    KillBehaviors.SOFT
    -

    Optional killHandler

    killHandler?: KillHandler

    The function to call when a worker is killed.

    +

    Optional killHandler

    killHandler?: KillHandler

    The function to call when a worker is killed.

    Default Value

    () => {}

    -

    Optional maxInactiveTime

    maxInactiveTime?: number

    Maximum waiting time in milliseconds for tasks on newly created workers. It must be greater or equal than 5.

    +

    Optional maxInactiveTime

    maxInactiveTime?: number

    Maximum waiting time in milliseconds for tasks on newly created workers. It must be greater or equal than 5.

    After this time, newly created workers will be terminated. The last active time of your worker will be updated when it terminates a task.

      @@ -22,4 +22,4 @@ when this timeout expires your tasks is interrupted before completion and remove

    Default Value

    60000
    -

    Settings

    Member Visibility

    Theme

    On This Page

    killBehaviorkillHandlermaxInactiveTime
    \ No newline at end of file +

    Settings

    Member Visibility

    Theme

    On This Page

    killBehaviorkillHandlermaxInactiveTime
    \ No newline at end of file diff --git a/docs/interfaces/WorkerStatistics.html b/docs/interfaces/WorkerStatistics.html index dfd7df26..aa53e46e 100644 --- a/docs/interfaces/WorkerStatistics.html +++ b/docs/interfaces/WorkerStatistics.html @@ -1,6 +1,6 @@ -WorkerStatistics | poolifier - v4.0.11

    Interface WorkerStatisticsInternal

    Worker task performance statistics computation settings.

    -
    interface WorkerStatistics {
        elu: boolean;
        runTime: boolean;
    }

    Properties

    elu +WorkerStatistics | poolifier - v4.0.12

    Interface WorkerStatisticsInternal

    Worker task performance statistics computation settings.

    +
    interface WorkerStatistics {
        elu: boolean;
        runTime: boolean;
    }

    Properties

    elu runTime

    Properties

    Readonly elu

    elu: boolean

    Whether the worker computes the task event loop utilization (ELU) or not.

    -

    Readonly runTime

    runTime: boolean

    Whether the worker computes the task runtime or not.

    -

    Settings

    Member Visibility

    Theme

    On This Page

    elurunTime
    \ No newline at end of file +

    Readonly runTime

    runTime: boolean

    Whether the worker computes the task runtime or not.

    +

    Settings

    Member Visibility

    Theme

    On This Page

    elurunTime
    \ No newline at end of file diff --git a/docs/interfaces/WorkerUsage.html b/docs/interfaces/WorkerUsage.html index a18b9e35..2a5e737a 100644 --- a/docs/interfaces/WorkerUsage.html +++ b/docs/interfaces/WorkerUsage.html @@ -1,10 +1,10 @@ -WorkerUsage | poolifier - v4.0.11

    Interface WorkerUsageInternal

    Worker usage statistics.

    -
    interface WorkerUsage {
        elu: EventLoopUtilizationMeasurementStatistics;
        runTime: MeasurementStatistics;
        tasks: TaskStatistics;
        waitTime: MeasurementStatistics;
    }

    Properties

    elu +WorkerUsage | poolifier - v4.0.12

    Interface WorkerUsageInternal

    Worker usage statistics.

    +
    interface WorkerUsage {
        elu: EventLoopUtilizationMeasurementStatistics;
        runTime: MeasurementStatistics;
        tasks: TaskStatistics;
        waitTime: MeasurementStatistics;
    }

    Properties

    elu runTime tasks waitTime

    Properties

    Readonly elu

    elu: EventLoopUtilizationMeasurementStatistics

    Tasks event loop utilization statistics.

    -

    Readonly runTime

    runTime: MeasurementStatistics

    Tasks runtime statistics.

    -

    Readonly tasks

    tasks: TaskStatistics

    Tasks statistics.

    -

    Readonly waitTime

    waitTime: MeasurementStatistics

    Tasks wait time statistics.

    -

    Settings

    Member Visibility

    Theme

    On This Page

    elurunTimetaskswaitTime
    \ No newline at end of file +

    Readonly runTime

    runTime: MeasurementStatistics

    Tasks runtime statistics.

    +

    Readonly tasks

    tasks: TaskStatistics

    Tasks statistics.

    +

    Readonly waitTime

    waitTime: MeasurementStatistics

    Tasks wait time statistics.

    +

    Settings

    Member Visibility

    Theme

    On This Page

    elurunTimetaskswaitTime
    \ No newline at end of file diff --git a/docs/types/ClusterPoolOptions.html b/docs/types/ClusterPoolOptions.html index 559926ec..0f7544ed 100644 --- a/docs/types/ClusterPoolOptions.html +++ b/docs/types/ClusterPoolOptions.html @@ -1,2 +1,2 @@ -ClusterPoolOptions | poolifier - v4.0.11

    Type alias ClusterPoolOptions

    ClusterPoolOptions: PoolOptions<Worker>

    Options for a poolifier cluster pool.

    -

    Settings

    Member Visibility

    Theme

    \ No newline at end of file +ClusterPoolOptions | poolifier - v4.0.12

    Type alias ClusterPoolOptions

    ClusterPoolOptions: PoolOptions<Worker>

    Options for a poolifier cluster pool.

    +

    Settings

    Member Visibility

    Theme

    \ No newline at end of file diff --git a/docs/types/ErrorHandler.html b/docs/types/ErrorHandler.html index 00c570ae..f3e8b97e 100644 --- a/docs/types/ErrorHandler.html +++ b/docs/types/ErrorHandler.html @@ -1,3 +1,3 @@ -ErrorHandler | poolifier - v4.0.11

    Type alias ErrorHandler<Worker>

    ErrorHandler<Worker>: ((this, error) => void)

    Callback invoked if the worker raised an error.

    +ErrorHandler | poolifier - v4.0.12

    Type alias ErrorHandler<Worker>

    ErrorHandler<Worker>: ((this, error) => void)

    Callback invoked if the worker raised an error.

    Type Parameters

    • Worker extends IWorker

      Type of worker.

      -

    Type declaration

      • (this, error): void

      • Parameters

        Returns void

    Settings

    Member Visibility

    Theme

    \ No newline at end of file +

    Type declaration

      • (this, error): void

      • Parameters

        Returns void

    Settings

    Member Visibility

    Theme

    \ No newline at end of file diff --git a/docs/types/EventHandler.html b/docs/types/EventHandler.html index b82a0bfa..12ff8038 100644 --- a/docs/types/EventHandler.html +++ b/docs/types/EventHandler.html @@ -1,3 +1,3 @@ -EventHandler | poolifier - v4.0.11

    Type alias EventHandler<Worker>

    EventHandler<Worker>: OnlineHandler<Worker> | MessageHandler<Worker> | ErrorHandler<Worker> | ExitHandler<Worker>

    Worker event handler.

    +EventHandler | poolifier - v4.0.12

    Type alias EventHandler<Worker>

    EventHandler<Worker>: OnlineHandler<Worker> | MessageHandler<Worker> | ErrorHandler<Worker> | ExitHandler<Worker>

    Worker event handler.

    Type Parameters

    • Worker extends IWorker

      Type of worker.

      -

    Settings

    Member Visibility

    Theme

    \ No newline at end of file +

    Settings

    Member Visibility

    Theme

    \ No newline at end of file diff --git a/docs/types/ExitHandler.html b/docs/types/ExitHandler.html index 7a93ab04..f0791072 100644 --- a/docs/types/ExitHandler.html +++ b/docs/types/ExitHandler.html @@ -1,3 +1,3 @@ -ExitHandler | poolifier - v4.0.11

    Type alias ExitHandler<Worker>

    ExitHandler<Worker>: ((this, exitCode) => void)

    Callback invoked when the worker exits successfully.

    +ExitHandler | poolifier - v4.0.12

    Type alias ExitHandler<Worker>

    ExitHandler<Worker>: ((this, exitCode) => void)

    Callback invoked when the worker exits successfully.

    Type Parameters

    • Worker extends IWorker

      Type of worker.

      -

    Type declaration

      • (this, exitCode): void

      • Parameters

        Returns void

    Settings

    Member Visibility

    Theme

    \ No newline at end of file +

    Type declaration

      • (this, exitCode): void

      • Parameters

        Returns void

    Settings

    Member Visibility

    Theme

    \ No newline at end of file diff --git a/docs/types/KillBehavior.html b/docs/types/KillBehavior.html index e4ba3463..a1b19eb5 100644 --- a/docs/types/KillBehavior.html +++ b/docs/types/KillBehavior.html @@ -1,2 +1,2 @@ -KillBehavior | poolifier - v4.0.11

    Type alias KillBehavior

    KillBehavior: keyof typeof KillBehaviors

    Kill behavior.

    -

    Settings

    Member Visibility

    Theme

    \ No newline at end of file +KillBehavior | poolifier - v4.0.12

    Type alias KillBehavior

    KillBehavior: keyof typeof KillBehaviors

    Kill behavior.

    +

    Settings

    Member Visibility

    Theme

    \ No newline at end of file diff --git a/docs/types/KillHandler.html b/docs/types/KillHandler.html index bd007fad..7d048b26 100644 --- a/docs/types/KillHandler.html +++ b/docs/types/KillHandler.html @@ -1,2 +1,2 @@ -KillHandler | poolifier - v4.0.11

    Type alias KillHandler

    KillHandler: (() => void | Promise<void>)

    Handler called when a worker is killed.

    -

    Type declaration

      • (): void | Promise<void>

      • Returns void | Promise<void>

    Settings

    Member Visibility

    Theme

    \ No newline at end of file +KillHandler | poolifier - v4.0.12

    Type alias KillHandler

    KillHandler: (() => void | Promise<void>)

    Handler called when a worker is killed.

    +

    Type declaration

      • (): void | Promise<void>

      • Returns void | Promise<void>

    Settings

    Member Visibility

    Theme

    \ No newline at end of file diff --git a/docs/types/Measurement.html b/docs/types/Measurement.html index 3daa0de2..193f6121 100644 --- a/docs/types/Measurement.html +++ b/docs/types/Measurement.html @@ -1,2 +1,2 @@ -Measurement | poolifier - v4.0.11

    Type alias Measurement

    Measurement: keyof typeof Measurements

    Measurement.

    -

    Settings

    Member Visibility

    Theme

    \ No newline at end of file +Measurement | poolifier - v4.0.12

    Type alias Measurement

    Measurement: keyof typeof Measurements

    Measurement.

    +

    Settings

    Member Visibility

    Theme

    \ No newline at end of file diff --git a/docs/types/MessageHandler.html b/docs/types/MessageHandler.html index b93d68b5..3c56d9f7 100644 --- a/docs/types/MessageHandler.html +++ b/docs/types/MessageHandler.html @@ -1,3 +1,3 @@ -MessageHandler | poolifier - v4.0.11

    Type alias MessageHandler<Worker>

    MessageHandler<Worker>: ((this, message) => void)

    Callback invoked if the worker has received a message.

    +MessageHandler | poolifier - v4.0.12

    Type alias MessageHandler<Worker>

    MessageHandler<Worker>: ((this, message) => void)

    Callback invoked if the worker has received a message.

    Type Parameters

    • Worker extends IWorker

      Type of worker.

      -

    Type declaration

      • (this, message): void

      • Parameters

        Returns void

    Settings

    Member Visibility

    Theme

    \ No newline at end of file +

    Type declaration

      • (this, message): void

      • Parameters

        Returns void

    Settings

    Member Visibility

    Theme

    \ No newline at end of file diff --git a/docs/types/OnlineHandler.html b/docs/types/OnlineHandler.html index b48b9547..1548f4ec 100644 --- a/docs/types/OnlineHandler.html +++ b/docs/types/OnlineHandler.html @@ -1,3 +1,3 @@ -OnlineHandler | poolifier - v4.0.11

    Type alias OnlineHandler<Worker>

    OnlineHandler<Worker>: ((this) => void)

    Callback invoked when the worker has started successfully.

    +OnlineHandler | poolifier - v4.0.12

    Type alias OnlineHandler<Worker>

    OnlineHandler<Worker>: ((this) => void)

    Callback invoked when the worker has started successfully.

    Type Parameters

    • Worker extends IWorker

      Type of worker.

      -

    Type declaration

      • (this): void

      • Parameters

        Returns void

    Settings

    Member Visibility

    Theme

    \ No newline at end of file +

    Type declaration

      • (this): void

      • Parameters

        Returns void

    Settings

    Member Visibility

    Theme

    \ No newline at end of file diff --git a/docs/types/PoolEvent.html b/docs/types/PoolEvent.html index 4dfdb92d..12bc8cf7 100644 --- a/docs/types/PoolEvent.html +++ b/docs/types/PoolEvent.html @@ -1,2 +1,2 @@ -PoolEvent | poolifier - v4.0.11

    Type alias PoolEvent

    PoolEvent: keyof typeof PoolEvents

    Pool event.

    -

    Settings

    Member Visibility

    Theme

    \ No newline at end of file +PoolEvent | poolifier - v4.0.12

    Type alias PoolEvent

    PoolEvent: keyof typeof PoolEvents

    Pool event.

    +

    Settings

    Member Visibility

    Theme

    \ No newline at end of file diff --git a/docs/types/PoolType.html b/docs/types/PoolType.html index a9a3abe0..b22534c0 100644 --- a/docs/types/PoolType.html +++ b/docs/types/PoolType.html @@ -1,2 +1,2 @@ -PoolType | poolifier - v4.0.11

    Type alias PoolType

    PoolType: keyof typeof PoolTypes

    Pool type.

    -

    Settings

    Member Visibility

    Theme

    \ No newline at end of file +PoolType | poolifier - v4.0.12

    Type alias PoolType

    PoolType: keyof typeof PoolTypes

    Pool type.

    +

    Settings

    Member Visibility

    Theme

    \ No newline at end of file diff --git a/docs/types/TaskAsyncFunction.html b/docs/types/TaskAsyncFunction.html index fd862585..066fa619 100644 --- a/docs/types/TaskAsyncFunction.html +++ b/docs/types/TaskAsyncFunction.html @@ -1,7 +1,7 @@ -TaskAsyncFunction | poolifier - v4.0.11

    Type alias TaskAsyncFunction<Data, Response>

    TaskAsyncFunction<Data, Response>: ((data?) => Promise<Response>)

    Task asynchronous function that can be executed. +TaskAsyncFunction | poolifier - v4.0.12

    Type alias TaskAsyncFunction<Data, Response>

    TaskAsyncFunction<Data, Response>: ((data?) => Promise<Response>)

    Task asynchronous function that can be executed. This function must return a promise.

    Type Parameters

    • Data = unknown

      Type of data sent to the worker. This can only be structured-cloneable data.

    • Response = unknown

      Type of execution response. This can only be structured-cloneable data.

    Type declaration

      • (data?): Promise<Response>

      • Parameters

        • Optional data: Data

          Data sent to the worker.

        Returns Promise<Response>

    Returns

    Execution response promise.

    -

    Settings

    Member Visibility

    Theme

    \ No newline at end of file +

    Settings

    Member Visibility

    Theme

    \ No newline at end of file diff --git a/docs/types/TaskFunction.html b/docs/types/TaskFunction.html index 8327d708..b38303a5 100644 --- a/docs/types/TaskFunction.html +++ b/docs/types/TaskFunction.html @@ -1,5 +1,5 @@ -TaskFunction | poolifier - v4.0.11

    Type alias TaskFunction<Data, Response>

    TaskFunction<Data, Response>: TaskSyncFunction<Data, Response> | TaskAsyncFunction<Data, Response>

    Task function that can be executed. +TaskFunction | poolifier - v4.0.12

    Type alias TaskFunction<Data, Response>

    TaskFunction<Data, Response>: TaskSyncFunction<Data, Response> | TaskAsyncFunction<Data, Response>

    Task function that can be executed. This function can be synchronous or asynchronous.

    Type Parameters

    • Data = unknown

      Type of data sent to the worker. This can only be structured-cloneable data.

    • Response = unknown

      Type of execution response. This can only be structured-cloneable data.

      -

    Settings

    Member Visibility

    Theme

    \ No newline at end of file +

    Settings

    Member Visibility

    Theme

    \ No newline at end of file diff --git a/docs/types/TaskFunctions.html b/docs/types/TaskFunctions.html index a77cc90f..b5600e15 100644 --- a/docs/types/TaskFunctions.html +++ b/docs/types/TaskFunctions.html @@ -1,6 +1,6 @@ -TaskFunctions | poolifier - v4.0.11

    Type alias TaskFunctions<Data, Response>

    TaskFunctions<Data, Response>: Record<string, TaskFunction<Data, Response> | TaskFunctionObject<Data, Response>>

    Tasks functions that can be executed. +TaskFunctions | poolifier - v4.0.12

    Type alias TaskFunctions<Data, Response>

    TaskFunctions<Data, Response>: Record<string, TaskFunction<Data, Response> | TaskFunctionObject<Data, Response>>

    Tasks functions that can be executed. The key is the name of the task function or task function object. The value is the task function or task function object.

    Type Parameters

    • Data = unknown

      Type of data sent to the worker. This can only be structured-cloneable data.

    • Response = unknown

      Type of execution response. This can only be structured-cloneable data.

      -

    Settings

    Member Visibility

    Theme

    \ No newline at end of file +

    Settings

    Member Visibility

    Theme

    \ No newline at end of file diff --git a/docs/types/TaskSyncFunction.html b/docs/types/TaskSyncFunction.html index 45f8b7bc..f3e6c30a 100644 --- a/docs/types/TaskSyncFunction.html +++ b/docs/types/TaskSyncFunction.html @@ -1,6 +1,6 @@ -TaskSyncFunction | poolifier - v4.0.11

    Type alias TaskSyncFunction<Data, Response>

    TaskSyncFunction<Data, Response>: ((data?) => Response)

    Task synchronous function that can be executed.

    +TaskSyncFunction | poolifier - v4.0.12

    Type alias TaskSyncFunction<Data, Response>

    TaskSyncFunction<Data, Response>: ((data?) => Response)

    Task synchronous function that can be executed.

    Type Parameters

    • Data = unknown

      Type of data sent to the worker. This can only be structured-cloneable data.

    • Response = unknown

      Type of execution response. This can only be structured-cloneable data.

    Type declaration

    Returns

    Execution response.

    -

    Settings

    Member Visibility

    Theme

    \ No newline at end of file +

    Settings

    Member Visibility

    Theme

    \ No newline at end of file diff --git a/docs/types/ThreadPoolOptions.html b/docs/types/ThreadPoolOptions.html index ec7d7bab..d35ed078 100644 --- a/docs/types/ThreadPoolOptions.html +++ b/docs/types/ThreadPoolOptions.html @@ -1,2 +1,2 @@ -ThreadPoolOptions | poolifier - v4.0.11

    Type alias ThreadPoolOptions

    ThreadPoolOptions: PoolOptions<Worker>

    Options for a poolifier thread pool.

    -

    Settings

    Member Visibility

    Theme

    \ No newline at end of file +ThreadPoolOptions | poolifier - v4.0.12

    Type alias ThreadPoolOptions

    ThreadPoolOptions: PoolOptions<Worker>

    Options for a poolifier thread pool.

    +

    Settings

    Member Visibility

    Theme

    \ No newline at end of file diff --git a/docs/types/WorkerChoiceStrategy.html b/docs/types/WorkerChoiceStrategy.html index 5381bb97..daaa1f1d 100644 --- a/docs/types/WorkerChoiceStrategy.html +++ b/docs/types/WorkerChoiceStrategy.html @@ -1,2 +1,2 @@ -WorkerChoiceStrategy | poolifier - v4.0.11

    Type alias WorkerChoiceStrategy

    WorkerChoiceStrategy: keyof typeof WorkerChoiceStrategies

    Worker choice strategy.

    -

    Settings

    Member Visibility

    Theme

    \ No newline at end of file +WorkerChoiceStrategy | poolifier - v4.0.12

    Type alias WorkerChoiceStrategy

    WorkerChoiceStrategy: keyof typeof WorkerChoiceStrategies

    Worker choice strategy.

    +

    Settings

    Member Visibility

    Theme

    \ No newline at end of file diff --git a/docs/types/WorkerType.html b/docs/types/WorkerType.html index 598bb4b9..dd5916e7 100644 --- a/docs/types/WorkerType.html +++ b/docs/types/WorkerType.html @@ -1,2 +1,2 @@ -WorkerType | poolifier - v4.0.11

    Type alias WorkerType

    WorkerType: keyof typeof WorkerTypes

    Worker type.

    -

    Settings

    Member Visibility

    Theme

    \ No newline at end of file +WorkerType | poolifier - v4.0.12

    Type alias WorkerType

    WorkerType: keyof typeof WorkerTypes

    Worker type.

    +

    Settings

    Member Visibility

    Theme

    \ No newline at end of file diff --git a/docs/types/Writable.html b/docs/types/Writable.html index 6b7f6099..f92b8575 100644 --- a/docs/types/Writable.html +++ b/docs/types/Writable.html @@ -1 +1 @@ -Writable | poolifier - v4.0.11

    Type alias Writable<T>

    Writable<T>: {
        -readonly [P in keyof T]: T[P]
    }

    Type Parameters

    • T

    Settings

    Member Visibility

    Theme

    \ No newline at end of file +Writable | poolifier - v4.0.12

    Type alias Writable<T>

    Writable<T>: {
        -readonly [P in keyof T]: T[P]
    }

    Type Parameters

    • T

    Settings

    Member Visibility

    Theme

    \ No newline at end of file diff --git a/docs/variables/KillBehaviors.html b/docs/variables/KillBehaviors.html index dfe9ae83..cc04a885 100644 --- a/docs/variables/KillBehaviors.html +++ b/docs/variables/KillBehaviors.html @@ -1,2 +1,2 @@ -KillBehaviors | poolifier - v4.0.11

    Variable KillBehaviorsConst

    KillBehaviors: Readonly<{
        HARD: "HARD";
        SOFT: "SOFT";
    }> = ...

    Enumeration of kill behaviors.

    -

    Type declaration

    • HARD: "HARD"
    • SOFT: "SOFT"

    Settings

    Member Visibility

    Theme

    \ No newline at end of file +KillBehaviors | poolifier - v4.0.12

    Variable KillBehaviorsConst

    KillBehaviors: Readonly<{
        HARD: "HARD";
        SOFT: "SOFT";
    }> = ...

    Enumeration of kill behaviors.

    +

    Type declaration

    • HARD: "HARD"
    • SOFT: "SOFT"

    Settings

    Member Visibility

    Theme

    \ No newline at end of file diff --git a/docs/variables/Measurements.html b/docs/variables/Measurements.html index 9823ec24..630e9f78 100644 --- a/docs/variables/Measurements.html +++ b/docs/variables/Measurements.html @@ -1,2 +1,2 @@ -Measurements | poolifier - v4.0.11

    Variable MeasurementsConst

    Measurements: Readonly<{
        elu: "elu";
        runTime: "runTime";
        waitTime: "waitTime";
    }> = ...

    Enumeration of measurements.

    -

    Type declaration

    • elu: "elu"
    • runTime: "runTime"
    • waitTime: "waitTime"

    Settings

    Member Visibility

    Theme

    \ No newline at end of file +Measurements | poolifier - v4.0.12

    Variable MeasurementsConst

    Measurements: Readonly<{
        elu: "elu";
        runTime: "runTime";
        waitTime: "waitTime";
    }> = ...

    Enumeration of measurements.

    +

    Type declaration

    • elu: "elu"
    • runTime: "runTime"
    • waitTime: "waitTime"

    Settings

    Member Visibility

    Theme

    \ No newline at end of file diff --git a/docs/variables/PoolEvents.html b/docs/variables/PoolEvents.html index 063fcba6..f9deb1a9 100644 --- a/docs/variables/PoolEvents.html +++ b/docs/variables/PoolEvents.html @@ -1,2 +1,2 @@ -PoolEvents | poolifier - v4.0.11

    Variable PoolEventsConst

    PoolEvents: Readonly<{
        backPressure: "backPressure";
        busy: "busy";
        destroy: "destroy";
        empty: "empty";
        error: "error";
        full: "full";
        ready: "ready";
        taskError: "taskError";
    }> = ...

    Enumeration of pool events.

    -

    Type declaration

    • backPressure: "backPressure"
    • busy: "busy"
    • destroy: "destroy"
    • empty: "empty"
    • error: "error"
    • full: "full"
    • ready: "ready"
    • taskError: "taskError"

    Settings

    Member Visibility

    Theme

    \ No newline at end of file +PoolEvents | poolifier - v4.0.12

    Variable PoolEventsConst

    PoolEvents: Readonly<{
        backPressure: "backPressure";
        busy: "busy";
        destroy: "destroy";
        empty: "empty";
        error: "error";
        full: "full";
        ready: "ready";
        taskError: "taskError";
    }> = ...

    Enumeration of pool events.

    +

    Type declaration

    • backPressure: "backPressure"
    • busy: "busy"
    • destroy: "destroy"
    • empty: "empty"
    • error: "error"
    • full: "full"
    • ready: "ready"
    • taskError: "taskError"

    Settings

    Member Visibility

    Theme

    \ No newline at end of file diff --git a/docs/variables/PoolTypes.html b/docs/variables/PoolTypes.html index 8686d35b..c4f39285 100644 --- a/docs/variables/PoolTypes.html +++ b/docs/variables/PoolTypes.html @@ -1,2 +1,2 @@ -PoolTypes | poolifier - v4.0.11

    Variable PoolTypesConst

    PoolTypes: Readonly<{
        dynamic: "dynamic";
        fixed: "fixed";
    }> = ...

    Enumeration of pool types.

    -

    Type declaration

    • dynamic: "dynamic"
    • fixed: "fixed"

    Settings

    Member Visibility

    Theme

    \ No newline at end of file +PoolTypes | poolifier - v4.0.12

    Variable PoolTypesConst

    PoolTypes: Readonly<{
        dynamic: "dynamic";
        fixed: "fixed";
    }> = ...

    Enumeration of pool types.

    +

    Type declaration

    • dynamic: "dynamic"
    • fixed: "fixed"

    Settings

    Member Visibility

    Theme

    \ No newline at end of file diff --git a/docs/variables/WorkerChoiceStrategies.html b/docs/variables/WorkerChoiceStrategies.html index 566a92bc..0cc2bd8b 100644 --- a/docs/variables/WorkerChoiceStrategies.html +++ b/docs/variables/WorkerChoiceStrategies.html @@ -1,2 +1,2 @@ -WorkerChoiceStrategies | poolifier - v4.0.11

    Variable WorkerChoiceStrategiesConst

    WorkerChoiceStrategies: Readonly<{
        FAIR_SHARE: "FAIR_SHARE";
        INTERLEAVED_WEIGHTED_ROUND_ROBIN: "INTERLEAVED_WEIGHTED_ROUND_ROBIN";
        LEAST_BUSY: "LEAST_BUSY";
        LEAST_ELU: "LEAST_ELU";
        LEAST_USED: "LEAST_USED";
        ROUND_ROBIN: "ROUND_ROBIN";
        WEIGHTED_ROUND_ROBIN: "WEIGHTED_ROUND_ROBIN";
    }> = ...

    Enumeration of worker choice strategies.

    -

    Type declaration

    • FAIR_SHARE: "FAIR_SHARE"
    • INTERLEAVED_WEIGHTED_ROUND_ROBIN: "INTERLEAVED_WEIGHTED_ROUND_ROBIN"
    • LEAST_BUSY: "LEAST_BUSY"
    • LEAST_ELU: "LEAST_ELU"
    • LEAST_USED: "LEAST_USED"
    • ROUND_ROBIN: "ROUND_ROBIN"
    • WEIGHTED_ROUND_ROBIN: "WEIGHTED_ROUND_ROBIN"

    Settings

    Member Visibility

    Theme

    \ No newline at end of file +WorkerChoiceStrategies | poolifier - v4.0.12

    Variable WorkerChoiceStrategiesConst

    WorkerChoiceStrategies: Readonly<{
        FAIR_SHARE: "FAIR_SHARE";
        INTERLEAVED_WEIGHTED_ROUND_ROBIN: "INTERLEAVED_WEIGHTED_ROUND_ROBIN";
        LEAST_BUSY: "LEAST_BUSY";
        LEAST_ELU: "LEAST_ELU";
        LEAST_USED: "LEAST_USED";
        ROUND_ROBIN: "ROUND_ROBIN";
        WEIGHTED_ROUND_ROBIN: "WEIGHTED_ROUND_ROBIN";
    }> = ...

    Enumeration of worker choice strategies.

    +

    Type declaration

    • FAIR_SHARE: "FAIR_SHARE"
    • INTERLEAVED_WEIGHTED_ROUND_ROBIN: "INTERLEAVED_WEIGHTED_ROUND_ROBIN"
    • LEAST_BUSY: "LEAST_BUSY"
    • LEAST_ELU: "LEAST_ELU"
    • LEAST_USED: "LEAST_USED"
    • ROUND_ROBIN: "ROUND_ROBIN"
    • WEIGHTED_ROUND_ROBIN: "WEIGHTED_ROUND_ROBIN"

    Settings

    Member Visibility

    Theme

    \ No newline at end of file diff --git a/docs/variables/WorkerTypes.html b/docs/variables/WorkerTypes.html index df22460e..d2409e25 100644 --- a/docs/variables/WorkerTypes.html +++ b/docs/variables/WorkerTypes.html @@ -1,2 +1,2 @@ -WorkerTypes | poolifier - v4.0.11

    Variable WorkerTypesConst

    WorkerTypes: Readonly<{
        cluster: "cluster";
        thread: "thread";
    }> = ...

    Enumeration of worker types.

    -

    Type declaration

    • cluster: "cluster"
    • thread: "thread"

    Settings

    Member Visibility

    Theme

    \ No newline at end of file +WorkerTypes | poolifier - v4.0.12

    Variable WorkerTypesConst

    WorkerTypes: Readonly<{
        cluster: "cluster";
        thread: "thread";
    }> = ...

    Enumeration of worker types.

    +

    Type declaration

    • cluster: "cluster"
    • thread: "thread"

    Settings

    Member Visibility

    Theme

    \ No newline at end of file -- 2.34.1