CommonJS环境下TypeScript调用ES6模块parse-domain的非异步方案

问题根源 #

你遇到的问题本质是：parse-domain@7.0.1是纯ESM格式的包，但你的TypeScript项目编译配置为输出CommonJS，直接用import会被TS转译为require语句，而Node.js的require无法加载ESM包；你之前写的包装函数里，异步导入的箭头函数仅定义未执行，就算执行了，异步操作还没完成就执行return，导致pd始终为null。

可行解决方案 #

要实现非异步函数调用parseDomain，核心思路是提前异步加载模块并缓存，后续同步调用直接使用缓存的模块实例（需确保模块已完成加载）。

方案1：初始化预加载+同步调用 #

在项目启动阶段先异步加载parse-domain并缓存，之后即可直接同步调用：

// 缓存加载后的模块实例
let parseDomainModule: typeof import('parse-domain');

// 初始化函数，项目启动时调用一次即可
export async function initParseDomain() {
  parseDomainModule = await import('parse-domain');
}

// 同步调用的函数
export function parseDomainSync(url: string) {
  if (!parseDomainModule) {
    throw new Error('请先调用 initParseDomain 完成模块初始化');
  }
  return parseDomainModule.parseDomain(url);
}

// 项目入口示例
(async () => {
  // 先等待模块加载完成
  await initParseDomain();
  
  // 之后可随意同步调用
  console.log(parseDomainSync("http://any.company.com"));
})();

方案2：切换项目为ESM输出 #

如果项目可以切换为输出ESM格式，修改配置后就能直接同步导入使用：

1. 修改tsconfig.json的编译选项：

{
  "compilerOptions": {
    "module": "ESNext",
    "moduleResolution": "nodenext",
    // 其他配置保持不变
  }
}

2. 在package.json中添加ESM标识：

{
  "type": "module",
  // 其他依赖、配置保持不变
}

3. 直接同步导入使用：

import { parseDomain } from 'parse-domain';

export function parseDomainSync(url: string) {
  return parseDomain(url);
}

console.log(parseDomainSync("http://any.company.com"));

原代码失效原因 #

你原代码中的async () => pd = await import('parse-domain')仅定义了异步函数但未执行；就算执行该函数，异步加载需要时间，return pd.parseDomain(url)会立即执行，此时pd仍为null，必然报错。

内容的提问来源于stack exchange，提问作者Zoltan Hernyak