WebAssembly.Exception.prototype.is()
La méthode is()
, rattachée au prototype d'un objet Exception
, peut être utilisée afin de déterminer si l'objet Exception
correspond à une balise donnée.
La méthode peut être utilisée afin de tester si une balise est correcte avant de la passer à Exception.prototype.getArg()
pour obtenir les valeurs passées à l'exception. Elle peut être utilisée pour les balises créées côté JavaScript ou créées dans du code WebAssembly qui les exporte en JavaScript.
Note : Avoir la même séquence des mêmes types de données ne suffit pas. Il faut que la balise ait la même identité (que ce soit la même balise) que celle utilisée pour créer l'exception.
Syntaxe
is(tag);
Paramètres
tag
-
Une balise WebAssembly,
WebAssembly.Tag
, qui peut être utilisée pour vérifier le type de l'exception.
Valeur de retour
Un booléen qui indique si la balise fournie correspond à l'exception, true
si c'est le cas, false
sinon.
Exemples
Le fragment de code qui suit illustre comment utiliser la méthode is()
afin de vérifier qu'une balise correspond au type d'une Exception
.
// On crée la balise et on l'utilise pour créer une exception
const tag1 = new WebAssembly.Tag({ parameters: ["i32", "f64"] });
const exception1 = new WebAssembly.Exception(tag1, [42, 42.3]);
// On vérifie que "tag1" correspond pour cette exception
console.log(`Tag1 : ${exception1.is(tag1)}`);
// Affichage dans la console :
// Tag1 : true
On peut aussi montrer que l'exception ne correspondra pas à une autre balise, même si cette dernière utilise la même structure de paramètres.
// On crée une nouvelle balise avec les mêmes paramètres
// et on vérifie qu'elle ne correspond pas
const tag2 = new WebAssembly.Tag({ parameters: ["i32", "f64"] });
console.log(`Tag2 : ${exception1.is(tag2)}`);
// Affichage dans la console :
// Tag2 : false
Spécifications
Specification |
---|
WebAssembly JavaScript Interface: Exception Handling # dom-exception-is |
Compatibilité des navigateurs
BCD tables only load in the browser