具有定义值的 Typescript 动态对象键

Dan*_*iel 5 typescript typescript-generics typescript-typings

我遇到了一个问题,试图让 typescript 为我识别 javascript 对象的键,同时强制每个键的值类型,因为我想创建一个 typeof 对象的键,所以我不能只创建一个常规的type MyObject = { [key: string]: <insert type> }.

想象一个对象myobject,我在其中提取它的键,例如:

const myobject = {
  foo: {},
  bar: {}
};

type MyObjectKeys = keyof typeof myobject; // 'foo' | 'bar'
Run Code Online (Sandbox Code Playgroud)

如何向键的值添加类型定义,同时仍然能够提取/继承键的定义?如果我做这样的事情,那么我将不再能够提取对象的确切键,而只能提取类型(字符串):

type MyObject = { [key: string]: { value: boolean }}
const myobject = {
  foo: { value: true },
  bar: { value: false }
};

type MyObjectKeys = keyof typeof myobject; // string
Run Code Online (Sandbox Code Playgroud)

我想我可以通过创建一个辅助函数来实现这一点,例如:

function enforceObjectType<T extends MyObject>(o: T) {
    return Object.freeze(o);
}
const myobject = enforceObjectType({
  foo: {},
  bar: {}
});
Run Code Online (Sandbox Code Playgroud)

但我更愿意为它定义一个明确的类型,而不必污染代码,只编写与类型相关的函数。有没有办法允许一组字符串作为一个类型的键而不重复?

这样做的目的是让 TypeScript 帮助指出正确的对象键,例如(实际用法有点复杂,所以我希望这能很好地描述它):

type MyObjectKeys = keyof typeof myobject; // string
function getMyObjectValue(key: MyObjectKeys) {
   const objectValue = myobject[key];
}

// suggest all available keys, while showing an error for unknown keys
getMyObjectValue('foo'); // success
getMyObjectValue('bar'); // success 
getMyObjectValue('unknown'); // failure
Run Code Online (Sandbox Code Playgroud)

总结:我想将一个对象定义为 const(实际上是Object.freeze)并且能够:

  1. 提取对象的确切键(无需键入每个键的定义)。
  2. 定义每个键的类型,而string不是覆盖键而不是它们的类型'foo' | 'bar'

完整示例

type GameObj = { skillLevel: EnumOfSkillLevels }; // ADD to each key.
const GAMES_OBJECT = Object.freeze({
   wow: { skillLevel: 'average' },
   csgo: { skillLevel 'good' }
)};

type GamesObjectKeys = keyof typeof GAMES_OBJECT;

function getSkillLevel(key: GamesObjectKeys) {
  return GAMES_OBJECT[key]
}

getSkillLevel('wow') // Get the actual wow object
getSkillLevel('unknown') // Get an error because the object does not contain this.
Run Code Online (Sandbox Code Playgroud)

根据上述,我不能执行以下操作,因为这会将已知键覆盖为任何字符串:

type GameObj = { [key: string]: skillLevel: EnumOfSkillLevels };
const GAMES_OBJECT: GameObj = Object.freeze({
   wow: { skillLevel: 'average' },
   csgo: { skillLevel 'good' }
)};

type GamesObjectKeys = keyof typeof GAMES_OBJECT;

function getSkillLevel(key: GamesObjectKeys) {
  return GAMES_OBJECT[key]
}

getSkillLevel('wow') // Does return wow object, but gives me no real-time TS help
getSkillLevel('unknown') // Does not give me a TS error
Run Code Online (Sandbox Code Playgroud)

另一个例子:如果你想更改代码,请参阅此要点并将其复制到打字稿游乐场

Dan*_*iel 5

虽然我还没有找到一种方法来完全避免创建 javascript 函数来解决这个问题(也告诉我目前这可能根本不可能),但我已经找到了我认为可以接受的解决方案:

type GameInfo = { [key: string]: { skillLevel: 'good' | 'average' | 'bad' }}

type EnforceObjectType<T> = <V extends T>(v: V) => V;
const enforceObjectType: EnforceObjectType<GameInfo> = v => v;

const GAMES2 = enforceObjectType({
  CSGO: {
    skillLevel: 'good',
  },
  WOW: {
    skillLevel: 'average'
  },
  DOTA: {
    // Compile error - missing property skillLevel
  }
});

type GameKey2 = keyof typeof GAMES2;

function getGameInfo2(key: GameKey2) {
  return GAMES2[key];
}

getGameInfo2('WOW');
getGameInfo2('CSGO');
getGameInfo2('unknown') // COMPILE ERROR HERE
Run Code Online (Sandbox Code Playgroud)

这样我们就得到:

  1. 缺少属性时出现编译错误。
  2. 自动完成缺失的属性。
  3. 能够提取对象中定义的确切键,而无需在其他地方定义这些键,例如在枚举中(复制它)。

我已经更新了我的要点以包含这个示例,您也许可以在打字稿游乐场上看到它的实践。