TypeScript/Node.js中global的工作机制、差异及相关代码疑问

一、setup.ts中global.signin的用途与原理 #

1. 为何setup.ts不在__test__目录下？ #

Jest支持通过setupFilesAfterEnv配置指定全局测试前置文件，这类文件会在所有测试套件执行前运行一次。把数据库初始化、全局测试工具函数放在setup.ts里，能避免在每个.test.ts文件中重复编写相同的初始化逻辑，实现测试代码的复用。

2. global.signin的作用与工作流程 #

这个全局函数是测试专用的身份认证辅助工具，具体流程如下：

• 调用项目的用户注册接口/api/users/signup，创建一个测试用户
• 从响应头中提取Set-Cookie字段（包含JWT令牌）
• 返回该cookie数组，供后续需要认证的测试请求使用（比如在supertest请求中通过set('Cookie', cookie)设置身份凭证）

3. declare global的作用 #

TypeScript默认不会识别你手动添加到global对象上的新函数，所以用declare global块扩展全局类型定义，告诉TypeScript：global对象上存在一个返回Promise<string[]>的signin方法，这样在测试文件中调用global.signin()时不会出现类型错误。

二、Express Request扩展的global声明与前者的区别 #

你看到的这段代码：

declare global {
  namespace Express {
    interface Request {
      currentUser?: UserPayload;
    }
  }
}

和之前的global.signin本质不同：

• 作用对象不同：前者是给Node.js的global全局对象添加函数；后者是扩展Express库的Request接口，让所有导入Express的文件都能识别Request对象上新增的currentUser属性。
• 作用场景不同：global.signin是测试阶段的工具函数；而这个扩展是在业务代码中使用——比如在中间件里解析JWT后，把用户信息挂载到req.currentUser上，业务路由就能直接访问这个属性，TypeScript也能正确识别它的类型。

三、TypeScript/Node.js中global的工作机制 #

1. Node.js中的global对象：类似浏览器中的window，是全局作用域的顶层对象，所有全局变量、函数都会挂载到这里。在Node.js中直接给global赋值（比如global.signin = ...），就能在任何模块中访问，无需导入。
2. TypeScript的全局类型扩展：TypeScript对类型检查严格，默认不会识别global上新增的属性/方法，必须通过declare global块来扩展全局类型定义，否则会报“属性不存在”的类型错误。
3. 全局扩展的生效范围：只要包含declare global的文件被TypeScript编译（比如在tsconfig.json的include范围内），扩展的类型就会全局生效，不需要在每个文件中重复声明。

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