CKTIS / JavaScript
Math.max: največja vrednost
Math.max pretvori vsak argument v Number in vrne največjo od nastalih vrednosti.
Različica: ECMAScript 1 onward; example target: Node.js 24.22.2
Sintaksa
Math.max(...args)Math.max(...args) najprej po vrsti uporabi ToNumber za vse argumente, nato izbere največji rezultat. Brez argumentov vrne -Infinity, nevtralni element pri iskanju maksimuma. Če je katera pretvorjena vrednost NaN, je rezultat NaN; vse pretvorbe se vendarle izvedejo pred tem preizkusom.
Številske nize in druge pretvorljive vrednosti sprejme, Symbol ali BigInt pa sproži TypeError. Objekti lahko izvedejo valueOf ali toString, napaka pretvorbe pa klic prekine. Med ničlama velja +0 za večjo od -0; Infinity presega vsak končni Number.
Funkcija obstaja od ECMAScript 1 in ni konstruktor. Za majhno polje je praktično Math.max(...values). Zelo velike zbirke ne razširjajte, ker je omejitev argumentov odvisna od pogona; uporabite zanko ali reduce in določite obravnavo praznega vhoda ter NaN.
Primeri
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(","));Rezultat
12 -Infinity true true 6 true true a,b
Math.max → 12 and ordered coercion a,b