Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

with — instruction obsolète de recherche de noms

L’instruction with inclut temporairement un objet dans la recherche de noms. Elle est interdite en mode strict ; dans le nouveau code, utilisez un accès explicite aux propriétés.

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

Syntaxe

with (expression) statement

with est un mot-clé réservé. L’instruction with (expression) statement ajoute temporairement un objet à la chaîne d’environnements utilisée pour la recherche de noms. Une fois l’instruction exécutée, l’environnement précédent est rétabli.

La recherche porte sur les propriétés propres et héritées, à l’exception des noms exclus par Symbol.unscopables. Si l’objet ne fournit pas un nom, la recherche se poursuit dans l’environnement externe. Si la recherche d’un nom via with trouve une propriété, l’affectation cible cette propriété et ne crée pas de variable locale. Trouver la propriété ne garantit toutefois pas que l’écriture réussisse : hors du mode strict, par exemple, une affectation à une propriété de données non modifiable peut laisser l’objet inchangé sans lever d’erreur.

En mode strict, with provoque une SyntaxError lors de l’analyse syntaxique. Les modules utilisent toujours le mode strict. La spécification déconseille cette construction ancienne : le sens d’un nom peut dépendre des propriétés de l’objet. Préférez data.value ou la déstructuration.

Dans l’exemple, value += 1 modifie data.value, tandis que la variable externe value reste égale à 10. Exécutez le code comme un script classique sans directive "use strict", et non comme un module.

Exemples

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

Résultat

21
10

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources