CKTIS / JavaScript
Math.abs: absolutní hodnota
Math.abs převede argument na Number a vrátí nezápornou absolutní hodnotu s daným chováním pro nulu, NaN a nekonečna.
Verze: ECMAScript 1 onward; example target: Node.js 24.22.2
Syntaxe
Math.abs(x)Math.abs(x) použije ToNumber na x a vrátí velikost. Konečná záporná hodnota se změní na kladnou, kladná zůstane, -0 i +0 dají +0. -Infinity dá Infinity a NaN zůstane NaN.
Převod je důležitý: Math.abs("-3.5") je 3.5, Math.abs(null) je 0 a bez argumentu undefined vytvoří NaN. Objekt může spustit valueOf či toString s vedlejšími účinky nebo výjimkou. Symbol a BigInt vyvolají TypeError.
Funkce není konstruktor a je standardní od ECMAScript 1. Použijte ji pro vzdálenost od nuly či Math.abs(a - b); pro vícerozměrnou délku slouží Math.hypot. Výsledek zůstává Number s limity IEEE 754.
Příklady
console.log(Math.abs(-12.5), Math.abs("-3"), Math.abs(null));
console.log(Object.is(Math.abs(-0), 0), Math.abs(-Infinity));
console.log(Number.isNaN(Math.abs()), Number.isNaN(Math.abs("not-number")));
const reading = { valueOf() { return -9; } };
console.log(Math.abs(reading));
try { Math.abs(1n); } catch (error) { console.log(error instanceof TypeError); }Výsledek
12.5 3 0 true Infinity true true 9 true