Skip to content

useNumericSeparators

¥Summary

¥How to configure

biome.json
{
"linter": {
"rules": {
"style": {
"useNumericSeparators": "error"
}
}
}
}

¥Description

强制在数值字面量中使用数字分隔符。

¥Enforce the use of numeric separators in numeric literals.

强制使用 数字分隔符 对数字进行分组。过长的数字难以阅读,因此使用下划线 (_) 分隔数字组可以提高代码清晰度。此规则还通过检查数字组的大小是否正确来强制执行数字分隔符的正确使用。

¥Enforces a convention of grouping digits using numeric separators. Long numbers can become difficult to read, so separating groups of digits with an underscore (_) improves code clarity. This rule also enforces proper usage of the numeric separator, by checking if the groups of digits are of the correct size.

¥Examples

¥Invalid

var a = 1234567890;
code-block.js:1:9 lint/style/useNumericSeparators  FIXABLE  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Long numeric literal lacks separators.

> 1 │ var a = 1234567890;
^^^^^^^^^^
2 │

Adding separators helps improve readability and clarity for long numbers.

Safe fix: Add numeric separators.

1 - var·a·=·1234567890;
1+ var·a·=·1_234_567_890;
2 2

var a = -999_99;
code-block.js:1:10 lint/style/useNumericSeparators  FIXABLE  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Inconsistent grouping of digits in numeric literal.

> 1 │ var a = -999_99;
^^^^^^
2 │

Numbers with inconsistently placed separators can be misleading or confusing.

Safe fix: Use consistent numeric separator grouping.

1 - var·a·=·-999_99;
1+ var·a·=·-99_999;
2 2

var a = 0.1234567;
code-block.js:1:9 lint/style/useNumericSeparators  FIXABLE  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Long numeric literal lacks separators.

> 1 │ var a = 0.1234567;
^^^^^^^^^
2 │

Adding separators helps improve readability and clarity for long numbers.

Safe fix: Add numeric separators.

1 - var·a·=·0.1234567;
1+ var·a·=·0.123_456_7;
2 2

var a = 0b11001100;
code-block.js:1:9 lint/style/useNumericSeparators  FIXABLE  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Long numeric literal lacks separators.

> 1 │ var a = 0b11001100;
^^^^^^^^^^
2 │

Adding separators helps improve readability and clarity for long numbers.

Safe fix: Add numeric separators.

1 - var·a·=·0b11001100;
1+ var·a·=·0b1100_1100;
2 2

¥Valid

var a = 1_234_567_890;
var a = -99_999;
var a = 0.123_456_7;
var a = 0b1100_1100;

¥Related links