nodejs
diff --git a/Collapse file
‎doc/api/fs.md‎
Copy file name to clipboardExpand all lines: doc/api/fs.md
+7-2Lines changed: 7 additions & 2 deletions
Display the source diff
Display the rich diff b/Collapse file
‎doc/api/fs.md‎
Copy file name to clipboardExpand all lines: doc/api/fs.md
+7-2Lines changed: 7 additions & 2 deletions
Display the source diff
Display the rich diff
@@ -3733,9 +3733,14 @@ added: v10.0.0
 
 A `FileHandle` object is a wrapper for a numeric file descriptor.
 Instances of `FileHandle` are distinct from numeric file descriptors
-in that, if the `FileHandle` is not explicitly closed using the
-`filehandle.close()` method, they will automatically close the file descriptor
+in that they provide an object oriented API for working with files.
+
+If a `FileHandle` is not closed using the
+`filehandle.close()` method, it might automatically close the file descriptor
 and will emit a process warning, thereby helping to prevent memory leaks.
+Please do not rely on this behavior in your code because it is unreliable and
+your file may not be closed. Instead, always explicitly close `FileHandle`s.
+Node.js may change this behavior in the future.
 
 Instances of the `FileHandle` object are created internally by the
 `fsPromises.open()` method.