Chama-se numeric separator ou, em português, separador numérico. Foi estandardizado no ECMAScript 2021. Veja o repositório com a proposta e discussões. E a seção § 12.8.3 da especificação.
É um recurso que extende a notação para literais numéricos em JavaScript, o que inclui valores do tipo number
em representação numérica decimal (a usual), binária, octal e hexadecimal. Também pode ser utilizado no tipo numérico bigint
. O objetivo é meramente estético para facilitar a leitura, que é certamente beneficiada em longas sequências numéricas.
Alguns exemplos com o tipo numérico:
0b111_111; // Binário. Avalia para: 63
0o777_777; // Octal. Avalia para: 262143
1_000_000; // Decimal. Avalia para: 1000000
0xfff_fff; // Hexadecimal. Avalia para: 16777215
E com bigint (denotados por n
ao final):
1000000n; // Ou:
1_000_000n;
O local em que o underscore será posicionado não é definido. Você pode colocá-lo entre quaisquer dígitos do literal numérico. No entanto, existem três exceções notáveis:
- Não podem haver dois underscores seguidos.
- Não pode estar adjacente ao caractere (
b
para binário, o
para octal e x
para hexadecimal) que denota número com base numérica literal explícita.
- Não pode estar adjacente ao separador decimal (
.
).
- Não pode estar adjacente ao sufixo
n
, que denota bigints literais.
Desse modo, os seguintes causam erro de sintaxe:
1__000; // SyntaxError (dois underscores seguidos)
0b_111; // SyntaxError (adjacente ao prefixo de base binária)
0o_777; // SyntaxError (adjacente ao prefixo de base octal)
0x_fff; // SyntaxError (adjacente ao prefixo de base hexadecimal)
12._34; // SyntaxError (adjacente ao separador decimal)
1000_n; // SyntaxError (adjacente ao sufixo de bigint literal)
A definição formal da sintaxe pode ser consultada aqui. Consulte a tabela de compatibilidade para saber quais navegadores suportam sem transpilação.
Sobre conversões
Vale lembrar que os numeric separators são um recurso meramente sintático da linguagem. Nada muda no quesito de como os números são representados internamente, como são convertidos (de string para número, por exemplo) e/ou parseados.
Por conta disso, você não pode fazer isto e esperar que dê certo:
parseInt('1_000', 10); //-> 1
Mais informações.
E nem isto:
Number('1_000'); //-> NaN
Em tese, o construtor Number
tenta "converter" um valor para o tipo numérico. Mas o JavaScript não entende strings com o separador numérico como números válidos. Por isso NaN
é retornado na expressão abaixo:
10_000 - '10_000'; //-> `NaN`
- A expressão acima avalia para
NaN
porque o operador -
tenta converter os dois operandos para o tipo numérico (caso não estejam). Internamente, um algoritmo similar ao construtor Number
é utilizado. Desse modo, como Number('10_000')
é NaN
, 10_000 - NaN
só pode ser NaN
. Mais detalhes aqui.
- Funciona no outro exemplo da pergunta (
10_000 - '10000'
) porque o JavaScript consegue converter a string 10000
para número. Já a string '10_000'
, como vimos acima, não é "entendida" pelo algoritmo de conversão – ainda bem.
Em suma, entenda a proposta de separadores numéricas, que hoje já faz parte da linguagem, como algo exclusivo para o aspecto do código, isto é, sua sintaxe. Não é algo que trouxe nenhuma "alteração" muito profunda...
_
é um separador válido de literais numéricos. tc39.es/ecma262/#prod-NumericLiteralSeparator