Error.stackTraceLimit

Статическое свойство данных Error.stackTraceLimit указывает максимальное количество кадров стека, захватываемых трассировкой стека ошибки. Оно может быть установлено пользовательским кодом для изменения поведения движка.

В целом, чтение этого свойства не очень полезно, но вы можете установить для него новое значение. Установка большего значения может быть полезна для отладки, поскольку это позволяет увидеть большую часть стека вызовов. Установка меньшего значения может повысить производительность, так как уменьшает объем захватываемого стека.

Значение

Целое число, представляющее максимальное количество кадров стека, захватываемых трассировкой стека ошибки.

Описание

Поскольку stackTraceLimit является статическим свойством Error, вы всегда используете его как Error.stackTraceLimit, а не как свойство созданного вами объекта Error. Если вы хотите настроить трассировку стека только для одной ошибки, вам может потребоваться установить свойство, создать ошибку, а затем сбросить свойство до его исходного значения.

Примеры

Установка Error.stackTraceLimit

Этот код безопасно выполнять даже в средах, которые не поддерживают Error.stackTraceLimit, потому что он не считывает свойство, а только устанавливает его, и движки, которые его не поддерживают, проигнорируют эту установку.

Error.stackTraceLimit = 2;
const a = () => b();
const b = () => c();
const c = () => d();
const d = () => e();
const e = () => {
  throw new Error("My error");
};
try {
  a();
} catch (e) {
  console.log(e.stack);
}
// Only two frames in supporting engines; all frames in others

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

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

См. также

• Error.prototype.stack
• Error.captureStackTrace()
• API трассировки стека в документации V8