CKTIS / JavaScript
Number.prototype.toPrecision: dígitos significativos
toPrecision devuelve texto con la cantidad solicitada de dígitos significativos, en notación fija o exponencial.
Versión: ECMAScript 3 onward; example target: Node.js 24.22.2
Sintaxis
number.toPrecision(precision)number.toPrecision(precision) formatea el valor con precision dígitos significativos. Si se omite el argumento o es undefined, el método devuelve de inmediato el resultado ToString normal del número. Un argumento proporcionado pasa por ToIntegerOrInfinity: la fracción se trunca hacia cero y NaN se vuelve 0; para un receptor finito, un resultado fuera de 1..100 lanza RangeError.
Después de convertir un argumento proporcionado, un receptor NaN o ±Infinity devuelve su texto normal antes de comprobar el rango, por lo que Infinity.toPrecision(0) da "Infinity". Sin embargo, un objeto usado como precision puede lanzar durante la conversión. Para un valor finito se usa notación exponencial si el exponente decimal es menor que -6 o al menos precision; en otro caso se usa notación fija. Se redondea al resultado más cercano y, en empate tras separar el signo, a la mayor magnitud.
El método existe desde ECMAScript 3, no es genérico y lanza TypeError si el receptor no es Number ni un Number envuelto. Devuelve texto, no un número. Number usa representación binaria y el redondeo puede sorprender; usa Intl.NumberFormat para presentación local.
Ejemplos
console.log((1234.5).toPrecision(4), (1234.5).toPrecision(3));
console.log((0.0000012345).toPrecision(3), (0.00000012345).toPrecision(3));
console.log((7).toPrecision(), (-0).toPrecision(3));
console.log(Infinity.toPrecision(0));
try { console.log((1).toPrecision(0)); } catch (error) { console.log(error.name); }
try { Number.prototype.toPrecision.call("1", 2); } catch (error) { console.log(error.name); }Resultado
1235 1.23e+3 0.00000123 1.23e-7 7 0.00 Infinity RangeError TypeError
El ejemplo compara notación fija y exponencial y muestra -0, Infinity y errores de rango/receptor.