diff --git a/doc/api/fs.md b/doc/api/fs.md index 74c73e972086f6..552195f65d44be 100644 --- a/doc/api/fs.md +++ b/doc/api/fs.md @@ -3815,10 +3815,10 @@ to be notified of filesystem changes. * On Aix systems, this feature depends on [`AHAFS`][], which must be enabled. If the underlying functionality is not available for some reason, then -`fs.watch` will not be able to function. For example, watching files or -directories can be unreliable, and in some cases impossible, on network file -systems (NFS, SMB, etc), or host file systems when using virtualization software -such as Vagrant, Docker, etc. +`fs.watch` will not be able to function (may an exception will be thrown). +For example, watching files or directories can be unreliable, and in some +cases impossible, on network file systems (NFS, SMB, etc), or host file systems +when using virtualization software such as Vagrant, Docker, etc. It is still possible to use `fs.watchFile()`, which uses stat polling, but this method is slower and less reliable.