WoW API: UnitDebuff

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

Retrieve info about a certain debuff on a certain unit.

name, rank, texture, count, debuffType, duration, timeLeft  =  UnitDebuff(unitID, debuffIndex [, removable]);

Parameters

unitName: String - The unit you want debuff information for.
debuffIndex: Number - The index of the debuff to retrieve info for. Starts at 1, maximum 40.
removable: Boolean - (optional) - If 1, only debuffs removable by player will be returned; debuffIndex still begins at 1.

name: String - The name of the spell or effect of the debuff. This is the name shown in yellow when you mouse over the icon.
rank: String - The rank of the spell or effect that caused the debuff. Returns "" if there is no rank.
texture: String - The identifier of (path and filename to) the indicated debuff, or nil if no debuff
count: Number - The number of times the debuff has been applied to the target. Returns 0 for any debuff which doesn't stack. ( Changed in 1.11 ).
debuffType: String - The type of the debuff: Magic, Disease, Poison, Curse, or nothing for those with out a type.
duration: Number - The full duration of the debuff in seconds; nil if the debuff was not cast by the player.
timeLeft: Number - Time until the debuff expires, in seconds; nil if the deubff was not cast by the player.

name, rank, texture = UnitDebuff("pet", 1);

Retrieves the name, rank and icon texture of the first debuff on the player's pet.