TypedArray.prototype.indexOf()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2016.

La méthode indexOf() renvoie le premier indice (le plus petit) auquel on peut trouver un élément donné dans le tableau typé. Si l'élément n'est pas trouvé, la valeur de retour sera -1. L'algorithme utilisé pour cette méthode est le même que celui pour Array.prototype.indexOf(). Pour le reste de l'article TypedArray correspond à l'un des types de tableau typé.

Exemple interactif

const uint8 = new Uint8Array([10, 20, 30, 40, 50]);

console.log(uint8.indexOf(50));
// Expected output: 4

// From position 3
console.log(uint8.indexOf(20, 3));
// Expected output: -1

console.log(uint8.indexOf(51));
// Expected output: -1

Syntaxe

js
typedarray.indexOf(élémentRecherché[, indiceDébut = 0])

Paramètres

élémentRecherché

L'élément qu'on souhaite situer dans le tableau typé.

indiceDébut

Paramètre optionnel représentant l'indice à partir duquel commencer la recherche de l'élément. Si l'indice est supérieur ou égal à la longueur du tableau, la méthode renverra -1 et le tableau typé ne sera pas parcouru. Si la valeur fournie est négative, la recherche commencera à partir de l'élément situé à l'indice length-indiceDébut. Note : même si la valeur fournie est négative, le parcours du tableau typé s'effectuera toujours du plus petit index vers le plus grand. Si la valeur calculée pour l'indice de début est inférieure à 0, l'ensemble du tableau typé sera parcouru. La valeur par défaut de ce paramètre est 0 (tout le tableau est parcouru).

Valeur de retour

Le premier indice du tableau pour lequel l'élément a été trouvé, -1 s'il n'a pas été trouvé.

Description

indexOf compare élémentRecherché aux éléments du tableau typé en utilisant l'égalité stricte (celle utilisée par l'opérateur ===).

Exemples

js
var uint8 = new Uint8Array([2, 5, 9]);
uint8.indexOf(2); // 0
uint8.indexOf(7); // -1
uint8.indexOf(9, 2); // 2
uint8.indexOf(2, -1); // -1
uint8.indexOf(2, -3); // 0

Spécifications

Specification
ECMAScript® 2025 Language Specification
# sec-%typedarray%.prototype.indexof

Compatibilité des navigateurs

BCD tables only load in the browser

Voir aussi