我們用兩個對象來描述兩個碼農(nóng)的工資：

const salary1 = {
  baseSalary: 100_000,
  yearlyBonus: 20_000
};
 
const salary2 = {
  contractSalary: 110_000
};

然后寫一個獲取總工資的函數(shù)

function totalSalary(salaryObject: ???) {
  let total = 0;
  for (const name in salaryObject) {
    total += salaryObject[name];
  }
  return total;
}
totalSalary(salary1); // => 120_000
totalSalary(salary2); // => 110_000

如果是你的，要如何聲明totalSalary()函數(shù)的salaryObject參數(shù)，以接受具有字符串鍵和數(shù)字值的對象？

答案是使用一個索引簽名!

接著，我們來看看什么是 TypeScript 索引簽名以及何時需要它們。

1.什么是索引簽名

索引簽名的思想是在只知道鍵和值類型的情況下對結(jié)構(gòu)未知的對象進行類型劃分。

它完全符合salary參數(shù)的情況，因為函數(shù)應(yīng)該接受不同結(jié)構(gòu)的salary對象，唯一的要求是屬性值為數(shù)字。

我們用索引簽名來聲明salaryObject參數(shù)

function totalSalary(salaryObject: { [key: string]: number }) {
  let total = 0;
  for (const name in salaryObject) {
    total += salaryObject[name];
  }
  return total;
}
 
totalSalary(salary1); // => 120_000
totalSalary(salary2); // => 110_000

{[key: string]: number} 是索引簽名，它告訴TypeScript salaryObject 必須是一個以string 類型為鍵，以 number 類型為值的對象。

2. 索引簽名語法

索引簽名的語法相當簡單，看起來與屬性的語法相似，但有一點不同。我們只需在方括號內(nèi)寫上鍵的類型，而不是屬性名稱：{ [key: KeyType]: ValueType }。

下面是一些索引簽名的例子。

string 類型是鍵和值。

interface StringByString {
  [key: string]: string;
}
 
const heroesInBooks: StringByString = {
  'Gunslinger': '前端小智',
  'Jack Torrance': '王大志'
};

string 類型是鍵，值可以是 string、number或boolean

interface Options {
  [key: string]: string | number | boolean;
  timeout: number;
}
 
const options: Options = {
  timeout: 1000,
  timeoutMessage: 'The request timed out!',
  isFileUpload: false
};

簽名的鍵只能是一個 string`、number或 symbol`。其他類型是不允許的。

3. 索引簽名的注意事項

TypeScript中的索引簽名有一些注意事項，需要注意。

3.1不存在的屬性

如果試圖訪問一個索引簽名為 { [key: string]: string } 的對象的一個不存在的屬性，會發(fā)生什么？

正如預(yù)期的那樣，TypeScript 將值的類型推斷為 string。但是檢查運行時值，它是undefined:

根據(jù) TypeScript 提示, value變量是一個 string 類型，但是它的運行時值是 undefined。

索引簽名只是將一個鍵類型映射到一個值類型，僅此而已。如果沒有使這種映射正確，值類型可能會偏離實際的運行時數(shù)據(jù)類型。

為了使輸入更準確，將索引值標記為 string 或 undefined。這樣，TypeScript就會意識到你訪問的屬性可能不存在

3.2 string 和 number 鍵

假設(shè)有一個數(shù)字名稱的字典:

interface NumbersNames {
  [key: string]: string
}
 
const names: NumbersNames = {
  '1': 'one',
  '2': 'two',
  '3': 'three',
  // ...
};

不會，正常工作。

當在屬性訪問器中作為鍵使用時，JavaScript隱式地將數(shù)字強制為字符串(names[1]與names['1']相同)。TypeScript也會執(zhí)行這個強制。

你可以認為 [key: string] 與 [key: string | number] 相同。

4.索引簽名與 Record<Keys, Type>對比

TypeScript有一個實用類型 Record<Keys, Type>，類似于索引簽名。

const object1: Record<string, string> = { prop: 'Value' }; // OK
const object2: { [key: string]: string } = { prop: 'Value' }; // OK

那問題來了...什么時候使用 Record<Keys, Type>，什么時候使用索引簽名？乍一看，它們看起來很相似

我們知道，索引簽名只接受 string、number 或 symbol 作為鍵類型。如果你試圖在索引簽名中使用，例如，字符串字面類型的聯(lián)合作為鍵，這是一個錯誤。

索引簽名在鍵方面是通用的。

但是我們可以使用字符串字面值的聯(lián)合來描述 Record<keys, Type>中的鍵

type Salary = Record<'yearlySalary'|'yearlyBonus', number>
 
const salary1: Salary = { 
  'yearlySalary': 120_000,
  'yearlyBonus': 10_000
}; // OK

Record<Keys, Type> 是為了具體到鍵的問題。

建議使用索引簽名來注釋通用對象，例如，鍵是字符串類型。但是，當你事先知道鍵的時候，使用Record<Keys, Type>來注釋特定的對象，例如字符串字面量' prop1' | 'prop2'被用于鍵值。

 總結(jié)：

如果你不知道你要處理的對象結(jié)構(gòu)，但你知道可能的鍵和值類型，那么索引簽名就是你需要的。

索引簽名由方括號中的索引名稱及其類型組成，后面是冒號和值類型： { [indexName: KeyType]: ValueType }， KeyType 可以是一個 string、number 或 symbol，而ValueType 可以是任何類型。

到此這篇關(guān)于淺談TypeScript 索引簽名的理解的文章就介紹到這了,更多相關(guān)TypeScript 索引簽名內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！