Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / JavaScript

var — declaração de variável

A palavra-chave `var` declara uma variável cujo âmbito não se limita a um bloco comum. Uma nova ligação tem normalmente o valor inicial `undefined`, mas uma ligação distinta no corpo de uma função pode receber, em vez disso, o valor de um parâmetro com o mesmo nome. Uma declaração sem inicializador não altera o valor de uma ligação existente. Um inicializador só atribui um valor quando a execução chega à declaração.

Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaxe

var name;
var name = expression;
var first = expression, second = expression;

var é uma palavra-chave reservada que declara variáveis; não pode ser usada como nome de variável. Uma declaração pode não ter inicializador ou incluir várias variáveis separadas por vírgulas.

Um bloco comum no corpo de uma função não limita o âmbito de var: uma variável declarada num bloco if continua acessível fora desse bloco, na mesma função. Já uma variável declarada com var num bloco de inicialização estática de uma classe tem um âmbito limitado a esse bloco, mesmo que a classe seja declarada dentro de uma função. No nível superior, o âmbito depende do contexto, por exemplo, de se tratar de um script ou de um módulo.

As ligações de var estão disponíveis antes de serem executadas as instruções no seu âmbito. Este comportamento chama-se hoisting; não significa que o código seja movido fisicamente. Uma nova ligação é normalmente inicializada com undefined. Uma declaração com var também pode reutilizar uma ligação existente, como a de um parâmetro com o mesmo nome numa função com uma lista simples de parâmetros. Com function f(x) { var x; return x; }, f(7) devolve 7, não undefined. Já um parâmetro com um valor predefinido pode levar à criação de uma ligação distinta no corpo da função, inicializada com o valor do parâmetro com o mesmo nome. Com function f(x = 7) { var x; return x; }, f() devolve 7: a ligação no corpo da função recebe inicialmente o valor do parâmetro, mas é distinta da ligação do parâmetro. O inicializador de uma declaração com var só atribui o valor quando a execução chega à declaração.

É permitido voltar a declarar a mesma variável com var; sem inicializador, o valor não é reposto. Ao contrário de var, let e const têm âmbito de bloco e não podem ser lidos antes da inicialização. Não parta do princípio de que substituir estas palavras-chave preserva o comportamento do programa.

Exemplos

function demo() {
  console.log(value);
  if (true) {
    var value = 7;
  }
  var value;
  console.log(value);
}

demo();

Resultado

undefined
7

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes