Math.pow()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

Die statische Methode Math.pow() gibt den Wert einer Basis zurück, die zu einer Potenz erhoben wird. Das heißt

𝙼𝚊𝚝𝚑.𝚙𝚘𝚠 ( 𝚡 , 𝚢 ) = x y \mathtt{\operatorname{Math.pow}(x, y)}} = x^y

Probieren Sie es aus

Syntax

js
Math.pow(base, exponent)

Parameter

base

Die Basiszahl.

exponent

Die Exponentzahl.

Rückgabewert

Eine Zahl, die base zur Potenz von exponent repräsentiert. Gibt NaN in einem der folgenden Fälle zurück:

  • exponent ist NaN.
  • base ist NaN und exponent ist nicht 0.
  • base ist ±1 und exponent ist ±Infinity.
  • base < 0 und exponent ist keine ganze Zahl.

Beschreibung

Math.pow() ist dem ** Operator äquivalent, mit der Ausnahme, dass Math.pow() nur Zahlen akzeptiert.

Math.pow(NaN, 0) (und das äquivalente NaN ** 0) ist der einzige Fall, in dem NaN nicht durch mathematische Operationen propagiert wird — es gibt 1 zurück, obwohl der Operanden NaN ist. Darüber hinaus verhält sich das Verhalten, wenn base 1 und exponent nicht endlich ist (±Infinity oder NaN), anders als bei IEEE 754, das spezifiziert, dass das Ergebnis 1 sein sollte, während JavaScript NaN zurückgibt, um die Rückwärtskompatibilität mit seinem ursprünglichen Verhalten zu erhalten.

Da pow() eine statische Methode von Math ist, verwenden Sie es als Math.pow(), anstatt als Methode eines von Ihnen erstellten Math-Objekts (Math ist kein Konstruktor).

Beispiele

Verwendung von Math.pow()

js
// Simple cases
Math.pow(7, 2); // 49
Math.pow(7, 3); // 343
Math.pow(2, 10); // 1024

// Fractional exponents
Math.pow(4, 0.5); // 2 (square root of 4)
Math.pow(8, 1 / 3); // 2 (cube root of 8)
Math.pow(2, 0.5); // 1.4142135623730951 (square root of 2)
Math.pow(2, 1 / 3); // 1.2599210498948732 (cube root of 2)

// Signed exponents
Math.pow(7, -2); // 0.02040816326530612 (1/49)
Math.pow(8, -1 / 3); // 0.5

// Signed bases
Math.pow(-7, 2); // 49 (squares are positive)
Math.pow(-7, 3); // -343 (cubes can be negative)
Math.pow(-7, 0.5); // NaN (negative numbers don't have a real square root)
// Due to "even" and "odd" roots laying close to each other,
// and limits in the floating number precision,
// negative bases with fractional exponents always return NaN,
// even when the mathematical result is real
Math.pow(-7, 1 / 3); // NaN

// Zero and infinity
Math.pow(0, 0); // 1 (anything ** ±0 is 1)
Math.pow(Infinity, 0.1); // Infinity (positive exponent)
Math.pow(Infinity, -1); // 0 (negative exponent)
Math.pow(-Infinity, 1); // -Infinity (positive odd integer exponent)
Math.pow(-Infinity, 1.5); // Infinity (positive exponent)
Math.pow(-Infinity, -1); // -0 (negative odd integer exponent)
Math.pow(-Infinity, -1.5); // 0 (negative exponent)
Math.pow(0, 1); // 0 (positive exponent)
Math.pow(0, -1); // Infinity (negative exponent)
Math.pow(-0, 1); // -0 (positive odd integer exponent)
Math.pow(-0, 1.5); // 0 (positive exponent)
Math.pow(-0, -1); // -Infinity (negative odd integer exponent)
Math.pow(-0, -1.5); // Infinity (negative exponent)
Math.pow(0.9, Infinity); // 0
Math.pow(1, Infinity); // NaN
Math.pow(1.1, Infinity); // Infinity
Math.pow(0.9, -Infinity); // Infinity
Math.pow(1, -Infinity); // NaN
Math.pow(1.1, -Infinity); // 0

// NaN: only Math.pow(NaN, 0) does not result in NaN
Math.pow(NaN, 0); // 1
Math.pow(NaN, 1); // NaN
Math.pow(1, NaN); // NaN

Spezifikationen

Specification
ECMAScript Language Specification
# sec-math.pow

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch