WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Math.max: größter Wert

Math.max wandelt jedes Argument in Number um und liefert den größten entstandenen Wert.

Version: ECMAScript 1 onward; example target: Node.js 24.22.2

Syntax

Math.max(...args)

Math.max(...args) wendet zunächst der Reihe nach ToNumber auf alle Argumente an und wählt danach den größten Wert. Ohne Argumente liefert die Funktion -Infinity, das neutrale Element der Maximumsuche. Ist ein umgewandeltes Argument NaN, ist das Ergebnis NaN; alle Umwandlungen erfolgen jedoch vor diesem Test.

Numerische Zeichenketten und andere umwandelbare Werte werden akzeptiert, Symbol oder BigInt löst TypeError aus. Objekte können valueOf oder toString ausführen; ein Umwandlungsfehler bricht den Aufruf ab. Zwischen den beiden Nullwerten gilt +0 als größer als -0; Infinity ist größer als jede endliche Number.

Die Funktion existiert seit ECMAScript 1 und ist kein Konstruktor. Für kleine Arrays ist Math.max(...values) praktisch. Sehr große Sammlungen nicht verteilen, da Argumentgrenzen engineabhängig sind; Schleife oder reduce verwenden und leere Eingabe sowie NaN bewusst behandeln.

Beispiele

const scores = [-4, 12, 7];
console.log(Math.max(...scores));
console.log(Math.max(), Number.isNaN(Math.max(3, undefined)));
console.log(Object.is(Math.max(-0, +0), +0));
console.log(Math.max("6", 2));
try { Math.max(1n, 2); } catch (error) { console.log(error instanceof TypeError); }
const seen = [];
const a = { valueOf() { seen.push("a"); return NaN; } };
const b = { valueOf() { seen.push("b"); return 4; } };
console.log(Number.isNaN(Math.max(a, b)), seen.join(","));

Ergebnis

12
-Infinity true
true
6
true
true a,b

Math.max → 12 and ordered coercion a,b

Quellen