node-homedir/src/index.ts

Get the effective user's homedir.

import os from 'node:os';

export function homedir(): string {
  if (process.env.MOCK_HOME_DIR) return process.env.MOCK_HOME_DIR;

  if (typeof os.userInfo === 'function') {
    try {
      const homedir = os.userInfo().homedir;
      if (homedir) return homedir;
    } catch (err: any) {
      if (err.code !== 'ENOENT') throw err;
    }
  }

  if (typeof os.homedir === 'function') {
    return os.homedir();
  }

  return process.env.HOME!;
}

export default homedir;