test: update fs.stat AbortSignal test

Author: mertcanaltin

test/parallel/test-fs-stat-abort-test.js

@@ -6,11 +6,16 @@ const assert = require('node:assert');
 const fs = require('node:fs');
 const tmpdir = require('../common/tmpdir');
 
-test('fs.stat should throw AbortError when abort signal is triggered', async () => {
+test('fs.stat should throw AbortError when called with an already aborted AbortSignal', async () => {
+  // This test verifies that fs.stat immediately throws an AbortError if the provided AbortSignal
+  // has already been aborted. This approach is used because attempting to abort an fs.stat call in-flight
+  // is unreliable given that file system operations tend to complete very quickly on many platforms.
   tmpdir.refresh();
 
   const filePath = tmpdir.resolve('temp.txt');
   fs.writeFileSync(filePath, 'Test');
+
+  // Create an already aborted AbortSignal.
   const signal = AbortSignal.abort();
 
   const { promise, resolve, reject } = Promise.withResolvers();
@@ -21,6 +26,7 @@ test('fs.stat should throw AbortError when abort signal is triggered', async ()
     resolve(stats);
   });
 
+  // Assert that the promise is rejected with an AbortError.
   await assert.rejects(promise, { name: 'AbortError' });
 
   fs.unlinkSync(filePath);