CodeSampleX

Beispiel

jest-worker 29.7.0: FifoQueue

Verifiziertes Beispiel für npm jest-worker 29.7.0: FifoQueue. Der Vertrag lief auf node 22 · linux debian/x64 · docker und bestand.

sha256:d5c8b20a324fd6ccb353abb3de2e3ec94954c20eb9c5d192f00f2d08f90dc2ad

Dieses Netzwerk bietet eine Sache: ein Sample, das baut. Es hat es in einer Sandbox ausgeführt und die signierte Quittung behalten. Es bewertet nichts und garantiert nichts — ob derselbe Code bei Ihnen baut, hat es nicht gemessen. Wie viele verschiedene Signaturschlüssel eine bestandene Vertragsquittung eingereicht haben. Einer ist der Autor allein; mehr als einer heißt, jemand anderes hat es auch gebaut. Ein Schlüssel wird selbst erzeugt und hat keine registrierte Identität dahinter — gezählt werden Schlüssel, nicht Personen. MIT-0

Ausführungsbelege

Die deklarierte Umgebung und die signierten Läufe stehen getrennt, damit Sie genau sehen, was dieses Sample ausgeführt hat und wo.

Beleggrundlage
Signierter Vertrag bestanden
Verifizierungsbelege
1
Signaturschlüssel, die es gebaut haben
1
Deklarierte Umgebung node 22.23 linux 24 · ubuntu · glibc 2.39 x64 node 22.23 javascript npm 10

Umgebungen der Verifizierungsläufe

Umgebung Contract Stufen Lauf
node 22 · linux debian/x64 · docker ed25519:c1973797be207ac4 PASS compile:SKIPPED · contract:PASS · load:PASS · resolve:PASS
CONTAINER_RUN · node-typescript@1node:22@sha256:8a34c4ab3ea2…		 2026-09-05

Fall

HOW
Ziel
verify jest-worker.FifoQueue in pkg:npm/jest-worker@29.7.0
Pakete
Symbole
  • jest-worker.FifoQueue
Umgebung
node 22.23.2
Erstellt
2026-09-05T19:10:48Z

Contract

  1. FifoQueue returns null when attempting to dequeue from an empty queue or empty worker-specific queue
  2. FifoQueue enqueues and dequeues shared tasks in first-in-first-out order across different worker IDs
  3. FifoQueue isolates tasks assigned to specific worker IDs from other workers
  4. FifoQueue prioritizes pending shared tasks over worker-specific tasks when the prior shared task is unprocessed
  5. FifoQueue dequeues worker-specific tasks after their preceding shared tasks have been marked as processed

Dateien

  • PROMPT.md
  • csx.json
  • index.js
  • package-lock.json
  • package.json
  • spec.json
  • test/contract.js

Quellartefakt herunterladen (tar.gz)

Quelltext

PROMPT.md
Clean-room public code sample — generation instructions

Write a brand-new, minimal, self-contained code sample in this clean-room directory.
Do not copy, paraphrase, or reference any existing project source. Work only from this spec.

A csx.json manifest scaffold already exists. Do not recreate it from memory. Preserve its case.goal, packages and symbols; fill its empty case.contract with exact assertions and correct its environment, commands and verifierAdapter for the files you generate.

Goal: verify jest-worker.FifoQueue in pkg:npm/jest-worker@29.7.0
Kind: HOW

Use EXACTLY these public packages and versions:
  - pkg:npm/jest-worker@29.7.0
Demonstrate these symbols/APIs:
  - jest-worker.FifoQueue

Rules:
  - One focused purpose; the smallest project that proves the goal.
  - Include a contract test (test/contract.*) that runs OFFLINE and exits 0 exactly when the goal behavior works.
  - Pin every dependency with a lockfile so resolution is reproducible.
  - No secrets, credentials, or tokens. No real URLs (only example.com or localhost). No absolute paths.
  - No personal names, emails, company names, or project identifiers of any kind.
  - No binaries and no generated output (node_modules, dist, target, venv, .git, .env).
  - Keep it under 200 files and 256KB packed.
