Watches a directory and its contents. If the globPattern is null, it will not attempt to add child items but also will not filter it, meaning you will be left with platform-specific behavior.
On Windows, the globPattern is just used to filter events.
On Linux, the recursive flag, if set, will cause it to add additional OS-level watches for each subdirectory.
On BSD, anything other than a null pattern will cause a directory scan to add files to the watch list.
For best results, use the most limited thing you need, as watches can get quite involved on the bsd systems.
Newly added files and subdirectories may not be automatically added in all cases, meaning if it is added and then subsequently modified, you might miss a notification.
If the event queue is too busy, the OS may skip a notification.
You should always offer some way for the user to force a refresh and not rely on notifications being present; they are a convenience when they work, not an always reliable method.
Watches a directory and its contents. If the globPattern is null, it will not attempt to add child items but also will not filter it, meaning you will be left with platform-specific behavior.
On Windows, the globPattern is just used to filter events.
On Linux, the recursive flag, if set, will cause it to add additional OS-level watches for each subdirectory.
On BSD, anything other than a null pattern will cause a directory scan to add files to the watch list.
For best results, use the most limited thing you need, as watches can get quite involved on the bsd systems.
Newly added files and subdirectories may not be automatically added in all cases, meaning if it is added and then subsequently modified, you might miss a notification.
If the event queue is too busy, the OS may skip a notification.
You should always offer some way for the user to force a refresh and not rely on notifications being present; they are a convenience when they work, not an always reliable method.