Error : proprit statique stackTraceLimit

Non standard: Cette fonctionnalit n'est pas standardise. Nous dconseillons d'utiliser des fonctionnalits non standard en production, car leur prise en charge par les navigateurs est limite, et elles peuvent tre modifies ou supprimes. Toutefois, elles peuvent constituer une alternative approprie dans certains cas o aucune option standard n'existe.

Note : Cette fonctionnalit fait partie de l'API de trace de pile (angl.) actuellement non standard de V8. Cependant, pour des raisons de compatibilit, elle est aussi implmente par JavaScriptCore.

La proprit de donne statique stackTraceLimit d'une instance de Error indique le nombre maximal de trames de pile captures par la trace de pile d'une erreur. Elle peut tre dfinie par le code utilisateur pour modifier le comportement du moteur.

En gnral, lire cette proprit n'est pas trs utile, mais vous pouvez la dfinir une nouvelle valeur. L'augmenter peut tre utile pour le dbogage, car cela permet de voir une plus grande partie de la pile d'appels. La diminuer peut amliorer les performances car cela rduit la quantit de pile capture.

Valeur

Un entier reprsentant le nombre maximal de trames de pile captures par la trace de pile d'une erreur.

Attributs de `Error : proprit statique stackTraceLimit`
crivable	Oui
numrable	Oui
Configurable	Oui

Description

Comme stackTraceLimit est une proprit statique de Error, vous l'utilisez toujours comme Error.stackTraceLimit, et non comme une proprit d'un objet Error que vous avez cr. Si vous souhaitez personnaliser la trace de pile pour une seule erreur, vous devrez peut-tre dfinir la proprit, crer l'erreur, puis rinitialiser la proprit sa valeur d'origine.

Exemples

Dfinir la proprit `stackTraceLimit`

Ce code peut tre excut sans risque mme dans des environnements qui ne prennent pas en charge Error.stackTraceLimit, car il ne lit pas la proprit, il ne fait que la dfinir, et les moteurs qui ne la prennent pas en charge ignoreront ce rglage.

Error.stackTraceLimit = 2;
const a = () => b();
const b = () => c();
const c = () => d();
const d = () => e();
const e = () => {
  throw new Error("Mon erreur");
};
try {
  a();
} catch (e) {
  console.log(e.stack);
}
// Seulement deux trames dans les moteurs qui le prennent en charge ;
// toutes les trames dans les autres