csx.json
{"case":{"caseId":"case:sha256:c709bfc8f723f3edcf08550eafe22c6bef384e76fd9c77284aadc3d5008bcd0b","constraints":{"executionContext":"node"},"contract":["FifoQueue returns null when attempting to dequeue from an empty queue or empty worker-specific queue","FifoQueue enqueues and dequeues shared tasks in first-in-first-out order across different worker IDs","FifoQueue isolates tasks assigned to specific worker IDs from other workers","FifoQueue prioritizes pending shared tasks over worker-specific tasks when the prior shared task is unprocessed","FifoQueue dequeues worker-specific tasks after their preceding shared tasks have been marked as processed"],"goal":"verify jest-worker.FifoQueue in pkg:npm/jest-worker@29.7.0","kind":"HOW","packages":["pkg:npm/jest-worker@29.7.0"],"schemaVersion":1,"symbols":["jest-worker.FifoQueue"]},"contractCommand":["node","test/contract.js"],"environment":{"arch":"x64","distro":"ubuntu","ecosystem":"npm","executionContext":"node","language":"javascript","libc":"glibc","libcVersion":"2.39","moduleSystem":"cjs","os":"linux","osVersionBucket":"24","packageManager":"npm","packageManagerVersion":"10.9.8","runtime":"node","runtimeVersion":"22.23.2","schemaVersion":1},"license":"MIT-0","packages":["pkg:npm/jest-worker@29.7.0"],"schemaVersion":1,"subject":"pkg:npm/jest-worker@29.7.0","symbols":["jest-worker.FifoQueue"],"verifierAdapter":"node-typescript@1"}
index.js
'use strict';

const { FifoQueue } = require('jest-worker');

/**
 * Creates a new FifoQueue instance.
 * @returns {FifoQueue}
 */
function createFifoQueue() {
  return new FifoQueue();
}

/**
 * Creates a mock child message task object adhering to QueueChildMessage contract.
 * @param {string} methodName
 * @param {Array<unknown>} [args=[]]
 * @param {boolean} [isProcessed=false]
 * @returns {object}
 */
function createMockTask(methodName, args = [], isProcessed = false) {
  return {
    request: [1, isProcessed, methodName, args],
    onStart: () => {},
    onEnd: () => {},
    onCustomMessage: () => {}
  };
}

