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

TypedArray.from() - 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.from()

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 TypedArray.from() cre un nouvel objet TypedArray partir d'un objet itrable ou d'un objet semblable un tableau. Cette mthode est similaire Array.from().

Dans cet article

Syntaxe

js
TypedArray.from(source[, mapFn[, thisArg]])

o TypedArray est l'un de :

Paramtres

source

Un objet semblable un tableau ou un objet itrable, et partir duquel on souhaite crer un tableau typ.

fonctionMap

Argument optionnel, une fonction appliquer chacun des lments du tableau.

thisArg

Argument optionnel. La valeur utiliser pour this lors de l'excution de la fonction fonctionMap.

Valeur de retour

Une nouvelle instance de TypedArray.

Description

TypedArray.from() permet de crer des tableaux typs partir :

Array.from possde un paramtre optionnel fonctionMap, qui permet d'excuter une fonction map sur chacun des lments du tableau typ (ou de l'instance de la classe fille) qui est cr. Autrement dit TypedArray.from(obj, fonctionMap, thisArg) correspond exactement TypedArray.from(obj).map(fonctionMap, thisArg).

Il existe de lgres diffrences entre Array.from() et TypedArray.from() :

  • Si la valeur de this passe TypedArray.from n'est pas un constructeur, TypedArray.from lvera une exception TypeError, tandis que Array.from crera un nouvel objet Array.
  • TypedArray.from utilise [[Set]] tandis que Array.from utilise [[DefineProperty]]. Ainsi par exemple lorsque des objets Proxy sont manipuls la premire mthode appellera handler.set pour crer les nouveaux lments et la seconde appellera handler.defineProperty.
  • Lorsque source est un itrable, TypedArray.from va dans un premier temps rcuprer toutes ses valeurs, puis initialiser une instance de this l'aide de leur nombre, et enfin ajouter ces valeurs l'instance. Array.from ajoute les valeurs au nouvel objet lors du parcours de l'itrateur et ne dfinit la taille de l'objet qu'en dernire tape.
  • Si Array.from reoit un objet semblable un tableau qui n'est pas un itrable, les valeurs non dfinies sont conserves. TypedArray.from construit un objet dense en liminant ces valeurs.

Exemples

js
// Set (objet itrable)
var s = new Set([1, 2, 3]);
Uint8Array.from(s);
// Uint8Array [ 1, 2, 3 ]

// String
Int16Array.from("123");
// Int16Array [ 1, 2, 3 ]

// En utilisant un fonction flche en tant que
// fonctionMap pour manipuler les lments
Float32Array.from([1, 2, 3], (x) => x + x);
// Float32Array [ 2, 4, 6 ]

// Pour construire une squence de nombres
Uint8Array.from({ length: 5 }, (v, k) => k);
// Uint8Array [ 0, 1, 2, 3, 4 ]

Spcifications

Spcification
ECMAScript 2027 LanguageSpecification
# sec-%typedarray%.from

Compatibilit des navigateurs

Voir aussi


Web Proxy Viewer  |  New URL  |  Original Page