Skip to content

[test optimization] Add support for --workerThreads flag in jest#7840

Merged
juan-fernandez merged 3 commits intomasterfrom
juan-fernandez/jest-worker-threads
Mar 30, 2026
Merged

[test optimization] Add support for --workerThreads flag in jest#7840
juan-fernandez merged 3 commits intomasterfrom
juan-fernandez/jest-worker-threads

Conversation

@juan-fernandez
Copy link
Copy Markdown
Collaborator

@juan-fernandez juan-fernandez commented Mar 23, 2026

What does this PR do?

Adds support for jest's --workerThreads flag so that test optimization instrumentation works when jest runs tests in worker threads instead of child processes.

Instrumentation (packages/datadog-instrumentations/src/jest.js):

  • Hook jest-worker's NodeThreadsWorker (ExperimentalWorker) for versions <30
  • Extract wrapWorker helper that detects worker type in the >=30 enqueueWrapper via _child (child_process) vs _worker (worker_threads)
  • Guard onMessageWrapper against non-array messages that can arrive in worker threads (e.g. from user code calling parentPort.postMessage)

Writer (packages/dd-trace/src/ci-visibility/exporters/test-worker/writer.js):

  • Remove the vitest-only guard on parentPort so jest worker threads can also send trace/coverage/logs/telemetry payloads back to the parent
  • Cleanly handle all three transport cases: process.send (child_process) → parentPort.postMessage (worker_threads) → fallback

Motivation

Jest supports --workerThreads to run tests in worker_threads instead of child_process. Our instrumentation previously only handled child process workers, so trace/coverage data was silently lost when this flag was enabled.

Testing

  • Integration tests verifying test events are reported correctly with --workerThreads (both agentless and evp proxy)
  • Integration test for non-array worker thread messages (ensures no TypeError when user code posts messages via parentPort)

Hook jest-worker's NodeThreadsWorker (ExperimentalWorker) for <30 and
detect worker type in the >=30 enqueue wrapper via _child vs _worker.
In the test-worker writer, remove the vitest-only guard on parentPort
so jest worker threads can also send trace/coverage/logs/telemetry
payloads back to the parent via worker_threads.

Add integration tests verifying test events are reported correctly
when jest runs with worker_threads (agentless and evp proxy).

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@codecov
Copy link
Copy Markdown

codecov Bot commented Mar 23, 2026

Codecov Report

❌ Patch coverage is 20.83333% with 19 lines in your changes missing coverage. Please review.
✅ Project coverage is 74.39%. Comparing base (51e9264) to head (4134b15).
⚠️ Report is 1 commits behind head on master.

Files with missing lines Patch % Lines
packages/datadog-instrumentations/src/jest.js 5.26% 18 Missing ⚠️
.../src/ci-visibility/exporters/test-worker/writer.js 80.00% 1 Missing ⚠️
Additional details and impacted files
@@            Coverage Diff             @@
##           master    #7840      +/-   ##
==========================================
- Coverage   74.41%   74.39%   -0.02%     
==========================================
  Files         768      768              
  Lines       35788    35800      +12     
