m
Move page script moved page API UnitBuff to WoW:API UnitBuff without leaving a redirect
m (isMine->source) |
m (Move page script moved page API UnitBuff to WoW:API UnitBuff without leaving a redirect) |
||
| (4 intermediate revisions by 4 users not shown) | |||
| Line 1: | Line 1: | ||
{{wowapi}} __NOTOC__ | {{wowapi}} __NOTOC__ | ||
Retrieves info about a certain buff on a certain unit. This is essentially an alias of [[API_UnitAura|UnitAura]] with the "HELPFUL" filter. | |||
name, rank, icon, count, debuffType, duration, expirationTime, | name, rank, icon, count, debuffType, duration, expirationTime, unitCaster, isStealable, | ||
shouldConsolidate, spellId = UnitBuff("unit", [index] or ["name", "rank"][, "filter"]) | |||
== Arguments == | == Arguments == | ||
;unitId : String - The [[unitId|unit]] to query information for | ;unitId : String - The [[unitId|unit]] to query information for | ||
;index or name : Number or string - The index or name of the buff to retrieve information for. Indices start at 1 and go up indefinitely until there are no more buffs on target. | ;index or name : Number or string - The index or name of the buff to retrieve information for. Indices start at 1 and go up indefinitely until there are no more buffs on target. | ||
; | ;filter : String - zero or more of "PLAYER", "RAID", "CANCELABLE", "NOT_CANCELABLE", separated by pipe ("|") or space characters. | ||
== Returns == | == Returns == | ||
;name : String - The name of the spell or effect of the buff, or nil if no buff was found with the specified name or at the specified index. This is the name shown in yellow when you mouse over the icon. | ;name : String - The name of the spell or effect of the buff, or nil if no buff was found with the specified name or at the specified index. 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 buff. Returns "" if there is no rank. | ;rank : String - The rank line from the tooltip of the spell or effect that caused the buff, e.g. "Rank 2". Returns "" if there is no rank. | ||
;iconTexture : String - The identifier of (path and filename to) the indicated buff. | ;iconTexture : String - The identifier of (path and filename to) the indicated buff. | ||
;count : Number - The number of times the buff has been applied to the target. | ;count : Number - The number of times the buff has been applied to the target. | ||
| Line 19: | Line 19: | ||
;source : String - The [[unitId|unit]] that cast the buff | ;source : String - The [[unitId|unit]] that cast the buff | ||
;isStealable : Boolean - 1 if it is stealable otherwise nil | ;isStealable : Boolean - 1 if it is stealable otherwise nil | ||
;shouldConsolidate : Boolean - 1 if the buff should be placed in a buff consolidation box (usually long-term effects). | |||
;spellId : Number - spell ID of the aura. | |||
== Example == | == Example == | ||