Array.prototype.every()

Probieren Sie es aus

const isBelowThreshold = (currentValue) => currentValue < 40;

const array1 = [1, 30, 39, 29, 10, 13];

console.log(array1.every(isBelowThreshold));
// Expected output: true

Syntax

every(callbackFn)
every(callbackFn, thisArg)

Parameter

callbackFn

Eine Funktion, die fr jedes Element im Array ausgefhrt wird. Sie sollte einen truthy Wert zurckgeben, um anzuzeigen, dass das Element den Test besteht, und einen falsy Wert andernfalls. Die Funktion wird mit den folgenden Argumenten aufgerufen:

element

Das aktuelle Element, das im Array verarbeitet wird.

index

Der Index des aktuellen Elements, das im Array verarbeitet wird.

array

Das Array, auf dem every() aufgerufen wurde.

thisArg Optional

Ein Wert, der als this beim Ausfhren von callbackFn verwendet wird. Siehe iterative Methoden.

Rckgabewert

true, es sei denn, callbackFn gibt einen falsy Wert fr ein Array-Element zurck, in diesem Fall wird sofort false zurckgegeben.

Beschreibung

Die every() Methode ist eine iterative Methode. Sie ruft eine bereitgestellte callbackFn Funktion einmal fr jedes Element in einem Array auf, bis callbackFn einen falsy Wert zurckgibt. Wenn ein solches Element gefunden wird, gibt every() sofort false zurck und stoppt die Iteration durch das Array. Andernfalls, wenn callbackFn fr alle Elemente einen truthy Wert zurckgibt, gibt every() true zurck. Lesen Sie den Abschnitt zu iterativen Methoden fr weitere Informationen darber, wie diese Methoden im Allgemeinen funktionieren.

every wirkt wie der "fr alle" Quantor in der Mathematik. Insbesondere fr ein leeres Array gibt es true zurck. (Es ist vakuumweise wahr, dass alle Elemente der leeren Menge jede gegebene Bedingung erfllen.)

callbackFn wird nur fr Array-Indizes aufgerufen, die zugewiesene Werte haben. Es wird nicht fr leere Slots in sparse arrays aufgerufen.

Die every() Methode ist generisch. Sie erwartet nur, dass der this Wert eine length Eigenschaft und ganzzahlig indizierte Eigenschaften hat.

Beispiele

Testen der Gre aller Array-Elemente

Das folgende Beispiel prft, ob alle Elemente im Array 10 oder grer sind.

function isBigEnough(element, index, array) {
  return element >= 10;
}
[12, 5, 8, 130, 44].every(isBigEnough); // false
[12, 54, 18, 130, 44].every(isBigEnough); // true

Prfen, ob ein Array eine Teilmenge eines anderen Arrays ist

Das folgende Beispiel prft, ob alle Elemente eines Arrays in einem anderen Array vorhanden sind.

const isSubset = (array1, array2) =>
  array2.every((element) => array1.includes(element));

console.log(isSubset([1, 2, 3, 4, 5, 6, 7], [5, 7, 6])); // true
console.log(isSubset([1, 2, 3, 4, 5, 6, 7], [5, 8, 7])); // false

Verwenden des dritten Arguments von callbackFn

Das array Argument ist ntzlich, wenn Sie auf ein anderes Element im Array zugreifen mchten. Das folgende Beispiel verwendet zuerst filter(), um die positiven Werte zu extrahieren, und dann every(), um zu berprfen, ob das Array streng zunehmend ist.

const numbers = [-2, 4, -8, 16, -32];
const isIncreasing = numbers
  .filter((num) => num > 0)
  .every((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 true;
    return num > arr[idx - 1];
  });
console.log(isIncreasing); // true

Verwenden von every() auf sprlichen Arrays

every() wird seinen Prdikat nicht auf leere Slots anwenden.

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

Aufruf von every() auf Nicht-Array-Objekten

Die every() Methode liest die length Eigenschaft von this und greift dann auf jede Eigenschaft mit einem nicht negativen Ganzzahlenschlssel zu, der kleiner als length ist, bis sie alle zugegriffen wurden oder callbackFn false zurckgibt.

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

Spezifikationen

Browser-Kompatibilitt

Siehe auch

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