HOWTO · JavaScript

Quadrar um número em JavaScript

Este tutorial explica como elevar ao quadrado um número em JavaScript

Nesta página

Para elevar um valor ao quadrado em JavaScript, calcule sua segunda potência com number ** 2. Por exemplo, 5 ** 2 resulta em 25. Essa é a opção mais clara para valores comuns de Number; também é possível usar a multiplicação e Math.pow().

Eleve um valor de Number ao quadrado em JavaScript

O quadrado de um valor é o resultado de multiplicá-lo por ele mesmo. O tipo Number de JavaScript costuma ser a escolha adequada para cálculos do dia a dia, incluindo números inteiros e decimais. O exemplo independente a seguir mostra a expressão direta e exibe o resultado:

O código e os rótulos ou saídas exibidos nesta seção permanecem em inglês.

const number = 5;
console.log(number ** 2);

O valor após ** é o expoente. Use 2 para elevar ao quadrado, 3 para elevar ao cubo ou outro expoente para calcular uma potência diferente. A operação também funciona com valores negativos e fracionários de Number; por exemplo, elevar um valor negativo ao quadrado produz um resultado não negativo. Os números de JavaScript usam aritmética de ponto flutuante, portanto cálculos com valores muito grandes ou decimais de alta precisão podem não preservar todos os dígitos matemáticos.

Use o operador de exponenciação

O token ** é o operador de exponenciação, não um método. O operando à esquerda é a base e o da direita é o expoente; assim, base ** 2 expressa diretamente o cálculo do quadrado. Para uma variável, atribua o resultado da expressão como em qualquer outro cálculo:

O código e os rótulos ou saídas exibidos nesta seção permanecem em inglês.

const base = 8;
const squared = base ** 2;
console.log(squared);

Coloque a base negativa entre parênteses quando ela for escrita como literal: (-3) ** 2 eleva menos três ao quadrado. Sem os parênteses, a negação unária e a exponenciação não são agrupadas da mesma forma, e -3 ** 2 gera um erro de sintaxe. Se o valor já estiver armazenado em uma variável, value ** 2 não precisa de parênteses adicionais.

Use a multiplicação ou Math.pow()

Também é possível multiplicar um valor por ele mesmo. Essa forma pode ser fácil de ler quando se quer descrever a operação explicitamente, enquanto ** deixa o expoente visível. A função integrada mais antiga Math.pow(base, exponent) expressa a mesma relação entre base e expoente e continua sendo útil em código que adota esse estilo.

O código e os rótulos ou saídas exibidos nesta seção permanecem em inglês.

const number = 5;
const byMultiplication = number * number;
const byMathPow = Math.pow(number, 2);
console.log(byMultiplication, byMathPow);

Para valores comuns de Number, as três formas calculam uma potência usando a representação de ponto flutuante dos números de JavaScript. Escolha a notação que melhor se encaixa no código ao redor; nenhuma dessas alternativas oferece aritmética decimal exata de precisão arbitrária.

Coloque o cálculo do quadrado em uma função reutilizável

Se a mesma operação for necessária em vários lugares, coloque-a em uma função. Uma função nomeada é conveniente quando se deseja uma declaração reutilizável; uma função de seta é uma alternativa compacta, inclusive para funções de retorno de chamada. Cada exemplo abaixo define e chama uma dessas formas:

O código e os rótulos ou saídas exibidos nesta seção permanecem em inglês.

function squareNumber(value) {
  return value ** 2;
}

console.log(squareNumber(6));
const square = (value) => value ** 2;
console.log(square(6));

As duas funções recebem um valor e retornam seu quadrado. Elas não validam nem convertem a entrada, portanto quem as chama deve fornecer um valor com o comportamento numérico desejado. Por exemplo, multiplicar uma string após uma conversão implícita pode produzir resultados inesperados; quando necessário, converta e valide dados externos antes de chamar a função auxiliar.

Eleve valores BigInt ao quadrado quando a precisão de inteiros exatos for importante

Valores Number de JavaScript representam inteiros com exatidão somente até Number.MAX_SAFE_INTEGER (9,007,199,254,740,991). Se a aritmética com inteiros precisar continuar exata além desse limite, use BigInt desde o início. Acrescente o sufixo n a um literal inteiro e use o mesmo operador de exponenciação:

O código e os rótulos ou saídas exibidos nesta seção permanecem em inglês.

const largeInteger = 9007199254740993n;
const squared = largeInteger ** 2n;
console.log(squared);

O expoente de BigInt também precisa ser um BigInt, por isso o exemplo usa 2n. BigInt aceita valores inteiros, não fracionários. JavaScript não permite misturar operandos BigInt e Number em operações aritméticas: faça conversões deliberadamente quando apropriado e lembre-se de que converter um valor Number cuja precisão já foi perdida não recupera os dígitos. Use Number em cálculos numéricos comuns e BigInt quando precisar de aritmética exata com inteiros grandes.