[ Web Proxy ]
URL:
Viewing: https://developer.mozilla.org/fr/docs/Web/JavaScript/Reference/Global_Objects/TypedArray/map [Back]  [Original]

TypedArray.prototype.map() - JavaScript | MDN

Cette page a t traduite partir de l'anglais par la communaut. Vous pouvez contribuer en rejoignant la communaut francophone sur MDN Web Docs.

View in English Always switch to English

TypedArray.prototype.map()

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 septembre 2016.

La mthode map() cre un nouveau tableau typ dont les lments sont les images des lments du tableau typ courant par une fonction donne. Cette mthode utilise le mme algorithme que Array.prototype.map(). TypedArray est utilis ici de faon gnrique pour reprsenter l'un des types de tableaux typs possibles.

Dans cet article

Exemple interactif

const uint8 = new Uint8Array([25, 36, 49]);
const roots = uint8.map(Math.sqrt);

console.log(roots);
// Expected output: Uint8Array [5, 6, 7]

Syntaxe

js
typedarray.map(callback[, thisArg])

Paramtres

callback

La fonction qui renvoie l'lment placer dans le nouveau tableau typ. Cette fonction utilise trois arguments :

valeurCourante

La valeur de l'lment du tableau typ courant, celui trait par la fonction.

indice

L'indice de l'lment du tableau typ en cours de traitement.

tableauTyp

Le tableau typ sur lequel map() a t appele.

thisArg

Paramtre optionnel. La valeur utiliser pour this lors de l'appel callback.

Valeur de retour

Un nouveau tableau typ.

Description

La mthode map() appelle la fonction callback() passe en argument une fois pour chaque lment du tableau typ pour construire un nouveau tableau partir des rsultats de la fonction. Les appels callback sont effectus dans l'ordre du tableau typ. callback() n'est appele que pour les lments du tableaux qui ont une valeur, elle n'est pas appele pour les lments qui sont indfinis ou qui ont t supprims.

callback() est appele avec trois arguments : la valeur de l'lment, l'indice de cet lment et enfin le tableau typ courant.

Si un paramtre thisArg est fourni pour map(), il sera pass callback pour les diffrents appels et servira de valeur this. Par dfaut, la valeur undefined sera passe la fonction pour la valeur this. Par ailleurs, la valeur de this accessible depuis la fonction callback est dtermine selon les rgles usuelles dterminant la valeur this au sein d'une fonction.

map() ne modifie pas le tableau typ sur lequel elle a t appele (indirectement, c'est la fonction callback qui pourra ventuellement modifier le tableau).

La liste des lments parcourus par map() est dfinie avant la premire invocation de la fonction callback. Les lments qui sont ajouts au tableau typ aprs le dbut de l'appel de map() (grce la fonction callback par exemple) ne seront pas visits. Si des lments existants du tableau typ ont modifis ou supprims, la valeur fournie la fonction callback sera leur valeur au moment o map() les visite - les lments supprims ne seront pas traits par la fonction.

Exemples

Obtenir un tableau typ des racines carres des lments d'un premier tableau typ

Dans l'exemple suivant, on cre un nouveau tableau typ dont les lments seront les racines carres respectives des lments d'un tableau typ existant.

js
var nombres = new Uint8Array([1, 4, 9]);
var racines = nombres.map(Math.sqrt);
// racines vaut dsormais Uint8Array [1, 2, 3],
// nombres vaut toujours Uint8Array [1, 4, 9]

Utiliser map() avec une fonction qui prend un argument

Ici, on illustre comment une fonction utilisant un argument peut tre utilise avec map(). Cet argument recevra automatiquement la valeur de chaque lment du tableau typ au fur et mesure du parcours.

js
var nombres = new Uint8Array([1, 4, 9]);
var doubles = nombres.map(function (num) {
  return num * 2;
});
// doubles vaut dsormais Uint8Array [2, 8, 18]
// nombres vaut toujours Uint8Array [1, 4, 9]

Spcifications

Spcification
ECMAScript 2027 LanguageSpecification
# sec-%typedarray%.prototype.map

Compatibilit des navigateurs

Voir aussi


Web Proxy Viewer  |  New URL  |  Original Page