doc: runtime deprecate flag --trace-atomics-wait

Author: marco-ippolito

doc/api/deprecations.md

@@ -3313,16 +3313,21 @@ Values other than `undefined`, `null`, integer numbers, and integer strings
 
 <!-- YAML
 changes:
+  - version: REPLACEME
+    pr-url: REPLACEME
+    description: Runtime deprecation.
   - version:
     - v18.8.0
     - v16.18.0
     pr-url: https://github.com/nodejs/node/pull/44093
     description: Documentation-only deprecation.
 -->
 
-Type: Documentation-only
+Type: Runtime
 
-The [`--trace-atomics-wait`][] flag is deprecated.
+The [`--trace-atomics-wait`][] flag is deprecated because
+it uses the V8 hook `SetAtomicsWaitCallback`,
+that will be removed in a future V8 release.
 
 ### DEP0166: Double slashes in imports and exports targets
 

src/node.cc

@@ -258,6 +258,10 @@ void Environment::InitializeDiagnostics() {
   if (options_->trace_uncaught)
     isolate_->SetCaptureStackTraceForUncaughtExceptions(true);
   if (options_->trace_atomics_wait) {
+    ProcessEmitDeprecationWarning(
+        Environment::GetCurrent(isolate_),
+        "The flag --trace-atomics-wait is deprecated.",
+        "DEP0165");
     isolate_->SetAtomicsWaitCallback(AtomicsWaitCallback, this);
     AddCleanupHook([](void* data) {
       Environment* env = static_cast<Environment*>(data);

test/parallel/test-trace-atomic-deprecation.js

@@ -0,0 +1,14 @@
+'use strict';
+
+const common = require('../common');
+const assert = require('assert');
+const { test } = require('node:test');
+
+test('should emit deprecation warning DEP0165', async () => {
+  await common.spawnPromisified(process.execPath, ['--trace-atomics-wait', '-e', '{}'])
+        .then(common.mustCall(({ code, stdout, stderr }) => {
+          assert.strictEqual(code, 0);
+          assert.strictEqual(stdout, '');
+          assert.match(stderr, /\[DEP0165\] DeprecationWarning:/);
+        }));
+});