prefer-modern-math-apis.md

Prefer modern Math APIs over legacy patterns

💼 This rule is enabled in the following configs: ✅ recommended, ☑️ unopinionated.

🔧 This rule is automatically fixable by the --fix CLI option.

Math additions in ES2015:

• Math.sign()
• Math.trunc()
• Math.cbrt()
• Math.expm1()
• Math.log1p()
• Math.log10()
• Math.log2()
• Math.sinh()
• Math.cosh()
• Math.tanh()
• Math.asinh()
• Math.acosh()
• Math.atanh()
• Math.hypot()
• Math.clz32()
• Math.imul()
• Math.fround()

Currently, we only check a few known cases, but we are open to add more patterns.

If you find a suitable case for this rule, please open an issue.

Examples

// ❌
Math.log(x) * Math.LOG10E

// ❌
Math.LOG10E * Math.log(x)

// ❌
Math.log(x) / Math.LN10

// ✅
Math.log10(x)

// ❌
Math.log(x) * Math.LOG2E

// ❌
Math.LOG2E * Math.log(x)

// ❌
Math.log(x) / Math.LN2

// ✅
Math.log2(x)

// ❌
Math.sqrt(a * a + b * b)

// ❌
Math.sqrt(a ** 2 + b ** 2)

// ✅
Math.hypot(a, b)

// ❌
Math.sqrt(x ** 2)

// ✅
Math.abs(x)

Separate rule for Math.trunc()

See unicorn/prefer-math-trunc rule.