CKTIS / JavaScript
Tableaux typés : vue avec `subarray()`, copie avec `slice()`
`subarray()` crée une vue sur le même tampon, tandis que `slice()` copie par défaut les éléments sélectionnés dans un tampon distinct. Les deux interprètent les bornes de la même façon.
Version : ECMAScript 2024 and the current web platform; runtime support varies
Syntaxe
typedArray.subarray()
typedArray.subarray(start)
typedArray.subarray(start, end)
typedArray.slice()
typedArray.slice(start)
typedArray.slice(start, end)subarray() et slice() appartiennent au prototype commun dont héritent les instances telles que Uint16Array. Il n’existe pas de constructeur global TypedArray. Les deux méthodes exigent un véritable tableau typé comme this ; un Array ordinaire provoque une TypeError.
Les deux méthodes utilisent des indices d’éléments à partir de zéro dans la vue, et non des positions en octets dans le tampon comme ArrayBuffer.prototype.slice(). Le début est inclus, la fin exclue. Si start est omis ou vaut undefined, il est ramené à 0 ; si end est omis ou vaut undefined, la plage va jusqu’à la fin de la vue. Les fractions sont tronquées vers zéro, les indices négatifs se comptent à partir de la fin et les bornes sont ramenées entre 0 et la longueur de la vue. Si la fin ainsi calculée est égale au début ou le précède, les deux méthodes renvoient un tableau typé vide pour une vue valide sur un tampon de taille fixe lorsqu’elles utilisent le constructeur par défaut du résultat. Un constructeur personnalisé défini via constructor[Symbol.species] peut renvoyer un tableau typé non vide même si la longueur demandée est de 0.
Avec le constructeur par défaut du résultat, subarray() crée une nouvelle vue sur le même tampon sans copier les éléments. Les écritures dans la zone de recouvrement sont visibles dans les deux vues. Même une petite vue peut maintenir tout le tampon en mémoire, et sa propriété .buffer donne accès aux octets hors de la plage choisie. Utilisez slice() pour obtenir une copie indépendante des éléments sélectionnés. Un constructor[Symbol.species] personnalisé peut exécuter du code, modifier le type des éléments ou changer le partage de la mémoire du résultat. Ne considérez pas ces méthodes comme une barrière de sécurité pour des objets non fiables.
Dans ECMAScript 2024, avec le constructeur par défaut, si la longueur de la vue source suit la taille du tampon, celle de la vue issue de subarray() la suit également lorsque end est omis ou vaut undefined. Une valeur de end autre que undefined donne une vue de longueur fixe ; slice() donne par défaut une copie de longueur fixe. Si le tampon est détaché ou que la vue source est déjà hors limites au moment de l’appel, slice() lève une TypeError. Dans ce cas, subarray() effectue ses calculs avec une longueur source de 0, mais la construction du résultat peut tout de même échouer. Vérifiez la prise en charge des tampons redimensionnables dans votre environnement cible.
Exemples
{
const source = new Uint16Array([10, 20, 30, 40]);
const view = source.subarray(1, -1);
const copy = source.slice(1, -1);
view[0] = 99;
source[2] = 77;
console.log(`source: ${source.join(', ')}`);
console.log(`view: ${view.join(', ')}`);
console.log(`copy: ${copy.join(', ')}`);
console.log(`same buffer: ${view.buffer === source.buffer}, ${copy.buffer === source.buffer}`);
}Résultat
source: 10, 99, 77, 40 view: 99, 77 copy: 20, 30 same buffer: true, false
`(1, -1)` sélectionne `20` et `30`. Écrire via `view` modifie `source`, et écrire via `source` modifie `view`. `copy` conserve `20, 30` et possède son propre tampon.
Leçons associées
- JavaScript · Leçon 2 · Avancé · Version : 4
Sources
- ECMAScript® 2024 Language Specification — %TypedArray%.prototype.subarray
- ECMAScript® 2024 Language Specification — %TypedArray%.prototype.slice
- ECMAScript® 2024 Language Specification — TypedArraySpeciesCreate
- TypedArray.prototype.subarray() - JavaScript | MDN
- TypedArray.prototype.slice() - JavaScript | MDN
- TypedArray - JavaScript | MDN
- TypedArray[Symbol.species] - JavaScript | MDN
- ArrayBuffer.prototype.slice() - JavaScript | MDN