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: https://github.com/nodejs/node/pull/51179
+ 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';
+
+constcommon=require('../common');
+constassert=require('assert');
+const{ test }=require('node:test');
+
+test('should emit deprecation warning DEP0165',async()=>{
+awaitcommon.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:/);
+}));
+});

test/parallel/test-trace-atomics-wait.js

@@ -25,7 +25,7 @@ if (process.argv[2] === 'child'){
 
 constproc=child_process.spawnSync(
 process.execPath,
-['--trace-atomics-wait',__filename,'child'],
+['--disable-warning=DEP0165','--trace-atomics-wait',__filename,'child'],
 {encoding: 'utf8',stdio: ['inherit','inherit','pipe']});
 
 if(proc.status!==0)console.log(proc);