Esta página foi traduzida do inglês pela comunidade. Saiba mais e junte-se à comunidade MDN Web Docs.

View in English Always switch to English

Function.caller

Deprecated

Avoid using this feature in new projects. JavaScript strict mode prohibits accessing the caller and arguments properties of a Function object. This feature may be a candidate for removal from web standards or browsers.

Não padrão: Este recurso não é padronizado. Não recomendamos o uso de recursos não padronizados em produção, pois eles têm suporte limitado nos navegadores e podem mudar ou ser removidos. No entanto, podem ser uma alternativa viável em casos específicos onde não exista uma opção padrão.

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

Ver também