WebAssembly.Exception.prototype.is()

Baseline Widely available

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

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

js
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.

js
// 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.

js
// 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

Voir aussi