WoW API: issecure

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 < issecure

Determinates if current environment is secure or "tainted." A secure environment is required to call Protected functions.

issecure()

Parameters

Arguments

none

Return

nil

(probably returns another value - maybe 1 - if current environment is secure, but there's no known way to make it secure by ourselves, only Blizzard can)

Example

local secure = issecure();
if not ( secure == nil ) then 
 DEFAULT_CHAT_FRAME:AddMessage("OK! Current environment is secure; we may call Protected functions !");
else
 DEFAULT_CHAT_FRAME:AddMessage("Current environment is not secure; calling Protected functions will show up Forbidden popup !");
end

Result

Executing this script will always show up "Current environment is not secure; calling Protected functions will show up Forbidden popup !" in your chat frame :'(

Notes

This function should always return nil to any third party AddOn/macro maker. Only Blizzard UI coders would be able to make it return another value than nil.