WebAssembly.LinkError()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since October 2017.

Le constructeur WebAssembly.LinkError() permet de créer un nouvel objet WebAssembly LinkError qui indique qu'une erreur s'est produite lors de l'instanciation du module (en plus des trappes provenant de la fonction initiale).

Syntaxe

js
new WebAssembly.LinkError(message, nomFichier, numeroLigne);

Paramètres

message Facultatif

Une description, compréhensible par un humain, de l'erreur qui s'est produite.

nomFichier Facultatif Non-standard

Le nom du fichier qui contient le code à l'origine de l'exception.

numeroLigne Facultatif Non-standard

Le numéro de ligne dans le fichier contenant le code à l'origine de l'exception.

Propriétés

Le constructeur LinkError ne contient pas de propriétés qui lui soient propres. Il hérite cependant de certaines propriétés via sa chaîne de prototypes.

WebAssembly.LinkError.prototype.constructor

Cette propriété est la fonction qui permet de créer le prototype de l'instance.

WebAssembly.LinkError.prototype.message

Le message d'erreur. Bien qu'ECMA-262 indique que l'objet doive fournir sa propre propriété message, dans SpiderMonkey, celle-ci est héritée depuis Error.prototype.message.

WebAssembly.LinkError.prototype.name

Le nom de l'erreur. Cette propriété est héritée via Error.

WebAssembly.LinkError.prototype.fileName

Le chemin du fichier qui a entraîné l'erreur. Cette propriété est héritée via Error.

WebAssembly.LinkError.prototype.lineNumber

Le numéro de ligne dans le fichier qui a entraîné l'erreur. Cette propriété est héritée via Error.

WebAssembly.LinkError.prototype.columnNumber

Le numéro de la colonne dans la ligne du fichier qui a entraîné l'erreur. Cette propriété est héritée via Error.

WebAssembly.LinkError.prototype.stack

La pile d'appels à l'origine de l'erreur. Cette propriété est héritée depuis Error.

Méthodes

Le constructeur LinkError ne contient pas de méthodes qui lui soient propres. Il hérite toutefois de méthodes grâce à sa chaîne de prototypes.

WebAssembly.LinkError.prototype.toSource()

Cette méthode renvoie un code qui pourrait être évalué et causere la même erreur. Elle est héritée via Error.

WebAssembly.LinkError.prototype.toString()

Cette méthode renvoie une chaîne de caractères qui représente l'objet de l'erreur. Elle est héritée via Error.

Exemples

Dans le fragment de code qui suit, on crée un nouvelle instance de LinkError puis on imprime les détails dans la console :

js
try {
  throw new WebAssembly.LinkError("Coucou", "unFichier", 10);
} catch (e) {
  console.log(e instanceof LinkError); // true
  console.log(e.message); // "Coucou"
  console.log(e.name); // "LinkError"
  console.log(e.fileName); // "unFichier"
  console.log(e.lineNumber); // 10
  console.log(e.columnNumber); // 0
  console.log(e.stack); // renvoie la pile d'appels
  // à l'origine de l'erreur
}

Spécifications

Specification
WebAssembly JavaScript Interface
# exceptiondef-linkerror
ECMAScript Language Specification
# sec-native-error-types-used-in-this-standard

Compatibilité des navigateurs

BCD tables only load in the browser

Voir aussi