Function.prototype.arguments

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

Описание

Значение arguments — это объект, похожий на массив, соответствующий аргументам, переданным функции.

В случае рекурсии, то есть если функция f несколько раз появляется в стеке вызовов, значение f.arguments представляет аргументы, соответствующие самому последнему вызову функции.

Значение свойства arguments обычно равно null, если нет активного вызова функции (то есть функция была вызвана, но еще не вернула значение).

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

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

// In Chrome:
// arguments is an own property with descriptor {value: Arguments(0), writable: false, enumerable: false, configurable: false}

// In Firefox:
// f doesn't have an own property named arguments. Trying to get f.[[Prototype]].arguments
// Arguments { … }

Примеры

Использование свойства arguments

function f(n) {
  g(n - 1);
}

function g(n) {
  console.log(`before: ${g.arguments[0]}`);
  if (n > 0) {
    f(n);
  }
  console.log(`after: ${g.arguments[0]}`);
}

f(2);

console.log(`returned: ${g.arguments}`);

// Logs:
// before: 1
// before: 0
// after: 0
// after: 1
// returned: null

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

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

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

См. также

• arguments
• Функции