==========================================
+ Hits        26630    26632       +2     
- Misses       9158     9168      +10     
Flag Coverage Δ
aiguard-macos 39.23% <ø> (-0.10%) ⬇️
aiguard-ubuntu 39.35% <ø> (-0.10%) ⬇️
aiguard-windows 39.02% <ø> (-0.10%) ⬇️
apm-capabilities-tracing-macos 49.04% <80.00%> (+<0.01%) ⬆️
apm-capabilities-tracing-ubuntu 48.95% <80.00%> (+<0.01%) ⬆️
apm-capabilities-tracing-windows 48.79% <80.00%> (-0.02%) ⬇️
apm-integrations-child-process 38.56% <ø> (-0.10%) ⬇️
apm-integrations-couchbase-18 37.36% <ø> (-0.10%) ⬇️
apm-integrations-couchbase-eol 37.85% <ø> (-0.10%) ⬇️
apm-integrations-oracledb 37.69% <ø> (-0.10%) ⬇️
appsec-express 55.17% <ø> (-0.07%) ⬇️
appsec-fastify 51.52% <ø> (-0.07%) ⬇️
appsec-graphql 51.68% <ø> (-0.08%) ⬇️
appsec-kafka 44.32% <ø> (-0.08%) ⬇️
appsec-ldapjs 43.94% <ø> (-0.08%) ⬇️
appsec-lodash 43.54% <ø> (-0.08%) ⬇️
appsec-macos 58.10% <ø> (-0.07%) ⬇️
appsec-mongodb-core 48.70% <ø> (-0.08%) ⬇️
appsec-mongoose 49.36% <ø> (-0.08%) ⬇️
appsec-mysql 50.79% <ø> (-0.07%) ⬇️
appsec-node-serialize 43.12% <ø> (-0.08%) ⬇️
appsec-passport 47.55% <ø> (-0.09%) ⬇️
appsec-postgres 50.51% <ø> (-0.07%) ⬇️
appsec-sourcing 42.37% <ø> (-0.08%) ⬇️
appsec-stripe 44.55% <ø> (-0.08%) ⬇️
appsec-template 43.29% <ø> (-0.08%) ⬇️
appsec-ubuntu 58.18% <ø> (-0.07%) ⬇️
appsec-windows 57.93% <ø> (-0.07%) ⬇️
instrumentations-instrumentation-bluebird 32.20% <ø> (-0.10%) ⬇️
instrumentations-instrumentation-body-parser 40.46% <ø> (-0.09%) ⬇️
instrumentations-instrumentation-child_process 37.90% <ø> (-0.10%) ⬇️
instrumentations-instrumentation-cookie-parser 34.23% <ø> (-0.09%) ⬇️
instrumentations-instrumentation-express 34.55% <ø> (-0.09%) ⬇️
instrumentations-instrumentation-express-mongo-sanitize 34.36% <ø> (-0.09%) ⬇️
instrumentations-instrumentation-express-session 40.10% <ø> (-0.09%) ⬇️
instrumentations-instrumentation-fs 31.89% <ø> (-0.10%) ⬇️
instrumentations-instrumentation-generic-pool 29.34% <ø> (ø)
instrumentations-instrumentation-http 39.81% <ø> (-0.10%) ⬇️
instrumentations-instrumentation-knex 32.27% <ø> (-0.10%) ⬇️
instrumentations-instrumentation-mongoose 33.39% <ø> (-0.09%) ⬇️
instrumentations-instrumentation-multer 40.21% <ø> (-0.09%) ⬇️
instrumentations-instrumentation-mysql2 38.24% <ø> (-0.10%) ⬇️
instrumentations-instrumentation-passport 43.98% <ø> (-0.09%) ⬇️
instrumentations-instrumentation-passport-http 43.66% <ø> (-0.09%) ⬇️
instrumentations-instrumentation-passport-local 44.19% <ø> (-0.09%) ⬇️
instrumentations-instrumentation-pg 37.68% <ø> (-0.10%) ⬇️
instrumentations-instrumentation-promise 32.13% <ø> (-0.10%) ⬇️
instrumentations-instrumentation-promise-js 32.14% <ø> (-0.10%) ⬇️
instrumentations-instrumentation-q 32.18% <ø> (-0.10%) ⬇️
instrumentations-instrumentation-url 32.10% <ø> (-0.10%) ⬇️
instrumentations-instrumentation-when 32.15% <ø> (-0.10%) ⬇️
llmobs-ai 42.37% <ø> (-0.10%) ⬇️
llmobs-anthropic 40.39% <ø> (-0.09%) ⬇️
llmobs-bedrock 39.18% <ø> (-0.08%) ⬇️
llmobs-google-genai 39.72% <ø> (-0.09%) ⬇️
llmobs-langchain 40.19% <ø> (+0.03%) ⬆️
llmobs-openai 43.90% <ø> (-0.09%) ⬇️
llmobs-vertex-ai 39.97% <ø> (-0.09%) ⬇️
platform-core 31.47% <ø> (ø)
platform-esbuild 34.42% <ø> (ø)
platform-instrumentations-misc 48.41% <ø> (ø)
platform-shimmer 37.56% <ø> (ø)
platform-unit-guardrails 32.89% <ø> (ø)
platform-webpack 19.98% <5.26%> (-0.02%) ⬇️
plugins-azure-durable-functions 25.74% <ø> (ø)
plugins-azure-event-hubs 25.90% <ø> (ø)
plugins-azure-service-bus 25.26% <ø> (ø)
plugins-bullmq 44.27% <ø> (-0.22%) ⬇️
plugins-cassandra 37.86% <ø> (+0.04%) ⬆️
plugins-cookie 26.96% <ø> (ø)
plugins-cookie-parser 26.75% <ø> (ø)
plugins-crypto 26.73% <ø> (ø)
plugins-dd-trace-api 38.26% <ø> (-0.10%) ⬇️
plugins-express-mongo-sanitize 26.89% <ø> (ø)
plugins-express-session 26.70% <ø> (ø)
plugins-fastify 42.18% <ø> (-0.09%) ⬇️
plugins-fetch 38.52% <ø> (+0.07%) ⬆️
plugins-fs 38.59% <ø> (-0.10%) ⬇️
plugins-generic-pool 25.94% <ø> (ø)
plugins-google-cloud-pubsub 45.49% <ø> (-0.09%) ⬇️
plugins-grpc 40.85% <ø> (-0.09%) ⬇️
plugins-handlebars 26.94% <ø> (ø)
plugins-hapi 40.10% <ø> (-0.10%) ⬇️
plugins-hono 40.43% <ø> (-0.10%) ⬇️
plugins-ioredis 38.40% <ø> (-0.10%) ⬇️
plugins-knex 26.57% <ø> (ø)
plugins-langgraph 38.45% <ø> (-0.10%) ⬇️
plugins-ldapjs 24.43% <ø> (ø)
plugins-light-my-request 26.30% <ø> (ø)
plugins-limitd-client 32.48% <ø> (-0.10%) ⬇️
plugins-lodash 26.03% <ø> (ø)
plugins-mariadb 39.44% <ø> (-0.10%) ⬇️
plugins-memcached 38.14% <ø> (-0.10%) ⬇️
plugins-microgateway-core 39.17% <ø> (-0.10%) ⬇️
plugins-moleculer 40.46% <ø> (-0.09%) ⬇️
plugins-mongodb 39.11% <ø> (-0.09%) ⬇️
plugins-mongodb-core 38.95% <ø> (-0.10%) ⬇️
plugins-mongoose 38.83% <ø> (-0.09%) ⬇️
plugins-multer 26.70% <ø> (ø)
plugins-mysql 39.11% <ø> (-0.13%) ⬇️
plugins-mysql2 39.23% <ø> (-0.10%) ⬇️
plugins-node-serialize 27.00% <ø> (ø)
plugins-opensearch 37.59% <ø> (-0.10%) ⬇️
plugins-passport-http 26.76% <ø> (ø)
plugins-postgres 35.48% <ø> (-0.09%) ⬇️
plugins-process 26.73% <ø> (ø)
plugins-pug 26.96% <ø> (ø)
plugins-redis 38.85% <ø> (-0.11%) ⬇️
plugins-router 43.03% <ø> (-0.23%) ⬇️
plugins-sequelize 25.55% <ø> (ø)
plugins-test-and-upstream-amqp10 38.30% <ø> (-0.24%) ⬇️
plugins-test-and-upstream-amqplib 44.15% <ø> (-0.10%) ⬇️
plugins-test-and-upstream-apollo 39.08% <ø> (-0.09%) ⬇️
plugins-test-and-upstream-avsc 38.52% <ø> (-0.10%) ⬇️
plugins-test-and-upstream-bunyan 33.80% <ø> (-0.10%) ⬇️
plugins-test-and-upstream-connect 40.75% <ø> (-0.10%) ⬇️
plugins-test-and-upstream-graphql 40.10% <ø> (-0.10%) ⬇️
plugins-test-and-upstream-koa 40.34% <ø> (-0.10%) ⬇️
plugins-test-and-upstream-protobufjs 38.75% <ø> (-0.10%) ⬇️
plugins-test-and-upstream-rhea 44.16% <ø> (-0.13%) ⬇️
plugins-undici 39.07% <ø> (-0.09%) ⬇️
plugins-url 26.73% <ø> (ø)
plugins-valkey 38.26% <ø> (+0.04%) ⬆️
plugins-vm 26.73% <ø> (ø)
plugins-winston 33.99% <ø> (-0.10%) ⬇️
plugins-ws 41.93% <ø> (-0.10%) ⬇️
profiling-macos 40.47% <ø> (-0.10%) ⬇️
profiling-ubuntu 40.59% <ø> (-0.10%) ⬇️
profiling-windows 42.15% <ø> (-0.10%) ⬇️
serverless-azure-functions-client 25.62% <ø> (ø)
serverless-azure-functions-eventhubs 25.62% <ø> (ø)
serverless-azure-functions-servicebus 25.62% <ø> (ø)

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
  • 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented Mar 23, 2026

