Deno编译环境下处理不同JavaScript运行时检测的解决方案

在Deno项目中，开发者经常需要编写跨运行时的代码，以检测当前代码是在Deno、Bun、Node.js还是浏览器环境中执行。然而，当使用deno compile命令编译TypeScript代码时，会遇到类型检查错误的问题。

问题背景

在JavaScript/TypeScript中，检测运行环境的常见做法是通过检查全局对象上的特定属性：

if (globalThis.Deno) {
    console.log("Runtime: Deno")
} else if (globalThis.Bun) {
    console.log("Runtime: Bun")
} else if (globalThis.process?.versions?.node) {
    console.log("Runtime: Node")
} else {
    console.log("Runtime: Browser")
}

这段代码在直接运行时（如deno main.ts、bun main.ts或node main.ts）都能正常工作，但在使用deno compile编译时会报类型错误。

类型系统问题分析

Deno的严格类型检查会报以下错误：

1. globalThis.Bun：因为typeof globalThis类型没有索引签名
2. globalThis.process：同样因为缺少索引签名

这是由于TypeScript的严格类型检查机制导致的，Deno默认启用了严格的类型检查。

解决方案

方案一：类型声明扩展

可以通过扩展全局类型声明来解决类型问题：

import type BunType from 'npm:@types/bun'
import process from "node:process";

declare global {
  var Bun: BunType
}

if (globalThis.Deno) {
  console.log("Runtime: Deno")
} else if (globalThis.Bun) {
  console.log("Runtime: Bun")
} else if (process.versions.node) {
  console.log("Runtime: Node")
} else {
  console.log("Runtime: Browser")
}

这种方法通过显式声明全局变量类型，使TypeScript类型检查器能够识别这些属性。

方案二：禁用类型检查

作为临时解决方案，可以使用--no-check标志跳过类型检查：

deno compile --no-check main.ts

这与Bun的bun build --compile行为一致，因为Bun本身不执行内置的类型检查。

最佳实践建议

1. 优先使用类型声明扩展：这是更规范的TypeScript解决方案，保持了类型安全性
2. 谨慎使用--no-check：虽然能快速解决问题，但会失去类型检查的保护
3. 考虑运行时特性检测：除了检查全局变量，还可以测试特定API的存在性
4. 统一环境检测逻辑：可以将环境检测封装成单独模块，便于维护和测试

总结

在Deno编译环境下处理跨运行时检测时，开发者需要注意TypeScript的严格类型检查机制。通过合理的类型声明扩展或选择性禁用类型检查，可以解决编译时的类型错误问题。建议根据项目需求选择最适合的方案，在开发效率和类型安全之间取得平衡。