Инвентарь

Теперь рюкзак Киры. В нём три вида предметов: зелья, которые лечат, оружие, которое наносит урон, и ключи, которые что-то открывают. У каждого вида свои данные, поэтому для инвентаря подходит размеченное объединение (discriminated union) из урока «Моделирование данных». Каждый вид — отдельный объектный тип с тегом kind, а Item — объединение этих типов. Дайте каждому виду своё имя: Potion, Weapon и Key. На следующем шаге тип Weapon понадобится отдельно.

Чтобы описать предмет, используйте switch по тегу. В каждом case TypeScript знает, какой это вид предмета, поэтому в case "potion" можно использовать item.heal. А в default идёт проверка полноты с never из урока «Моделирование данных»: если когда-нибудь добавят новый вид, а его case забудут, TypeScript сообщит об этом прямо здесь. Например, заклинания:

type FireSpell = { kind: "fire"; name: string; damage: number };
type IceSpell = { kind: "ice"; name: string; turns: number };
type Spell = FireSpell | IceSpell;

function describeSpell(spell: Spell): string {
    switch (spell.kind) {
        case "fire":
            return `${spell.name}: урон ${spell.damage}`;
        case "ice":
            return `${spell.name}: заморозка, ходов: ${spell.turns}`;
        default:
            const unhandled: never = spell;
            return unhandled;
    }
}

const spells: Spell[] = [
    { kind: "fire", name: "Огненный шар", damage: 30 },
    { kind: "ice", name: "Ледяная вспышка", turns: 2 },
];
for (const spell of spells) {
    console.log(`- ${describeSpell(spell)}`);
}

Это выведет:

- Огненный шар: урон 30
- Ледяная вспышка: заморозка, ходов: 2

Предметы Киры попадают в новое свойство Hero — inventory: Item[]. В kira это массив объектов, и TypeScript проверяет каждый по его виду: зелье со свойством damage вместо heal было бы ошибкой. Затем основная программа выводит заголовок Инвентарь: и проходит по предметам циклом for...of.

Типичные ошибки:

• Заглавная буква в case, case "Potion":. Тег — это в точности текст "potion", поэтому TypeScript сообщает Type '"Potion"' is not comparable to type '"key" | "potion" | "weapon"'., а из-за неё появится ещё несколько ошибок ниже.
• Забытый case. Без case "key" ключ попадает в default, и проверка с never называет его: main.ts(36,19): error TS2322: Type 'Key' is not assignable to type 'never'.