Constructeur Uint32Array()
==========================

Le **constructeur `Uint32Array()`** permet de créer un nouveau tableau typé `Uint32Array` dont les éléments sont des nombres entiers non-signés, représentés sur 32 bits et utilisant le boutisme de la plateforme. S'il est nécessaire de contrôler l'ordre des octets, on utilisera un objet `DataView` à la place. Lors de la construction, les éléments du tableau sont initialisés avec la valeur `0`. Une fois le tableau construit, on peut faire référence aux éléments du tableau à l'aide des méthodes de l'objet ou en utilisant la notation avec les crochets et l'indice voulu.

Syntaxe
-------


```js
new Uint32Array(); // apparu avec ES2017
new Uint32Array(longueur);
new Uint32Array(tableauType);
new Uint32Array(object);

new Uint32Array(buffer);
new Uint32Array(buffer, decalageOctets);
new Uint32Array(buffer, decalageOctets, longueur);
```

### Paramètres

`longueur`

Lorsque le constructeur est appelé avec un argument `longueur`, un tableau interne de tampon de mémoire est créé avec une taille en octets de `longueur` *multipliée par `BYTES_PER_ELEMENT`* et dont les éléments sont des zéros.

`tableauType`

Lorsque le constructeur est appelé avec un argument `tableauType`, qui peut être un tableau typé de n'importe quel type non `bigint` (comme `Int32Array`), `tableauType` est copié dans un nouveau tableau typé et chaque valeur de `tableauType` est convertie dans le type correspondant au constructeur avant d'être copiée dans le nouveau tableau. La longueur du nouveau tableau typé est égale à celle de l'argument `tableauType`.

`object`

Lorsque le constructeur est appelé avec un argument objet quelconque, un nouveau tableau typé est créé, de la même façon qu'avec un appel à la méthode `TypedArray.from()`.

`buffer`, `decalageOctets`, `longueur`

Lorsqu'il est appelé avec un argument `buffer`, et éventuellement des arguments `decalageOctets` et `longueur`, le constructeur crée une nouvelle vue sous la forme d'un tableau typé qui porte sur l'objet `ArrayBuffer` donné par le paramètre `buffer`. Les paramètres `decalageOctets` et `longueur` indiquent l'intervalle de mémoire exposé à la vue formée par le tableau typé. Si ces deux derniers paramètres sont absents, c'est l'ensemble de `buffer` qui sera vu ; si seul `longueur` est absent, c'est tout `buffer` qui sera vu à partir de `decalageOctets`.

Exemples
--------

### Plusieurs façons de créer un objet `Uint32Array`


```js
// À partir d'une longueur
let uint32 = new Uint32Array(2);
uint32[0] = 42;
console.log(uint32[0]); // 42
console.log(uint32.length); // 2
console.log(uint32.BYTES\_PER\_ELEMENT); // 4

// À partir d'un tableau
let arr = new Uint32Array([21, 31]);
console.log(arr[1]); // 31

// À partir d'un autre tableau typé
let x = new Uint32Array([21, 31]);
let y = new Uint32Array(x);
console.log(y[0]); // 21

// À partir d'un ArrayBuffer
let buffer = new ArrayBuffer(16);
let z = new Uint32Array(buffer, 0, 4);

// À partir d'un itérable
let iterable = (function\* () {
  yield\* [1, 2, 3];
})();
let uint32 = new Uint32Array(iterable);
// Uint32Array[1, 2, 3]
```

Spécifications
--------------

| Specification |
| --- |
| ECMAScript Language Specification # sec-typedarray-constructors |

Compatibilité des navigateurs
-----------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

### Notes de compatibilité

À partir d'ECMAScript 2015, le constructeur de `Uint32Array` doit être appelé avec l'opérateur `new`. Utiliser le constructeur `Uint32Array` comme une fonction, c'est-à-dire sans le mot-clé `new`, déclenchera désormais une exception `TypeError`.


```js
let dv = Uint32Array([1, 2, 3]);
// TypeError: calling a builtin Uint32Array constructor
// without new is forbidden
```



```js
let dv = new Uint32Array([1, 2, 3]);
```

Voir aussi
----------

* Prothèse d'émulation pour `Uint32Array` avec la bibliothèque `core-js`
* Les tableaux typés en JavaScript
* `ArrayBuffer`
* `DataView`