Array : accesseur statique [Symbol.species]

Syntaxe

Array[Symbol.species]

Valeur de retour

La valeur du constructeur (this) sur lequel get [Symbol.species] a t appel. Cette valeur est utilise pour construire les valeurs de retour des mthodes de tableau qui crent de nouveaux tableaux.

Description

La proprit accesseur [Symbol.species] retourne le constructeur par dfaut pour les objets Array. Les constructeurs des sous-classes peuvent la surcharger pour modifier l'affectation du constructeur. L'implmentation par dfaut est essentiellement :

// Implmentation sous-jacente hypothtique  titre d'illustration
class Array {
  static get [Symbol.species]() {
    return this;
  }
}

En raison de cette implmentation polymorphe, [Symbol.species] des sous-classes drives retournera galement par dfaut le constructeur lui-mme.

class SubArray extends Array {}
SubArray[Symbol.species] === SubArray; // true

Lorsque vous appelez des mthodes de tableau qui ne modifient pas le tableau existant mais retournent une nouvelle instance de tableau (par exemple, filter() et map()), le constructor[Symbol.species] du tableau sera utilis. Le constructeur retourn servira construire la valeur de retour de la mthode de tableau. Cela rend techniquement possible de faire retourner par les mthodes de tableau des objets qui ne sont pas des tableaux.

class NotAnArray {
  constructor(length) {
    this.length = length;
  }
}

const arr = [0, 1, 2];
arr.constructor = { [Symbol.species]: NotAnArray };
arr.map((i) => i); // NotAnArray { '0': 0, '1': 1, '2': 2, length: 3 }
arr.filter((i) => i); // NotAnArray { '0': 1, '1': 2, length: 0 }
arr.concat([1, 2]); // NotAnArray { '0': 0, '1': 1, '2': 2, '3': 1, '4': 2, length: 5 }

Exemples

Species dans les objets ordinaires

La proprit [Symbol.species] retourne la fonction constructeur par dfaut, qui est le constructeur Array pour Array.

Array[Symbol.species]; // [Function: Array]

Species dans les objets drivs

Dans une instance d'une sous-classe personnalise de Array, comme MyArray, le species de MyArray est le constructeur MyArray. Cependant, vous pouvez vouloir le redfinir afin de retourner des objets Array parents dans les mthodes de votre classe drive :

class MyArray extends Array {
  // Redfinit le species de MyArrayArray vers le constructeur parent Array
  static get [Symbol.species]() {
    return Array;
  }
}

Spcifications

Compatibilit des navigateurs

Voir aussi

• Guide des collections indexes
• L'objet natif Array
• La proprit Symbol.species
• Prothse d'mulation de Array[Symbol.species] et prise en charge de [Symbol.species] dans toutes les mthodes concernes de Array dans core-js (angl.)