Symbol.isConcatSpreadable
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since abril de 2017.
El símbolo conocido como Symbol.isConcatSpreadable se utiliza para configurar si un objeto debe ser aplanado a sus elementos del array cuando se utiliza el método Array.prototype.concat().
Pruébalo
Descripción
El símbolo @@isConcatSpreadable (Symbol.isConcatSpreadable) puede ser definido como una propiedad propia o heredada y su valor es un booleano. Puede controlar el comportamiento de los arrays y de los objetos tipo array:
- Para los objetos tipo matriz, el comportamiento por defecto es extender (aplanar) los elementos.
Symbol.isConcatSpreadablepuede evitar el aplanamiento en estos casos. - En el caso de los objetos tipo array, el comportamiento por defecto es no extender ni aplanar.
Symbol.isConcatSpreadablepuede forzar el aplanamiento en estos casos.
Atributos de la propiedad Symbol.isConcatSpreadable | |
|---|---|
| Sobrescribir | No |
| Numerable | No |
| Configurable | No |
Ejemplos
Arrays
Por defecto, Array.prototype.concat() extiende (aplana) las matrices en su resultado:
Al establecer el valor de Symbol.isConcatSpreadable a false, puedes desactivar el comportamiento por defecto:
Objetos tipo array
Para los objetos tipo array, el valor por defecto es no extender. Symbol.isConcatSpreadable necesita ser establecido a true para obtener un array aplanado:
Nota: La propiedad length se utiliza para controlar el número de propiedades del objeto a añadir. En el ejemplo anterior, length:2 indica que hay que añadir dos propiedades.
Especificaciones
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-symbol.isconcatspreadable |