doc, test: add throwIfNoEntry docs and test

Author: efekrskl

doc/api/fs.md

@@ -4786,6 +4786,9 @@ The `atime` and `mtime` arguments follow these rules:
 <!-- YAML
 added: v0.5.10
 changes:
+  - version: REPLACEME
+    pr-url: https://github.com/nodejs/node/pull/61870
+    description: Added `throwIfNoEntry` option.
   - version: v19.1.0
     pr-url: https://github.com/nodejs/node/pull/45098
     description: Added recursive support for Linux, AIX and IBMi.
@@ -4814,6 +4817,8 @@ changes:
   * `encoding` {string} Specifies the character encoding to be used for the
     filename passed to the listener. **Default:** `'utf8'`.
   * `signal` {AbortSignal} allows closing the watcher with an AbortSignal.
+  * `throwIfNoEntry` {boolean} Indicates whether an exception should be thrown when the
+    path does not exist. **Default:** `true`.
   * `ignore` {string|RegExp|Function|Array} Pattern(s) to ignore. Strings are
     glob patterns (using [`minimatch`][]), RegExp patterns are tested against
     the filename, and functions receive the filename and return `true` to

test/parallel/test-fs-watch-enoent.js

@@ -43,6 +43,29 @@ tmpdir.refresh();
   );
 }
 
+{
+  assert.throws(
+    () => fs.watch(nonexistentFile, { throwIfNoEntry: true }, common.mustNotCall()),
+    (err) => {
+      assert.strictEqual(err.path, nonexistentFile);
+      assert.strictEqual(err.filename, nonexistentFile);
+      return err.code === 'ENOENT' || err.code === 'ENODEV';
+    },
+  );
+}
+
+{
+  if (common.isAIX) {
+    assert.throws(
+      () => fs.watch(nonexistentFile, { throwIfNoEntry: false }, common.mustNotCall()),
+      (err) => err.code === 'ENODEV',
+    );
+  } else {
+    const watcher = fs.watch(nonexistentFile, { throwIfNoEntry: false }, common.mustNotCall());
+    watcher.close();
+  }
+}
+
 {
   if (common.isMacOS || common.isWindows) {
     const file = tmpdir.resolve('file-to-watch');