WoW API: TargetByName

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

→ WoW API

← WoW API < TargetByName

Target a player by their name.

TargetByName("name", exactMatch);

ParametersEdit

ArgumentsEdit

("name", exactMatch)

name: String - The name of the player to target.
exactMatch: Boolean

ExampleEdit

TargetByName("Norrin", true);

DetailsEdit

If the user isn't nearby or doesn't exist, and exactMatch isn't set, TargetByName picks the closest match from characters nearby.

If exactMatch is set, TargetByName can also target party members even if they are out of visible range.

If there is no close match available then an error message is displayed (Error event?) and the target is left unchanged. There is no return value from this method so the only way to check for success is see what the target ended up as afterwards.