module.exports = {
  FifoQueue,
  createFifoQueue,
  createMockTask
};
package-lock.json
{
  "name": "sample-jest-worker-fifoqueue-verify",
  "version": "1.0.0",
  "lockfileVersion": 3,
  "requires": true,
  "packages": {
    "": {
      "name": "sample-jest-worker-fifoqueue-verify",
      "version": "1.0.0",
      "license": "MIT-0",
      "dependencies": {
        "jest-worker": "29.7.0"
      }
    },
    "node_modules/@jest/schemas": {
      "version": "29.6.3",
      "resolved": "https://registry.npmjs.org/@jest/schemas/-/schemas-29.6.3.tgz",
      "integrity": "sha512-mo5j5X+jIZmJQveBKeS/clAueipV7KgiX1vMgCxam1RNYiqE1w62n0/tJJnHtjW8ZHcQco5gY85jA3mi0L+nSA==",
      "license": "MIT",
      "dependencies": {
        "@sinclair/typebox": "^0.27.8"
      },
      "engines": {
        "node": "^14.15.0 || ^16.10.0 || >=18.0.0"
      }
    },
    "node_modules/@jest/types": {
      "version": "29.6.3",
      "resolved": "https://registry.npmjs.org/@jest/types/-/types-29.6.3.tgz",
      "integrity": "sha512-u3UPsIilWKOM3F9CXtrG8LEJmNxwoCQC/XVj4IKYXvvpx7QIi/Kg1LI5uDmDpKlac62NUtX7eLjRh+jVZcLOzw==",
      "license": "MIT",
      "dependencies": {
        "@jest/schemas": "^29.6.3",
        "@types/istanbul-lib-coverage": "^2.0.0",
        "@types/istanbul-reports": "^3.0.0",
        "@types/node": "*",
        "@types/yargs": "^17.0.8",
        "chalk": "^4.0.0"
      },
      "engines": {
        "node": "^14.15.0 || ^16.10.0 || >=18.0.0"
      }
    },
    "node_modules/@sinclair/typebox": {
      "version": "0.27.12",
      "resolved": "https://registry.npmjs.org/@sinclair/typebox/-/typebox-0.27.12.tgz",
      "integrity": "sha512-hhyNJ+nbR6ZR7pToHvllEFun9TL0sbL+tk/ON75lo+Xas054uez98qRbsuNt7MBCyZKK4+8Yli/OAGZhmfBZ/g==",
      "license": "MIT"
    },
    "node_modules/@types/istanbul-lib-coverage": {
      "version": "2.0.6",
      "resolved": "https://registry.npmjs.org/@types/istanbul-lib-coverage/-/istanbul-lib-coverage-2.0.6.tgz",
      "integrity": "sha512-2QF/t/auWm0lsy8XtKVPG19v3sSOQlJe/YHZgfjb/KBBHOGSV+J2q/S671rcq9uTBrLAXmZpqJiaQbMT+zNU1w==",
      "license": "MIT"
    },
    "node_modules/@types/istanbul-lib-report": {
      "version": "3.0.3",
      "resolved": "https://registry.npmjs.org/@types/istanbul-lib-report/-/istanbul-lib-report-3.0.3.tgz",
      "integrity": "sha512-NQn7AHQnk/RSLOxrBbGyJM/aVQ+pjj5HCgasFxc0K/KhoATfQ/47AyUl15I2yBUpihjmas+a+VJBOqecrFH+uA==",
      "license": "MIT",
      "dependencies": {
        "@types/istanbul-lib-coverage": "*"
      }
    },
    "node_modules/@types/istanbul-reports": {
      "version": "3.0.4",
      "resolved": "https://registry.npmjs.org/@types/istanbul-reports/-/istanbul-reports-3.0.4.tgz",
      "integrity": "sha512-pk2B1NWalF9toCRu6gjBzR69syFjP4Od8WRAX+0mmf9lAjCRicLOWc+ZrxZHx/0XRjotgkF9t6iaMJ+aXcOdZQ==",
      "license": "MIT",
      "dependencies": {
        "@types/istanbul-lib-report": "*"
      }
    },
    "node_modules/@types/node": {
      "version": "26.4.1",
      "resolved": "https://registry.npmjs.org/@types/node/-/node-26.4.1.tgz",
      "integrity": "sha512-k97ENvZWtvA6yqz5/FS6a7duDgOPEeOQOc2iKS/nY6mX6qJUKtLnWzQS+Xj6tXweyj6ZcTAK2Qecetnvi9nCLA==",
      "license": "MIT",
      "dependencies": {
        "undici-types": "~8.3.0"
      }
    },
    "node_modules/@types/yargs": {
      "version": "17.0.35",
      "resolved": "https://registry.npmjs.org/@types/yargs/-/yargs-17.0.35.tgz",
      "integrity": "sha512-qUHkeCyQFxMXg79wQfTtfndEC+N9ZZg76HJftDJp+qH2tV7Gj4OJi7l+PiWwJ+pWtW8GwSmqsDj/oymhrTWXjg==",
      "license": "MIT",
      "dependencies": {
        "@types/yargs-parser": "*"
      }
    },
    "node_modules/@types/yargs-parser": {
      "version": "21.0.3",
      "resolved": "https://registry.npmjs.org/@types/yargs-parser/-/yargs-parser-21.0.3.tgz",
      "integrity": "sha512-I4q9QU9MQv4oEOz4tAHJtNz1cwuLxn2F3xcc2iV5WdqLPpUnj30aUuxt1mAxYTG+oe8CZMV/+6rU4S4gRDzqtQ==",
      "license": "MIT"
    },
    "node_modules/ansi-styles": {
      "version": "4.3.0",
      "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-4.3.0.tgz",
      "integrity": "sha512-zbB9rCJAT1rbjiVDb2hqKFHNYLxgtk8NURxZ3IZwD3F6NtxbXZQCnnSi1Lkx+IDohdPlFp222wVALIheZJQSEg==",
      "license": "MIT",
      "dependencies": {
        "color-convert": "^2.0.1"
      },
      "engines": {
        "node": ">=8"
      },
      "funding": {
        "url": "https://github.com/chalk/ansi-styles?sponsor=1"
      }
    },
    "node_modules/chalk": {
      "version": "4.1.2",
      "resolved": "https://registry.npmjs.org/chalk/-/chalk-4.1.2.tgz",
      "integrity": "sha512-oKnbhFyRIXpUuez8iBMmyEa4nbj4IOQyuhc/wy9kY7/WVPcwIO9VA668Pu8RkO7+0G76SLROeyw9CpQ061i4mA==",
      "license": "MIT",
      "dependencies": {
        "ansi-styles": "^4.1.0",
        "supports-color": "^7.1.0"
      },
      "engines": {
        "node": ">=10"
      },
      "funding": {
        "url": "https://github.com/chalk/chalk?sponsor=1"
      }
    },
    "node_modules/chalk/node_modules/supports-color": {
      "version": "7.2.0",
      "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-7.2.0.tgz",
      "integrity": "sha512-qpCAvRl9stuOHveKsn7HncJRvv501qIacKzQlO/+Lwxc9+0q2wLyv4Dfvt80/DPn2pqOBsJdDiogXGR9+OvwRw==",
      "license": "MIT",
      "dependencies": {
        "has-flag": "^4.0.0"
      },
      "engines": {
        "node": ">=8"
      }
    },
    "node_modules/ci-info": {
      "version": "3.9.0",
      "resolved": "https://registry.npmjs.org/ci-info/-/ci-info-3.9.0.tgz",
      "integrity": "sha512-NIxF55hv4nSqQswkAeiOi1r83xy8JldOFDTWiug55KBu9Jnblncd2U6ViHmYgHf01TPZS77NJBhBMKdWj9HQMQ==",
      "funding": [
        {
          "type": "github",
          "url": "https://github.com/sponsors/sibiraj-s"
        }
      ],
      "license": "MIT",
      "engines": {
        "node": ">=8"
      }
    },
    "node_modules/color-convert": {
      "version": "2.0.1",
      "resolved": "https://registry.npmjs.org/color-convert/-/color-convert-2.0.1.tgz",
      "integrity": "sha512-RRECPsj7iu/xb5oKYcsFHSppFNnsj/52OVTRKb4zP5onXwVF3zVmmToNcOfGC+CRDpfK/U584fMg38ZHCaElKQ==",
      "license": "MIT",
      "dependencies": {
        "color-name": "~1.1.4"
      },
      "engines": {
        "node": ">=7.0.0"
      }
    },
    "node_modules/color-name": {
      "version": "1.1.4",
      "resolved": "https://registry.npmjs.org/color-name/-/color-name-1.1.4.tgz",
      "integrity": "sha512-dOy+3AuW3a2wNbZHIuMZpTcgjGuLU/uBL/ubcZF9OXbDo8ff4O8yVp5Bf0efS8uEoYo5q4Fx7dY9OgQGXgAsQA==",
      "license": "MIT"
    },
    "node_modules/graceful-fs": {
      "version": "4.2.11",
      "resolved": "https://registry.npmjs.org/graceful-fs/-/graceful-fs-4.2.11.tgz",
      "integrity": "sha512-RbJ5/jmFcNNCcDV5o9eTnBLJ/HszWV0P73bc+Ff4nS/rJj+YaS6IGyiOL0VoBYX+l1Wrl3k63h/KrH+nhJ0XvQ==",
      "license": "ISC"
    },
    "node_modules/has-flag": {
      "version": "4.0.0",
      "resolved": "https://registry.npmjs.org/has-flag/-/has-flag-4.0.0.tgz",
      "integrity": "sha512-EykJT/Q1KjTWctppgIAgfSO0tKVuZUjhgMr17kqTumMl6Afv3EISleU7qZUzoXDFTAHTDC4NOoG/ZxU3EvlMPQ==",
      "license": "MIT",
      "engines": {
        "node": ">=8"
      }
    },
    "node_modules/jest-util": {
      "version": "29.7.0",
      "resolved": "https://registry.npmjs.org/jest-util/-/jest-util-29.7.0.tgz",
      "integrity": "sha512-z6EbKajIpqGKU56y5KBUgy1dt1ihhQJgWzUlZHArA/+X2ad7Cb5iF+AK1EWVL/Bo7Rz9uurpqw6SiBCefUbCGA==",
      "license": "MIT",
      "dependencies": {
        "@jest/types": "^29.6.3",
        "@types/node": "*",
        "chalk": "^4.0.0",
        "ci-info": "^3.2.0",
        "graceful-fs": "^4.2.9",
        "picomatch": "^2.2.3"
      },
      "engines": {
        "node": "^14.15.0 || ^16.10.0 || >=18.0.0"
      }
    },
    "node_modules/jest-worker": {
      "version": "29.7.0",
      "resolved": "https://registry.npmjs.org/jest-worker/-/jest-worker-29.7.0.tgz",
      "integrity": "sha512-eIz2msL/EzL9UFTFFx7jBTkeZfku0yUAyZZZmJ93H2TYEiroIx2PQjEXcwYtYl8zXCxb+PAmA2hLIt/6ZEkPHw==",
      "license": "MIT",
      "dependencies": {
        "@types/node": "*",
        "jest-util": "^29.7.0",
        "merge-stream": "^2.0.0",
        "supports-color": "^8.0.0"
      },
      "engines": {
        "node": "^14.15.0 || ^16.10.0 || >=18.0.0"
      }
    },
    "node_modules/merge-stream": {
      "version": "2.0.0",
      "resolved": "https://registry.npmjs.org/merge-stream/-/merge-stream-2.0.0.tgz",
      "integrity": "sha512-abv/qOcuPfk3URPfDzmZU1LKmuw8kT+0nIHvKrKgFrwifol/doWcdA4ZqsWQ8ENrFKkd67Mfpo/LovbIUsbt3w==",
      "license": "MIT"
    },
    "node_modules/picomatch": {
      "version": "2.3.2",
      "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-2.3.2.tgz",
      "integrity": "sha512-V7+vQEJ06Z+c5tSye8S+nHUfI51xoXIXjHQ99cQtKUkQqqO1kO/KCJUfZXuB47h/YBlDhah2H3hdUGXn8ie0oA==",
      "license": "MIT",
      "engines": {
        "node": ">=8.6"
      },
      "funding": {
        "url": "https://github.com/sponsors/jonschlinkert"
      }
    },
    "node_modules/supports-color": {
      "version": "8.1.1",
      "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-8.1.1.tgz",
      "integrity": "sha512-MpUEN2OodtUzxvKQl72cUF7RQ5EiHsGvSsVG0ia9c5RbWGL2CI4C7EpPS8UTBIplnlzZiNuV56w+FuNxy3ty2Q==",
      "license": "MIT",
      "dependencies": {
        "has-flag": "^4.0.0"
      },
      "engines": {
        "node": ">=10"
      },
      "funding": {
        "url": "https://github.com/chalk/supports-color?sponsor=1"
      }
    },
    "node_modules/undici-types": {
      "version": "8.3.0",
      "resolved": "https://registry.npmjs.org/undici-types/-/undici-types-8.3.0.tgz",
      "integrity": "sha512-j375ScV60dom+YkPFIfTLcOiPxkN/buHz5GobjLhixFuANaNs3C9l4GmrWqejgXWJ7BbJcFYpTEUkS1Ge8bpZQ==",
      "license": "MIT"
    }
  }
}
package.json
{
  "name": "sample-jest-worker-fifoqueue-verify",
  "version": "1.0.0",
  "private": true,
  "description": "verify jest-worker.FifoQueue in pkg:npm/jest-worker@29.7.0",
  "main": "index.js",
  "scripts": {
    "test": "node test/contract.js"
  },
  "dependencies": {
    "jest-worker": "29.7.0"
  },
  "license": "MIT-0"
}
spec.json
{
  "schemaVersion": 1,
  "goal": "verify jest-worker.FifoQueue in pkg:npm/jest-worker@29.7.0",
  "kind": "HOW",
  "packages": [
    "pkg:npm/jest-worker@29.7.0"
  ],
  "symbols": [
    "jest-worker.FifoQueue"
  ]
}
test/contract.js
'use strict';

