JavaScript tutorial:
caller property

 

Applies to: Function Object

The caller property is used to get a reference to the function that invoked the current function.

Syntax

functionname.caller

Return

Returns a reference to the function that invoked the current function.

Example

The caller property is only defined for a function while that function is executing. If the function is called from the top level of a JavaScript program, caller contains null.

If the caller property is used in a string context, the result is the same as functionname.toString, that is, the decompiled text of the function is displayed.

The following example illustrates the use of the caller property:

function CallLevel()
{
    if (CallLevel.caller == null)
        return("CallLevel was called from the top level.");
    else
        return("CallLevel was called by another function.");
}

function CallMe()
{
    return(CallLevel());
}
document.write(CallLevel());
document.write(CallMe());

  To run the code above, paste it into JavaScript Editor, and click the Execute button.

See also: function Statement