WoW API: UnitHealth

Reference e
AddOns WoW API Widget API XML UI Event API WoW Lua Macro API CVars Battle.net HOWTOs Snippets UI tech Categories

→ WoW API

← WoW API < UnitHealth

Returns the current health of the specified unit. Returns the exact hitpoints for friendly players and pets in your raid/party, percentages otherwise.

local health = UnitHealth(unit);

Parameters

Arguments

unit

UnitId - the unit's health to query

Returns

health

Integer - current health of the specified unit.

Example

ChatFrame1:AddMessage('Player health: ' .. UnitHealth("player") .. " HP");
ChatFrame1:AddMessage('Target health: ' .. UnitHealth("target") .. "%"); -- Note: we're assuming the target isn't a friendly player/pet in our group.

Result

Prints the player's and target's health to the chat frame.