Overall package size

Self size: 5.06 MB
Deduped: 5.91 MB
No deduping: 5.91 MB

Dependency sizes | name | version | self size | total size | |------|---------|-----------|------------| | import-in-the-middle | 3.0.0 | 81.15 kB | 815.98 kB | | dc-polyfill | 0.1.10 | 26.73 kB | 26.73 kB |

🤖 This report was automatically generated by heaviest-objects-in-the-universe

@pr-commenter
Copy link
Copy Markdown

pr-commenter Bot commented Mar 23, 2026

Benchmarks

Benchmark execution time: 2026-03-30 14:11:23

Comparing candidate commit 4134b15 in PR branch juan-fernandez/jest-worker-threads with baseline commit 51e9264 in branch master.

Found 0 performance improvements and 0 performance regressions! Performance is the same for 229 metrics, 31 unstable metrics.

@juan-fernandez juan-fernandez changed the title feat(jest): add support for --workerThreads flag [test optimizaton] Add support for --workerThreads flag in jest Mar 30, 2026
@juan-fernandez juan-fernandez changed the title [test optimizaton] Add support for --workerThreads flag in jest [test optimization] Add support for --workerThreads flag in jest Mar 30, 2026
@juan-fernandez juan-fernandez marked this pull request as ready for review March 30, 2026 14:02
@juan-fernandez juan-fernandez requested a review from a team as a code owner March 30, 2026 14:02
@datadog-prod-us1-3
Copy link
Copy Markdown

datadog-prod-us1-3 Bot commented Mar 30, 2026

✅ Tests

🎉 All green!

❄️ No new flaky tests detected
🧪 All tests passed

🎯 Code Coverage (details)
Patch Coverage: 16.67%
Overall Coverage: 68.84% (-0.02%)

This comment will be updated automatically if new data arrives.
🔗 Commit SHA: 4134b15 | Docs | Datadog PR Page | Was this helpful? React with 👍/👎 or give us feedback!

@juan-fernandez juan-fernandez merged commit edb4236 into master Mar 30, 2026
844 of 845 checks passed
@juan-fernandez juan-fernandez deleted the juan-fernandez/jest-worker-threads branch March 30, 2026 14:30
@dd-octo-sts dd-octo-sts Bot mentioned this pull request Mar 31, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants