UnitHealth

Main Menu
WoW API Lua API FrameXML Widget API Widget scripts XML schema Events CVars Macro commands Combat Log Escape sequences Hyperlinks API changes HOWTOs wowuidev

Flavors
war within  mainline  cata  wrath  vanilla
Links
Blizzard Docs  Townlong Yak  Offline /api  Wowprogramming  GitHub Search
Info
Added in 1.0.0 / 1.13.2

Returns the current health of the unit.

health = UnitHealth(unit [, usePredicted])

Arguments

unit

string : UnitToken

usePredicted

boolean? = true

Returns

health

number - Returns 0 if the unit is dead or does not exist.

Details

Related Events	UNIT_HEALTH
Available after	PLAYER_ENTERING_WORLD (on login)

Patch changes

Retail

Patch 3.0.2 (2008-10-14): Returns absolute health instead of percentages for non party/raid units.

Classic

Patch 1.13.3 (2019-12-10): Returns absolute health values for NPCs to alleviate addon comms load from the Real Mob Health addon. Still returns health percentages for players. (Hotfix during build 33302, Feb 7 2020)
Patch 1.13.2 (2019-08-26): Added. Shows health percentages for non party/raid units.