fs.watch(filename[, options][, listener])

• filename <string> | <Buffer> | <URL>

• options <string> | <Object>

  • persistent <boolean> 指示如果文件已正被监视，进程是否应继续运行。默认为 true。
  • recursive <boolean> 指示是监视所有子目录，还是仅监视当前目录。适用于监视目录时，仅适用于受支持的平台（参阅注意事项）。默认为 false。
  • encoding <string> 指定用于传给监听器的文件名的字符编码。默认为 'utf8'。

• listener <Function> | <undefined> 默认为 undefined。

  • eventType <string>
  • filename <string> | <Buffer>
• 返回: <fs.FSWatcher>

监视 filename 的更改，其中 filename 是文件或目录。

第二个参数是可选的。如果 options 是字符串，则它指定 encoding。 否则 options 应是对象。

监听器回调有两个参数 (eventType, filename)。 eventType 是 'rename' 或 'change'，filename 是触发事件的文件的名称。

在大多数平台上，只要文件名出现或在目录中消失，就会触发 'rename' 事件。

监听器回调绑定在由 fs.FSWatcher 触发的 'change' 事件上，但它与 eventType 的 'change' 值不是一回事。

• filename <string> | <Buffer> | <URL>

• options <string> | <Object>

  • persistent <boolean> Indicates whether the process should continue to run as long as files are being watched. Default: true.
  • recursive <boolean> Indicates whether all subdirectories should be watched, or only the current directory. This applies when a directory is specified, and only on supported platforms (See Caveats). Default: false.
  • encoding <string> Specifies the character encoding to be used for the filename passed to the listener. Default: 'utf8'.

• listener <Function> | <undefined> Default: undefined

  • eventType <string>
  • filename <string> | <Buffer>
• Returns: <fs.FSWatcher>

Watch for changes on filename, where filename is either a file or a directory.

The second argument is optional. If options is provided as a string, it specifies the encoding. Otherwise options should be passed as an object.

The listener callback gets two arguments (eventType, filename). eventType is either 'rename' or 'change', and filename is the name of the file which triggered the event.

On most platforms, 'rename' is emitted whenever a filename appears or disappears in the directory.

The listener callback is attached to the 'change' event fired by fs.FSWatcher, but it is not the same thing as the 'change' value of eventType.