request.url 未定义类型，为什么？

Question

为什么 request.url 在 nodejs 类型中被定义为可选？ 如果一个请求来到 http 服务器应该有定义的 url。

为什么这里有问号？ url?: string;

https://github.com/DefinitelyTyped/DefinitelyTyped/blob/master/types/node/http.d.ts#L288

Answer 1

我对 node 中的 http/Request 了解不多，但这似乎是不良建模的经典示例（通常在 @types/node 定义中找到，或者是由于类型如何具有已写入或用于 node.js API 本身的底层设计）。

IncomingMessage 被建模为具有可选键的产品类型，而不是作为适当的总和类型 - 以区分客户端请求和服务器生成请求的情况。然后将关于不变量的注释放在单个字段之上，使它们在 TS/静态类型检查方面毫无用处。

仅阅读该定义，更好的类型 def 可能是：

interface ClientIncomingMessage extends stream.Readable {
  // ... many other fields ...
  url: string;
}

interface ServerIncomingMessage extends stream.Readable {
  // ... many other fields ...
  // no `url` fields here!
}

type IncomingMessage = ClientIncomingMessage | ServerIncomingMessage