Promise : propriété [Symbol.species]
Baseline
Large disponibilité
Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis janvier 2020.
La propriété d'accesseur statique Promise[Symbol.species] retourne le constructeur utilisé pour construire les valeurs de retour des méthodes de promesse.
Attention :
L'existence de [Symbol.species] permet l'exécution de code arbitraire et peut créer des vulnérabilités de sécurité. Elle rend également certaines optimisations beaucoup plus difficiles. Les personnes en charge de l'implémentation des moteurs enquêtent pour savoir s'il faut supprimer cette fonctionnalité (angl.). Évitez de vous y fier si possible.
Syntaxe
Promise[Symbol.species]
Valeur de retour
La valeur du constructeur (this) sur lequel get [Symbol.species] a été appelé. La valeur de retour est utilisée pour construire les valeurs de retour des méthodes de chaînage de promesses qui créent de nouvelles promesses.
Description
La propriété d'accesseur [Symbol.species] retourne le constructeur par défaut pour les objets Promise. Les constructeurs de sous-classes peuvent la remplacer pour modifier l'affectation du constructeur. L'implémentation par défaut est essentiellement :
// c'est une implémentation sous-jacente hypothétique à titre d'illustration
class Promise {
static get [Symbol.species]() {
return this;
}
}
En raison de cette implémentation polymorphe, [Symbol.species] des sous-classes dérivées retourne également le constructeur lui-même par défaut.
class SubPromise extends Promise {}
SubPromise[Symbol.species] === SubPromise; // true
Les méthodes de chaînage de promesses — then(), catch() et finally() — retournent de nouveaux objets promesse. Elles obtiennent le constructeur pour construire la nouvelle promesse avec this.constructor[Symbol.species]. Si this.constructor est undefined, ou si this.constructor[Symbol.species] est undefined ou null, le constructeur par défaut Promise() est utilisé. Sinon, le constructeur retourné par this.constructor[Symbol.species] est utilisé pour construire le nouvel objet promesse.
Examples
Les espèces dans les objets ordinaires
La propriété Symbol.species retourne la fonction constructeur par défaut, qui est le constructeur Promise pour les objets Promise.
Promise[Symbol.species]; // [Function: Promise]
Les espèces dans les objets dérivés
Dans une instance d'une sous-classe personnalisée de Promise, telle que MaPromesse, l'espèce MaPromesse est le constructeur MaPromesse. Cependant, vous pouvez vouloir remplacer cela afin de retourner des objets Promise parent dans les méthodes de votre classe dérivée.
class MaPromesse extends Promise {
// Surcharge de l'espèce MaPromesse pour le constructeur Promise parent
static get [Symbol.species]() {
return Promise;
}
}
Par défaut, les méthodes de promesse retournent des promesses du type de la sous-classe.
class MaPromesse extends Promise {
uneValeur = 1;
}
console.log(MaPromesse.resolve(1).then(() => {}).uneValeur); // 1
En surchargeant [Symbol.species], les méthodes de promesse retournent le type Promise de base.
class MaPromesse extends Promise {
uneValeur = 1;
static get [Symbol.species]() {
return Promise;
}
}
console.log(MaPromesse.resolve(1).then(() => {}).uneValeur); // undefined
Spécifications
| Spécification |
|---|
| ECMAScript® 2027 Language Specification # sec-get-promise-%symbol.species% |
Compatibilité des navigateurs
Voir aussi
- L'objet natif
Promise - La propriété statique
Symbol.species