Function selectActorCombatant

selectActorCombatant<T extends CombatantTokenRef>(
combatants: readonly T[],
tokenIds: ReadonlySet<string>,
): T | null
The first combatant whose token is one of an actor's tokens.

Scans combatants in order and returns the first whose tokenId is in tokenIds, or null when none match. Combatants with a null tokenId are skipped.
Type Parameters
- T extends CombatantTokenRef
Parameters
- combatants: readonly T[]
  The combat's combatants, in turn order.
- tokenIds: ReadonlySet<string>
  The ids of the actor's tokens (see selectActorTokens).
Returns T | null
The first matching combatant, or null.
- Defined in src/document/actor/logic/token-helpers.ts:65