From d7f81cb8cff9c49129ad0407e2f2f792dac0d77e Mon Sep 17 00:00:00 2001 From: ayj8201 Date: Tue, 3 Feb 2026 21:53:18 +0900 Subject: [PATCH] doc: clarify fs.copyFile() symlink behavior --- doc/api/fs.md | 3 +++ 1 file changed, 3 insertions(+) diff --git a/doc/api/fs.md b/doc/api/fs.md index 6ea9fa9fdde0f2..f994147101fb4f 100644 --- 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. +