diff --git a/doc/api/fs.md b/doc/api/fs.md index 3b3c6efd58243f..581af574038d7c 100644 --- a/doc/api/fs.md +++ b/doc/api/fs.md @@ -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.