TypeScript转换AWS返回对象为自定义类型：新增属性的影响疑问

场景与代码示例 #

我在应用中从AWS获取结果对象，为了让TypeScript通过类型检查并支持自动补全，需要将其转换为自定义类型。代码如下：

var results = await getFromAWS(getItem); // 或已有对象类型
var cdnObject = getCDNObject(results);

对应的类型与方法定义：

export type CDNObject = {
   url: string;
}
export function getCDNObject(value = null): CDNObject {
   if (value) return value;
   return {
      url: ""
   }
}

疑问与解答 #

核心疑问 #

如果AWS修改返回的结果对象，新增了CDNObject类型中未定义的属性，会发生什么？我的理解是这只是为了满足编译器要求，实际带更多属性的对象仍会保留所有属性，是否正确？

答案 #

你的理解完全正确。

TypeScript是编译时类型系统，所有类型信息在编译为JavaScript后都会被擦除。当你把AWS返回的对象通过getCDNObject返回并标注为CDNObject类型时，只是告诉TypeScript编译器：“把这个对象当成CDNObject来处理”，但运行时这个对象的所有属性（包括AWS新增的那些）都会完整保留，不会被删除或修改。

举个例子：如果AWS返回的对象是{ url: "xxx", newProp: "yyy" }，经过getCDNObject返回后，cdnObject在TypeScript中只会提示url属性，但运行时你依然可以通过cdnObject.newProp获取到新增的属性值。

补充说明 #

• 无参调用getCDNObject时，会返回符合CDNObject类型的空结构对象：

var cdnObject = getCDNObject(); // 返回 { url: "" }

这么做确实能满足类型检查和自动补全的需求。

• TypeScript的type定义只是类型描述，不能用new关键字实例化：

var cdnObject = new CDNObject(); // 会抛出错误

• 当前getCDNObject存在潜在风险：如果AWS返回的对象缺少url属性，直接返回value会导致运行时出现属性缺失的错误——因为TypeScript的类型检查只在编译时生效，运行时不会验证对象是否真的符合类型定义。建议在函数内添加属性校验，比如：

export function getCDNObject(value = null): CDNObject {
   if (value && typeof value.url === 'string') return value;
   return {
      url: ""
   }
}

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