WoW:API UnitAura: Difference between revisions

(expirationTime is always returned regardless of who cast the buff/debuff)
Line 3: Line 3:
This function was introduced in Patch 3.0. It will serve as an all-in-one solution for querying unit buffs and debuffs. [[API UnitBuff|UnitBuff]] and [[API UnitDebuff|UnitDebuff]] will serve as aliases with built-in harmful/helpful filters.
This function was introduced in Patch 3.0. It will serve as an all-in-one solution for querying unit buffs and debuffs. [[API UnitBuff|UnitBuff]] and [[API UnitDebuff|UnitDebuff]] will serve as aliases with built-in harmful/helpful filters.
Usage:
Usage:
  name, rank, icon, count, debuffType, duration, expirationTime, unitCaster, isStealable  
  name, rank, icon, count, debuffType, duration, expirationTime, unitCaster, isStealable, shouldConsolidate, spellId
   = UnitAura("unit", index or ["name", "rank"][, "filter"])  
   = UnitAura("unit", index or ["name", "rank"][, "filter"])  


Line 21: Line 21:
; unitCaster : String - [[unitId]] reference to the unit that casted the buff/debuff.
; unitCaster : String - [[unitId]] reference to the unit that casted the buff/debuff.
; isStealable : Boolean - 1 or nil depending on if the aura can be spellstolen.
; isStealable : Boolean - 1 or nil depending on if the aura can be spellstolen.
 
; shouldConsolidate : Boolean - 1 or nil depending on if the default Blizzard UI should put the aura into the "consolidated" box of buffs.
; spellId : Number - the spellId of the aura.


==Macro Options:==
==Macro Options:==
Line 31: Line 32:
* Patch 3.0 combined UnitDebuff and UnitBuff into this command.
* Patch 3.0 combined UnitDebuff and UnitBuff into this command.
* Patch 3.1 changed "isMine" to "unitCaster". It is now possible for addons to retrieve the unitId that cast the buff/debuff.
* Patch 3.1 changed "isMine" to "unitCaster". It is now possible for addons to retrieve the unitId that cast the buff/debuff.
* Patch 3.3 added shouldConsolidate and spellId


== See Also ==
== See Also ==
Anonymous user