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) statementwith é 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.