BLUE

Edit File Size: 3.77 KB

/var/www/uibuilder.cmshelp.dk/httpdocs/node_modules/metro-file-map/src/watchers/NativeWatcher.js.flow

Text Base64

/**
 * Copyright (c) Meta Platforms, Inc. and affiliates.
 *
 * This source code is licensed under the MIT license found in the
 * LICENSE file in the root directory of this source tree.
 *
 * @format
 * @flow strict-local
 */

import type {FSWatcher} from 'fs';

import {AbstractWatcher} from './AbstractWatcher';
import {includedByGlob, typeFromStat} from './common';
import {promises as fsPromises, watch} from 'fs';
import {platform} from 'os';
import * as path from 'path';

const debug = require('debug')('Metro:NativeWatcher');

const TOUCH_EVENT = 'touch';
const DELETE_EVENT = 'delete';

/**
 * NativeWatcher uses Node's native fs.watch API with recursive: true.
 *
 * Supported on macOS (and potentially Windows), because both natively have a
 * concept of recurisve watching, via FSEvents and ReadDirectoryChangesW
 * respectively. Notably Linux lacks this capability at the OS level.
 *
 * Node.js has at times supported the `recursive` option to fs.watch on Linux
 * by walking the directory tree and creating a watcher on each directory, but
 * this fits poorly with the synchronous `watch` API - either it must block for
 * arbitrarily large IO, or it may drop changes after `watch` returns. See:
 * https://github.com/nodejs/node/issues/48437
 *
 * Therefore, we retain a fallback to our own application-level recursive
 * FallbackWatcher for Linux, which has async `startWatching`.
 *
 * On Windows, this watcher could be used in principle, but needs work around
 * some Windows-specific edge cases handled in FallbackWatcher, like
 * deduping file change events, ignoring directory changes, and handling EPERM.
 */
export default class NativeWatcher extends AbstractWatcher {
  #fsWatcher: ?FSWatcher;

static isSupported(): boolean {
    return platform() === 'darwin';
  }

constructor(
    dir: string,
    opts: $ReadOnly<{
      ignored: ?RegExp,
      globs: $ReadOnlyArray<string>,
      dot: boolean,
      ...
    }>,
  ) {
    if (!NativeWatcher.isSupported) {
      throw new Error('This watcher can only be used on macOS');
    }
    super(dir, opts);
  }

async startWatching(): Promise<void> {
    this.#fsWatcher = watch(
      this.root,
      {
        // Don't hold the process open if we forget to close()
        persistent: false,
        // FSEvents or ReadDirectoryChangesW should mean this is cheap and
        // ~instant on macOS or Windows.
        recursive: true,
      },
      (_event, relativePath) => {
        // _event is always 'rename' on macOS, so we don't use it.
        this._handleEvent(relativePath).catch(error => {
          this.emitError(error);
        });
      },
    );

debug('Watching %s', this.root);
  }

/**
   * End watching.
   */
  async stopWatching(): Promise<void> {
    await super.stopWatching();
    if (this.#fsWatcher) {
      this.#fsWatcher.close();
    }
  }

async _handleEvent(relativePath: string) {
    const absolutePath = path.resolve(this.root, relativePath);
    if (this.doIgnore(relativePath)) {
      debug('Ignoring event on %s (root: %s)', relativePath, this.root);
      return;
    }
    debug('Handling event on %s (root: %s)', relativePath, this.root);

try {
      const stat = await fsPromises.lstat(absolutePath);
      const type = typeFromStat(stat);

// Ignore files of an unrecognized type
      if (!type) {
        return;
      }

if (!includedByGlob(type, this.globs, this.dot, relativePath)) {
        return;
      }

this.emitFileEvent({
        event: TOUCH_EVENT,
        relativePath,
        metadata: {
          type,
          modifiedTime: stat.mtime.getTime(),
          size: stat.size,
        },
      });
    } catch (error) {
      if (error?.code !== 'ENOENT') {
        this.emitError(error);
        return;
      }

this.emitFileEvent({event: DELETE_EVENT, relativePath});
    }
  }
}

Exit & Reset Text mode: syntax highlighting auto-detects file type.

Name	Size	Perms	Modified	Actions
AbstractWatcher.js	2.17 KB	lrw-r--r--	2025-03-28 11:04:32	Edit Download recursive recursive
AbstractWatcher.js.flow	2.04 KB	lrw-r--r--	2025-03-28 11:04:32	Edit Download recursive recursive
common.js	1.11 KB	lrw-r--r--	2025-03-28 11:04:32	Edit Download recursive recursive
common.js.flow	2.38 KB	lrw-r--r--	2025-03-28 11:04:32	Edit Download recursive recursive
FallbackWatcher.js	8.43 KB	lrw-r--r--	2025-03-28 11:04:32	Edit Download recursive recursive
FallbackWatcher.js.flow	11.65 KB	lrw-r--r--	2025-03-28 11:04:32	Edit Download recursive recursive
NativeWatcher.js	3.02 KB	lrw-r--r--	2025-03-28 11:04:32	Edit Download recursive recursive
NativeWatcher.js.flow	3.77 KB	lrw-r--r--	2025-03-28 11:04:32	Edit Download recursive recursive
RecrawlWarning.js	1.16 KB	lrw-r--r--	2025-03-28 11:04:32	Edit Download recursive recursive
RecrawlWarning.js.flow	1.73 KB	lrw-r--r--	2025-03-28 11:04:32	Edit Download recursive recursive
WatchmanWatcher.js	8.73 KB	lrw-r--r--	2025-03-28 11:04:32	Edit Download recursive recursive
WatchmanWatcher.js.flow	9.21 KB	lrw-r--r--	2025-03-28 11:04:32	Edit Download recursive recursive

Directory Contents