一个小脚本，用来在开发时执行typescript代码

需要 Node.js >= 18.19.0

使用

let exports;
try {
	// 首先尝试加载编译好的代码
	exports = await import('../dist/index.js');
} catch (e) {
	if (e.code === 'ERR_MODULE_NOT_FOUND') {
		// 如果没有，则使用esbuild编译
		const { importFile } = await import('@idlebox/esbuild-executer')
		const tsFile = import.meta.resolve("../src/index.ts");
		exports = await importFile(tsFile);
	}
	throw e;
}

export const x = exports.x;

当然也可以无条件使用esbuild

import { importFile } from '@idlebox/esbuild-executer'
const tsFile = import.meta.resolve("../src/index.ts");
const exports = await importFile(tsFile)

export const x = exports.x;

原理

1. 注册加载器 (Customization Hooks)
2. 使用esbuild将ts文件编译成js
3. 产生临时（虚拟）路径并import()

和其他加载器（如ts-node、swc）的区别

这个脚本在运行esbuild时使用了“bundle=true”，也就是把所有文件一次性打包成一个文件，但不打包node_modules里的任何内容。也不会打包本地软连接的开发包（例如monorepo）。

其他加载器普遍是按需加载的，只有在import语句确实运行的时候才会加载对应的文件。此加载器调用时立刻运行编译，不会等待import语句。

其他说明

输入的文件必须是绝对路径，且是fileUrl，而不是路径字符串。例如使用 import.meta.resolve('./path/to/file.ts') 来获取。

设置环境变量 WRITE_COMPILE_RESULT=true 可以将编译结果写入到文件中，可以检查文件是否正常。（不会运行该文件）
存在调试器时也会写入编译结果，并且实际运行的也是编译结果文件，而不是从内存运行。

已使用 source-map-support 来支持源映射。
设置环境变量 DISABLE_SOURCE_MAP=true，或者存在调试器时将会禁用源映射。

设置 DEBUG=executer* 查看详细调试日志

API

• importFile
• execute - 和 importFile 完全一样，只是会把 process.argv[1] 设置为被执行文件的路径
• dispose - 提前释放资源，默认1s不使用会自动释放