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

CKTIS / JavaScript

with — instrução obsoleta de pesquisa de nomes

A instrução with inclui temporariamente um objeto na pesquisa de nomes. É proibida no modo estrito; no código novo, utiliza o acesso explícito às propriedades.

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

with (expression) statement

with é uma palavra-chave reservada. A instrução with (expression) statement acrescenta temporariamente um objeto à cadeia de ambientes utilizada para a pesquisa de nomes. Após a execução da instrução, o ambiente anterior é restaurado.

A pesquisa inclui propriedades próprias e herdadas, exceto os nomes excluídos por Symbol.unscopables. Se o objeto não disponibilizar um nome, a pesquisa continua no ambiente externo. Se a pesquisa de um nome através de with encontrar uma propriedade, a atribuição tem essa propriedade como destino e não cria uma variável local. Encontrar a propriedade não garante que a escrita seja bem-sucedida: por exemplo, fora do modo estrito, uma atribuição a uma propriedade de dados que não permite escrita pode deixar o objeto inalterado sem lançar um erro.

No modo estrito, with causa um SyntaxError durante a análise sintática. Os módulos utilizam sempre o modo estrito. A especificação desaconselha esta construção obsoleta: o significado de um nome pode depender das propriedades do objeto. Prefere data.value ou a desestruturação.

No exemplo, value += 1 altera data.value, enquanto o value externo permanece igual a 10. Executa o código como um script clássico sem a diretiva "use strict", não como um módulo.

Exemplos

(function () {
  var value = 10;
  var data = { value: 20 };
  with (data) {
    value += 1;
  }
  console.log(data.value);
  console.log(value);
})();

Resultado

21
10

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