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])
- string - localized name of the aura.
- string (unitId) - unit whose auras to query.
- 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
- string - name of the aura
- number (fileID) - identifier of the texture used for the aura's icon.
- number - number of times the aura has been applied to the target, or 0 for auras that do not stack
- 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
- number - full duration of the aura in seconds
- number - time in seconds (comparable to GetTime()) when the aura will expire
- string (unitId) - unit that applied the aura, or nil if no valid unit token currently represents the caster
- boolean - true for buffs that can be stolen by mages with , or false for debuffs and for buffs that cannot be stolen, or for debuffs
- boolean - true for buffs that should be shown on player/pet/vehicle nameplates
- number - spell ID of the spell or effect that applied the aura
- 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)
- boolean - true for auras applied by a boss
- boolean - true for auras applied by players
- boolean - true for auras that should be shown on all nameplates
- 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.)
- Aura names are not unique
- Aura names are localized, what works in one locale might not work in another. Consider that in English two auras might have different names, but once localized they have the same name, so even using the localized aura name in a search it could result in different behavior
- The unit could have multiple auras with the same name, this will only find the first
- Patch 8.0.1 (2018-07-17): Added.