Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / JavaScript

Number.EPSILON: espaçamento entre números perto de 1

Number.EPSILON é a diferença entre 1 e o menor Number representável superior a 1, igual a 2^-52.

Versão: ECMAScript 2015 onward; example target: Node.js 24.22.2

Sintaxe

Number.EPSILON

Number.EPSILON tem o valor exato 2 ** -52, aproximadamente 2.220446049250313e-16: é a diferença entre 1 e o menor Number representável superior a 1. O espaçamento imediatamente abaixo de 1 é 2 ** -53, pelo que epsilon não é simétrico em torno de 1. Ajuda a exprimir tolerância ao arredondamento, como quando 0.1 + 0.2 não é exatamente 0.3, e não é o menor Number positivo; esse é Number.MIN_VALUE.

O espaçamento entre números representáveis cresce com o expoente, pelo que Math.abs(a - b) < Number.EPSILON isoladamente não é uma comparação universal. Para valores de escala semelhante, epsilon pode ser multiplicado por Math.max(1, Math.abs(a), Math.abs(b)) e por um fator de segurança; medições ou regras financeiras precisam de tolerância própria do domínio. Valores muito pequenos podem exigir um limiar absoluto separado.

A propriedade existe desde ECMAScript 2015 e não é gravável, enumerável nem configurável. O exemplo define um teste nearlyEqual escalado que aceita o erro habitual de 0.1 + 0.2 e verifica o valor exato e o descritor. Uma atribuição não altera Number.EPSILON e pode lançar TypeError em código strict.

Exemplos

const nearlyEqual = (a, b, factor = 4) =>
  Math.abs(a - b) <= Number.EPSILON * factor * Math.max(1, Math.abs(a), Math.abs(b));

const total = 0.1 + 0.2;
console.log(total === 0.3, nearlyEqual(total, 0.3));
console.log(Number.EPSILON === 2 ** -52);
const descriptor = Object.getOwnPropertyDescriptor(Number, "EPSILON");
console.log(descriptor.writable, descriptor.enumerable, descriptor.configurable);

Resultado

false true
true
false false false

Number.EPSILON → comparação escalada, 2^-52 exato e descritor não gravável

Fontes