ERR_FEATURE_UNAVAILABLE_ON_PLATFORM('watch recursively')

[denik1981]

I'm trying to run the provided core demo with "npm run core" but seems I cannot do it because of an unsupport file feature (watch recursively) in my linux version.

uname -a = LinuxOS 5.11.0-25-generic #27~20.04.1-Ubuntu SMP

There is an open discussion about this in the cloud so I know I'm not the only one facing this issue.
Anyone else having troubles to start the demo server inside a Linux?

I found unneccesary to provided an example of this.
All that I did was to run npm install and then npm run core

[0] 
[0]   vite v2.4.4 dev server running at:
[0] 
[0]   > Local: http://localhost:3000/
[0]   > Network: use `--host` to expose
[0] 
[0]   ready in 186ms.
[0] 
[1] 
[1] > [email protected] watch:dev
[1] > node scripts/watch
[1] 
[1] Watching file changes ...
[1] node:fs:2235
[1]     throw new ERR_FEATURE_UNAVAILABLE_ON_PLATFORM('watch recursively');
[1]     ^
[1] 
[1] TypeError [ERR_FEATURE_UNAVAILABLE_ON_PLATFORM]: The feature watch recursively is unavailable on the current platform, which is being used to run Node.js
[1]     at new NodeError (node:internal/errors:371:5)
[1]     at Object.watch (node:fs:2235:11)
[1]     at Object.<anonymous> (/home/demian/Documents/CODE/INSPECT/nolimits4web@swiper/scripts/watch.js:54:4)
[1]     at Module._compile (node:internal/modules/cjs/loader:1101:14)
[1]     at Object.Module._extensions..js (node:internal/modules/cjs/loader:1153:10)
[1]     at Module.load (node:internal/modules/cjs/loader:981:32)
[1]     at Function.Module._load (node:internal/modules/cjs/loader:822:12)
[1]     at Function.executeUserEntryPoint [as runMain] (node:internal/modules/run_main:79:12)
[1]     at node:internal/main/run_main_module:17:47 {
[1]   code: 'ERR_FEATURE_UNAVAILABLE_ON_PLATFORM'
[1] }
[1] npm run watch:dev exited with code 1
--> Sending SIGTERM to other processes..
[0] vite ./playground/core exited with code SIGTERM

[linuxonrails]

I have the same problem, with node 16.13:

(I used Volta to force different nodejs versions in a project)

$ volta pin [email protected]
success: pinned [email protected] (with [email protected]) in package.json
$ node -v 
v16.13.2
$ npm run demos

> [email protected] demos
> npm run build:core && npm run build:bundle && concurrently --kill-others "vite ./demos/" "npm run watch"


> [email protected] build:core
> node scripts/build --only core

Successfully compiled 107 files with Babel (884ms).
Core build completed! 1.26 seconds 
Build completed 1.27 seconds 

> [email protected] build:bundle
> node scripts/build --only bundle styles

Styles build completed! 1ms

Bundle build completed! 1.92 seconds 
Build completed 1.92 seconds 
[0] 
[0]   vite v2.9.12 dev server running at:
[0] 
[0]   > Local: http://localhost:3000/
[0]   > Network: use `--host` to expose
[0] 
[0]   ready in 134ms.
[0] 
[1] 
[1] > [email protected] watch
[1] > node scripts/watch
[1] 
[1] Watching file changes ...
[1] node:fs:2245
[1]     throw new ERR_FEATURE_UNAVAILABLE_ON_PLATFORM('watch recursively');
[1]     ^
[1] 
[1] TypeError [ERR_FEATURE_UNAVAILABLE_ON_PLATFORM]: The feature watch recursively is unavailable on the current platform, which is being used to run Node.js
[1]     at new NodeError (node:internal/errors:371:5)
[1]     at Object.watch (node:fs:2245:11)
[1]     at Object.<anonymous> (/home/davidm/src/linuxonrails/swiper/scripts/watch.js:58:4)
[1]     at Module._compile (node:internal/modules/cjs/loader:1101:14)
[1]     at Object.Module._extensions..js (node:internal/modules/cjs/loader:1153:10)
[1]     at Module.load (node:internal/modules/cjs/loader:981:32)
[1]     at Function.Module._load (node:internal/modules/cjs/loader:822:12)
[1]     at Function.executeUserEntryPoint [as runMain] (node:internal/modules/run_main:81:12)
[1]     at node:internal/main/run_main_module:17:47 {
[1]   code: 'ERR_FEATURE_UNAVAILABLE_ON_PLATFORM'
[1] }
[1] npm run watch exited with code 1
--> Sending SIGTERM to other processes..
[0] vite ./demos/ exited with code SIGTERM

The problem appears with node v14 and disappear with last node v13:

$ volta pin node@13
success: pinned [email protected] (with [email protected]) in package.json
$ npm run demos

> [email protected] demos /home/davidm/src/linuxonrails/swiper
> npm run build:core && npm run build:bundle && concurrently --kill-others "vite ./demos/" "npm run watch" 


> [email protected] build:core /home/davidm/src/linuxonrails/swiper
> node scripts/build --only core

Successfully compiled 107 files with Babel (943ms).
Core build completed! 1.08 seconds 
Build completed 1.08 seconds 

> [email protected] build:bundle /home/davidm/src/linuxonrails/swiper
> node scripts/build --only bundle styles

Styles build completed! 1ms

Bundle build completed! 1.99 seconds 
Build completed 2 seconds 
[0] 
[0]   vite v2.9.12 dev server running at:
[0] 
[0]   > Local: http://localhost:3000/
[0]   > Network: use `--host` to expose
[0] 
[0]   ready in 139ms.
[0] 
[1] 
[1] > [email protected] watch /home/davidm/src/linuxonrails/swiper
[1] > node scripts/watch
[1] 
[1] Watching file changes ...

[linuxonrails]

Node v14 introduced a breaking change to the fs.watch() API, specifically that the recursive option (which has never been supported on Linux) now raises the ERR_FEATURE_UNAVAILABLE_ON_PLATFORM error if used on Linux.

A bug report and fix have been submitted to filewatcher: fgnass/filewatcher#6

https://stackoverflow.com/a/61829462/455216