Function.prototype.caller

Свойство-аксессор caller экземпляров Function возвращает функцию, которая вызвала эту функцию. Для строгих, стрелочных, асинхронных и генераторных функций доступ к свойству caller вызывает TypeError.

Описание

Если функция f была вызвана кодом верхнего уровня, значение f.caller равно null; в противном случае это функция, которая вызвала f. Если функция, вызвавшая f, является функцией строгого режима, значение f.caller также равно null.

Обратите внимание, что единственное поведение, указанное в спецификации ECMAScript, заключается в том, что Function.prototype имеет начальный аксессор caller, который безусловно вызывает TypeError при любом запросе get или set (известный как "аксессор-отравленная пилюля"), и что реализациям не разрешается изменять эту семантику для любых функций, кроме нестрогих обычных функций, и в этом случае он не должен иметь значения функции строгого режима. Фактическое поведение свойства caller, если оно отличается от генерации ошибки, определяется реализацией. Например, Chrome определяет его как собственное свойство данных, в то время как Firefox и Safari расширяют начальный аксессор Function.prototype.caller "отравленной пилюли", чтобы специально обрабатывать значения this, которые являются нестрогими функциями.

(function f() {
  if (Object.hasOwn(f, "caller")) {
    console.log(
      "caller is an own property with descriptor",
      Object.getOwnPropertyDescriptor(f, "caller"),
    );
  } else {
    console.log(
      "f doesn't have an own property named caller. Trying to get f.[[Prototype]].caller",
    );
    console.log(
      Object.getOwnPropertyDescriptor(
        Object.getPrototypeOf(f),
        "caller",
      ).get.call(f),
    );
  }
})();

// In Chrome:
// caller is an own property with descriptor {value: null, writable: false, enumerable: false, configurable: false}

// In Firefox:
// f doesn't have an own property named caller. Trying to get f.[[Prototype]].caller
// null

Это свойство заменяет устаревшее свойство arguments.caller объекта arguments.

Специальное свойство __caller__, которое возвращало объект активации вызывающей стороны, позволяя таким образом восстановить стек, было удалено по соображениям безопасности.

Примеры

Проверка значения свойства caller функции

Следующий код проверяет значение свойства caller функции.

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

Восстановление стека и рекурсия

Обратите внимание, что в случае рекурсии вы не можете восстановить стек вызовов, используя это свойство. Рассмотрим:

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

В момент вызова stop() стек вызовов будет следующим:

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

Верно следующее:

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

поэтому, если вы попытаетесь получить трассировку стека в функции stop() таким образом:

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

цикл никогда не остановится.

Вызывающая сторона в строгом режиме

Если вызывающая сторона является функцией строгого режима, значение caller равно null.

function callerFunc() {
  calleeFunc();
}

function strictCallerFunc() {
  "use strict";
  calleeFunc();
}

function calleeFunc() {
  console.log(calleeFunc.caller);
}

(function () {
  callerFunc();
})();
// Logs [Function: callerFunc]

(function () {
  strictCallerFunc();
})();
// Logs null

Спецификации

Не является частью какого-либо стандарта.

Совместимость с браузерами

См. также

• Function.prototype.name
• arguments