pokerogue/test/test-utils/matchers/to-have-fainted.ts

import { getPokemonNameWithAffix } from "#app/messages";
import type { Pokemon } from "#field/pokemon";
import { isPokemonInstance, receivedStr } from "#test/test-utils/test-utils";
import type { MatcherState, SyncExpectationResult } from "@vitest/expect";

/**
 * Matcher that checks if a {@linkcode Pokemon} has fainted.
 * @param received - The object to check. Should be a {@linkcode Pokemon}
 * @returns Whether the matcher passed
 */
export function toHaveFainted(this: MatcherState, received: unknown): SyncExpectationResult {
  if (!isPokemonInstance(received)) {
    return {
      pass: this.isNot,
      message: () => `Expected to receive a Pokémon, but got ${receivedStr(received)}!`,
    };
  }

  const pass = received.isFainted();

  const hp = received.hp;
  const maxHp = received.getMaxHp();
  const pkmName = getPokemonNameWithAffix(received);

  return {
    pass,
    message: () =>
      pass
        ? `Expected ${pkmName} to NOT have fainted, but it did!`
        : `Expected ${pkmName} to have fainted, but it didn't! (${hp}/${maxHp} HP)`,
    expected: 0,
    actual: hp,
  };
}