W3cubDocs

/JavaScript

Math.cbrt

The Math.cbrt() function returns the cube root of a number, that is

Math.cbrt(x)=x3=the uniqueysuch thaty3=x\mathtt{Math.cbrt(x)} = \sqrt[3]{x} = \text{the unique} \; y \; \text{such that} \; y^3 = x

Syntax

Math.cbrt(x)

Parameters

x
A number.

Return value

The cube root of the given number.

Description

Because cbrt() is a static method of Math, you always use it as Math.cbrt(), rather than as a method of a Math object you created (Math is not a constructor).

Polyfill

For all x0x \geq 0, have x3=x1/3\sqrt[3]{x} = x^{1/3} so this can be emulated by the following function:

if (!Math.cbrt) {
  Math.cbrt = (function(pow) {
    return function cbrt(x){
      // ensure negative numbers remain negative:
      return x < 0 ? -pow(-x, 1/3) : pow(x, 1/3);
    };
  })(Math.pow); // localize Math.pow to increase efficiency
}

Examples

Using Math.cbrt()

Math.cbrt(NaN); // NaN
Math.cbrt(-1); // -1
Math.cbrt(-0); // -0
Math.cbrt(-Infinity); // -Infinity
Math.cbrt(0); // 0
Math.cbrt(1); // 1
Math.cbrt(Infinity); // Infinity
Math.cbrt(null); // 0
Math.cbrt(2);  // 1.2599210498948732

Specifications

Browser compatibilityUpdate compatibility data on GitHub

and send us a pull request.
Desktop
Chrome Edge Firefox Internet Explorer Opera Safari
cbrt 38 12 25 No 25 8
Mobile
Android webview Chrome for Android Firefox for Android Opera for Android Safari on iOS Samsung Internet
cbrt 38 38 25 25 8 3.0
Server
Node.js
cbrt 0.12

See also

© 2005–2018 Mozilla Developer Network and individual contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://wiki.developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Math/cbrt