Function.caller

Non-standard: This feature is non-standard and is not on a standards track. Do not use it on production sites facing the Web: it will not work for every user. There may also be large incompatibilities between implementations and the behavior may change in the future.

A propriedade function.caller retorna a função que invocou a função especificada.

Descrição

Se a função f foi invocada pelo codigo mais alto nível, o valor de f.caller é null, caso contrario, o valor será a função a qual invocou f.

Esta propriedade substitui a propriedade obsoleta arguments.caller do objeto arguments.

A propriedade especial __caller__, a qual retornou o objeto de ativação do chamador, permitindo assin reconstruir o stack, foi removido por motivo de segurança.

Notas

Note que no caso de recurção, você não pode reconstruir o stack de chamadas usando esta propriedade. Considere:

js
function f(n) {
  g(n - 1);
}
function g(n) {
  if (n > 0) {
    f(n);
  } else {
    stop();
  }
}
f(2);

No momento em que stop() é chamado o stack será:

js
f(2) -> g(1) -> f(1) -> g(0) -> stop()

O seguinte é true:

js
stop.caller === g && f.caller === g && g.caller === f;

então se você tentou recuperar o stack trace na função stop() assim:

js
var f = stop;
var stack = "Stack trace:";
while (f) {
  stack += "\n" + f.name;
  f = f.caller;
}

o loop nunca irá parar.

Exemplos

Verificando o valor da propriedade caller de uma função

O código a seguir verifica o valor da propriedade caller de uma função.

js
function myFunc() {
  if (myFunc.caller == null) {
    return "The function was called from the top!";
  } else {
    return "This function's caller was " + myFunc.caller;
  }
}

Especificações

Não faz parte de nenhuma especificação. Implementado no JavaScript 1.5.

Compatibilidade com navegadores

Report problems with this compatibility data on GitHub
desktopmobileserver
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Deno
Node.js
caller
DeprecatedNon-standard

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
Non-standard. Check cross-browser support before using.
Deprecated. Not for use in new websites.

Ver também