const assert = require('assert');
const { FifoQueue, createFifoQueue, createMockTask } = require('../index.js');

function testEmptyQueueReturnsNull() {
  const queue = createFifoQueue();
  assert.strictEqual(queue.dequeue(0), null, 'dequeue from empty queue should return null');
  assert.strictEqual(queue.dequeue(1), null, 'dequeue with different workerId from empty queue should return null');
}

function testSharedFifoOrdering() {
  const queue = createFifoQueue();
  const task1 = createMockTask('taskA', [1]);
  const task2 = createMockTask('taskB', [2]);
  const task3 = createMockTask('taskC', [3]);

  queue.enqueue(task1);
  queue.enqueue(task2);
  queue.enqueue(task3);

  assert.strictEqual(queue.dequeue(0), task1, 'first shared task dequeued by worker 0');
  assert.strictEqual(queue.dequeue(1), task2, 'second shared task dequeued by worker 1');
  assert.strictEqual(queue.dequeue(2), task3, 'third shared task dequeued by worker 2');
  assert.strictEqual(queue.dequeue(0), null, 'queue empty after all shared tasks dequeued');
}

function testWorkerSpecificIsolation() {
  const queue = createFifoQueue();
  const worker0Task = createMockTask('worker0Task', ['w0']);
  const worker1Task = createMockTask('worker1Task', ['w1']);

  queue.enqueue(worker0Task, 0);
  queue.enqueue(worker1Task, 1);

  // Worker 2 has no specific tasks and shared queue is empty -> returns null
  assert.strictEqual(queue.dequeue(2), null, 'worker 2 should receive null');

  // Worker 0 dequeues its task
  assert.strictEqual(queue.dequeue(0), worker0Task, 'worker 0 should receive its assigned task');
  assert.strictEqual(queue.dequeue(0), null, 'worker 0 queue should now be empty');

  // Worker 1 dequeues its task
  assert.strictEqual(queue.dequeue(1), worker1Task, 'worker 1 should receive its assigned task');
  assert.strictEqual(queue.dequeue(1), null, 'worker 1 queue should now be empty');
}

