Changeset 79a0317 for imaps-frontend/node_modules/chokidar/README.md

Timestamp:

01/21/25 03:08:24 (2 weeks ago)

Author:

stefan toskovski <stefantoska84@…>

Branches:

main

Parents:

0c6b92a

Message:

F4 Finalna Verzija

File:

• imaps-frontend/node_modules/chokidar/README.md (modified) (4 diffs)

imaps-frontend/node_modules/chokidar/README.md

@@ -113 +113 @@
 
   awaitWriteFinish: true, // emit single event when chunked writes are completed
-  atomic: true // emit proper events when "atomic writes" (mv _tmp file) are used
+  atomic: true, // emit proper events when "atomic writes" (mv _tmp file) are used
 
   // The options also allow specifying custom intervals in ms
@@ -121 +121 @@
   // },
   // atomic: 100,
+
   interval: 100,
   binaryInterval: 300,
@@ -236 +237 @@
 values are arrays of the names of the items contained in each directory.
 
-## CLI
-
-If you need a CLI interface for your file watching, check out
-third party [chokidar-cli](https://github.com/open-cli-tools/chokidar-cli), allowing you to
-execute a command on each change, or get a stdio stream of change events.
+### CLI
+
+Check out third party [chokidar-cli](https://github.com/open-cli-tools/chokidar-cli),
+which allows to execute a command on each change, or get a stdio stream of change events.
 
 ## Troubleshooting
 
-* On Linux, sometimes there's `ENOSP` error:
-    * `bash: cannot set terminal process group (-1): Inappropriate ioctl for device bash: no job control in this shell`
-  `Error: watch /home/ ENOSPC`
-    * This means Chokidar ran out of file handles and you'll need to increase their count by executing the following command in Terminal:
-  `echo fs.inotify.max_user_watches=524288 | sudo tee -a /etc/sysctl.conf && sudo sysctl -p`
-* If using 3.x, upgrade to latest chokidar to prevent fsevents-related issues:
-    * `npm WARN optional dep failed, continuing fsevents@n.n.n`
-    * `TypeError: fsevents is not a constructor`
+Sometimes, Chokidar runs out of file handles, causing `EMFILE` and `ENOSP` errors:
+
+* `bash: cannot set terminal process group (-1): Inappropriate ioctl for device bash: no job control in this shell`
+* `Error: watch /home/ ENOSPC`
+
+There are two things that can cause it.
+
+1. Exhausted file handles for generic fs operations
+    - Can be solved by using [graceful-fs](https://www.npmjs.com/package/graceful-fs),
+      which can monkey-patch native `fs` module used by chokidar: `let fs = require('fs'); let grfs = require('graceful-fs'); grfs.gracefulify(fs);`
+    - Can also be solved by tuning OS: `echo fs.inotify.max_user_watches=524288 | sudo tee -a /etc/sysctl.conf && sudo sysctl -p`.
+2. Exhausted file handles for `fs.watch`
+    - Can't seem to be solved by graceful-fs or OS tuning
+    - It's possible to start using `usePolling: true`, which will switch backend to resource-intensive `fs.watchFile`
+
+All fsevents-related issues (`WARN optional dep failed`, `fsevents is not a constructor`) are solved by upgrading to v4+.
 
 ## Changelog
@@ -278 +286 @@
 // other way
 import { glob } from 'node:fs/promises';
-const watcher = watch(await glob('**/*.js'));
+const watcher = watch(await Array.fromAsync(glob('**/*.js')));
 
 // unwatching