doc: clarify fs.copyFile() symlink behavior

junnyontop-pixel · junnyontop-pixel · commit 43c94a94d4a3 · 2026-02-11T02:33:22.000Z
diff --git a/doc/api/fs.md b/doc/api/fs.md
@@ -2441,6 +2441,9 @@ See the POSIX close(2) documentation for more detail.
 
 ### `fs.copyFile(src, dest[, mode], callback)`
 
+Note: `fs.copyFile()` always dereferences symbolic links. 
+If `src` is a symbolic link, the contents of the target file will be copied rather than the link itself.
+
 <!-- YAML
 added: v8.5.0
 changes:
