Array.prototype.some()

Probieren Sie es aus

const array = [1, 2, 3, 4, 5];

// Checks whether an element is even
const even = (element) => element % 2 === 0;

console.log(array.some(even));
// Expected output: true

Syntax

some(callbackFn)
some(callbackFn, thisArg)

Parameter

callbackFn

Eine Funktion, die für jedes Element im Array ausgeführt wird. Sie sollte einen truthy-Wert zurückgeben, wenn das Element die Prüfung besteht, andernfalls einen falsy-Wert. Die Funktion wird mit den folgenden Argumenten aufgerufen:

element

Das aktuell verarbeitete Element im Array.

index

Der Index des aktuell verarbeiteten Elements im Array.

array

Das Array, für das some() aufgerufen wurde.

thisArg Optional

Ein Wert, der bei der Ausführung von callbackFn als this verwendet wird. Siehe iterative Methoden.

Rückgabewert

false, es sei denn, callbackFn gibt für ein Array-Element einen truthy-Wert zurück. In diesem Fall wird sofort true zurückgegeben.

Beschreibung

Die Methode some() ist eine iterative Methode. Sie ruft die bereitgestellte Funktion callbackFn einmal für jedes Element eines Arrays auf, bis callbackFn einen truthy-Wert zurückgibt. Wird ein solches Element gefunden, gibt some() sofort true zurück und beendet die Iteration durch das Array. Gibt callbackFn hingegen für alle Elemente einen falsy-Wert zurück, gibt some() false zurück. Weitere Informationen zur allgemeinen Funktionsweise dieser Methoden finden Sie im Abschnitt über iterative Methoden.

some() verhält sich wie der Existenzquantor („es gibt“) in der Mathematik. Insbesondere gibt die Methode für ein leeres Array unabhängig von der Bedingung false zurück.

callbackFn wird nur für Array-Indizes aufgerufen, denen Werte zugewiesen wurden. Für leere Einträge in Sparse Arrays wird die Funktion nicht aufgerufen.

some() verändert das Array, für das die Methode aufgerufen wird, nicht. Die als callbackFn bereitgestellte Funktion kann das Array jedoch verändern. Beachten Sie allerdings, dass die Länge des Arrays vor dem ersten Aufruf von callbackFn gespeichert wird. Daher gilt:

• callbackFn verarbeitet keine Elemente, die nach Beginn des Aufrufs von some() über die ursprüngliche Länge des Arrays hinaus hinzugefügt werden.
• Änderungen an bereits besuchten Indizes führen nicht dazu, dass callbackFn für diese erneut aufgerufen wird.
• Wenn callbackFn ein vorhandenes, aber noch nicht besuchtes Element des Arrays verändert, wird der Wert an callbackFn übergeben, den das Element zum Zeitpunkt des Besuchs hat. Gelöschte Elemente werden nicht besucht.

Die Methode some() ist generisch. Sie setzt lediglich voraus, dass der Wert von this eine length-Eigenschaft und Eigenschaften mit ganzzahligen Schlüsseln besitzt.

Beispiele

Werte von Array-Elementen prüfen

Das folgende Beispiel prüft, ob ein Element im Array größer als 10 ist.

function isBiggerThan10(element, index, array) {
  return element > 10;
}

[2, 5, 8, 1, 4].some(isBiggerThan10); // false
[12, 5, 8, 1, 4].some(isBiggerThan10); // true

Array-Elemente mit Arrow Functions prüfen

Arrow Functions bieten eine kürzere Syntax für dieselbe Prüfung.

[2, 5, 8, 1, 4].some((x) => x > 10); // false
[12, 5, 8, 1, 4].some((x) => x > 10); // true

Prüfen, ob ein Wert in einem Array vorhanden ist

Die folgende benutzerdefinierte Funktion ahmt die Funktionalität der Methode includes() nach und gibt true zurück, wenn das Element im Array vorhanden ist:

const fruits = ["apple", "banana", "mango", "guava"];

function checkAvailability(arr, val) {
  return arr.some((arrVal) => val === arrVal);
}

checkAvailability(fruits, "grapefruit"); // false
checkAvailability(fruits, "banana"); // true

Einen beliebigen Wert in einen Boolean-Wert umwandeln

const TRUTHY_VALUES = [true, "true", 1];

function getBoolean(value) {
  if (typeof value === "string") {
    value = value.toLowerCase().trim();
  }

  return TRUTHY_VALUES.some((t) => t === value);
}

getBoolean(false); // false
getBoolean("false"); // false
getBoolean(1); // true
getBoolean("true"); // true

Das dritte Argument von callbackFn verwenden

Das Argument array ist nützlich, wenn Sie auf ein anderes Element im Array zugreifen möchten, insbesondere wenn keine Variable vorhanden ist, die auf das Array verweist. Im folgenden Beispiel werden zunächst mit filter() die positiven Werte extrahiert. Anschließend wird mit some() geprüft, ob das Array streng monoton steigend ist.

const numbers = [3, -1, 1, 4, 1, 5];
const isIncreasing = !numbers
  .filter((num) => num > 0)
  .some((num, idx, arr) => {
    // Without the arr argument, there's no way to easily access the
    // intermediate array without saving it to a variable.
    if (idx === 0) return false;
    return num <= arr[idx - 1];
  });
console.log(isIncreasing); // false

some() auf Sparse Arrays anwenden

some() führt die Prüffunktion nicht für leere Einträge aus.

console.log([1, , 3].some((x) => x === undefined)); // false
console.log([1, , 1].some((x) => x !== 1)); // false
console.log([1, undefined, 1].some((x) => x !== 1)); // true

some() für Objekte aufrufen, die keine Arrays sind

Die Methode some() liest die Eigenschaft length von this und greift dann auf jede Eigenschaft zu, deren Schlüssel eine nicht negative ganze Zahl kleiner als length ist, bis auf alle diese Eigenschaften zugegriffen wurde oder callbackFn true zurückgibt.

const arrayLike = {
  length: 3,
  0: "a",
  1: "b",
  2: "c",
  3: 3, // ignored by some() since length is 3
};
console.log(Array.prototype.some.call(arrayLike, (x) => typeof x === "number"));
// false

Spezifikationen

Browser-Kompatibilität

Siehe auch

• Polyfill für Array.prototype.some in core-js
• Polyfill für Array.prototype.some von es-shims
• Leitfaden zu indizierten Sammlungen
• Array
• Array.prototype.every()
• Array.prototype.forEach()
• Array.prototype.find()
• Array.prototype.includes()
• TypedArray.prototype.some()