API AuraUtil.FindAuraByName

Finds the first aura that matches the name. name, icon, count, debuffType, duration, expirationTime, unitCaster, canStealOrPurge, nameplateShowPersonal, spellId, canApplyAura, isBossDebuff, isCastByPlayer, nameplateShowAll, timeMod, ... = AuraUtil.FindAuraByName(auraName, unit [, filter])

Arguments

 * auraName : string - localized name of the aura.
 * unit : string (unitId) - unit whose auras to query.
 * filter : string ? - list of filters, separated by spaces or pipes. "HELPFUL" by default. The following filters are available:
 * HELPFUL - buffs.
 * HARMFUL - debuffs.
 * PLAYER - auras that were applied by the player.
 * RAID - auras that can be applied (if HELPFUL) or dispelled (if HARMFUL) by the player.
 * CANCELABLE - buffs that can be removed (such as by right-clicking or using the /cancelaura command)
 * NOT_CANCELABLE - buffs that cannot be removed

Returns

 * name : string - name of the aura
 * icon : number (fileID) - identifier of the texture used for the aura's icon.
 * count : number - number of times the aura has been applied to the target, or 0 for auras that do not stack
 * debuffType : string - type of the aura ("Magic", "Disease", "Poison", "Curse", or an empty string for Enrage effects), or nil for auras that do not have a type
 * duration : number - full duration of the aura in seconds
 * expirationTime : number - time in seconds (comparable to ) when the aura will expire
 * unitCaster : string (unitId) - unit that applied the aura, or nil if no valid unit token currently represents the caster
 * canStealOrPurge : boolean - true for buffs that can be stolen by mages with Spellsteal, or false for debuffs and for buffs that cannot be stolen, or for debuffs
 * nameplateShowPersonal : boolean - true for buffs that should be shown on player/pet/vehicle nameplates
 * spellId : number - spell ID of the spell or effect that applied the aura
 * canApplyAura : boolean - true for auras the player can apply (not necessarily if the player did apply the aura, just if the player can apply the aura)
 * isBossDebuff : boolean - true for auras applied by a boss
 * isCastByPlayer : boolean - true for auras applied by players
 * nameplateShowAll : <font color="#ecbc2a">boolean - true for auras that should be shown on all nameplates
 * timeMod : <font color="#ecbc2a">number - scaling factor for time left (appears to always be 1; Blizzard's display code would be incorrect otherwise).
 * ... : Additional values pertinent to specific aura (HoTs, traps, amounts etc. For example, the first value for Vengeance is its attack power bonus.)