Iterator : méthode some()

Baseline 2025

Nouvellement disponible

Depuis March 2025, cette fonctionnalité fonctionne sur les appareils et les versions de navigateur les plus récents. Elle peut ne pas fonctionner sur les appareils ou navigateurs plus anciens.

La méthode some() des instances de Iterator est similaire à Array.prototype.some() : elle retourne true si elle trouve un élément qui satisfait la fonction de test fournie. Sinon, si l'itérateur est épuisé sans trouver un tel élément, elle retourne false.

Dans cet article

Syntaxe

some(callbackFn)

Paramètres

callbackFn

Une fonction à exécuter pour chaque élément produit par l'itérateur. Elle doit retourner une valeur équivalente à vrai pour indiquer que l'élément passe le test, et une valeur équivalente à faux sinon. La fonction est appelée avec les arguments suivants :

element

L'élément courant en cours de traitement.

index

L'indice de l'élément courant en cours de traitement.

Valeur de retour

true si la fonction de rappel retourne une valeur équivalente à vrai pour au moins un élément. Sinon, false.

Description

some() parcourt l'itérateur et invoque la fonction callbackFn une fois pour chaque élément. Elle retourne true immédiatement si la fonction de rappel retourne une valeur équivalente à vrai. Sinon, elle itère jusqu'à la fin de l'itérateur et retourne false. Si some() retourne true, l'itérateur sous-jacent est fermé en appelant sa méthode return().

L'avantage principal des objets d'aide à l'itérateur par rapport aux méthodes de tableau est qu'ils sont paresseux, ce qui signifie qu'ils ne produisent la valeur suivante que lorsqu'elle est demandée. Cela évite les calculs inutiles et permet également de les utiliser avec des itérateurs infinis. Avec des itérateurs infinis, some() retourne true dès que la première valeur équivalente à vrai est trouvée. Si callbackFn retourne toujours une valeur équivalente à faux, la méthode ne se termine jamais.

Exemples

Utiliser la méthode some()

js
function* fibonacci() {
  let actuel = 1;
  let suivant = 1;
  while (true) {
    yield actuel;
    [actuel, suivant] = [suivant, actuel + suivant];
  }
}

const estPair = (x) => x % 2 === 0;
console.log(fibonacci().some(estPair)); // true

const estNegatif = (x) => x < 0;
console.log(fibonacci().take(10).some(estNegatif)); // false
console.log(fibonacci().some(estNegatif)); // Ne se termine jamais

L'appel à some() ferme toujours l'itérateur sous-jacent, même si la méthode retourne tôt. L'itérateur ne reste jamais dans un état intermédiaire.

js
const seq = fibonacci();
console.log(seq.some(estPair)); // true
console.log(seq.next()); // { value: undefined, done: true }

Prothèse d'émulation de Iterator.prototype.some dans core-js (angl.)
Prothèse d'émulation es-shims de Iterator.prototype.some (angl.)
L'objet Iterator
La méthode Iterator.prototype.every()
La méthode Iterator.prototype.find()
La méthode Array.prototype.some()

Aider à améliorer MDN

Cette page vous a-t-elle été utile ?

Oui Non

Apprendre à contribuer

Cette page a été modifiée le 2 mars 2026 par les contributeur·ice·s du MDN.

Voir cette page sur GitHub • Signaler un problème avec ce contenu

Objets natifs standards
Iterator
Constructeur
1. Iterator()
Méthodes statiques
Méthodes d'instance
Héritage
Object/Function
Méthodes statiques
Propriétés statiques
Méthodes d'instance
Propriétés d'instance
1. Object.prototype.__proto__
2. Object.prototype.constructor