function testSharedTaskPrecedenceWhenUnprocessed() {
  const queue = createFifoQueue();
  const sharedTask = createMockTask('sharedTask', ['shared'], false);
  const workerTask = createMockTask('workerTask', ['worker0'], false);

  queue.enqueue(sharedTask); // shared queue
  queue.enqueue(workerTask, 0); // worker 0 queue; records previousSharedTask = sharedTask

  // Worker 0 dequeues: because sharedTask.request[1] is false, shared task has precedence
  const dequeued = queue.dequeue(0);
  assert.strictEqual(dequeued, sharedTask, 'unprocessed shared task must be dequeued before worker-specific task');

  // Worker 0 attempts to dequeue again: sharedTask was dequeued from shared queue, but not yet marked processed
  const dequeuedAgain = queue.dequeue(0);
  assert.strictEqual(dequeuedAgain, null, 'worker-specific task remains blocked until previous shared task is processed');
}

function testWorkerTaskDequeuedWhenPriorSharedProcessed() {
  const queue = createFifoQueue();
  const sharedTask = createMockTask('sharedTask', ['shared'], false);
  const workerTask = createMockTask('workerTask', ['worker0'], false);

  queue.enqueue(sharedTask);
  queue.enqueue(workerTask, 0);

  // Worker dequeues shared task
  const first = queue.dequeue(0);
  assert.strictEqual(first, sharedTask);

  // Mark shared task as completed/processed
  sharedTask.request[1] = true;

  // Now worker 0 should be unblocked and receive its worker-specific task
  const second = queue.dequeue(0);
  assert.strictEqual(second, workerTask, 'worker-specific task should be dequeued after prior shared task is processed');

  assert.strictEqual(queue.dequeue(0), null, 'queue should be empty');
}

function runAll() {
  testEmptyQueueReturnsNull();
  testSharedFifoOrdering();
  testWorkerSpecificIsolation();
  testSharedTaskPrecedenceWhenUnprocessed();
  testWorkerTaskDequeuedWhenPriorSharedProcessed();

  console.log('Contract tests passed successfully.');
}

runAll();

Ursprungs-Seeder

anonym