Fonctionnalits dprcies et obsoltes

Fonctionnalits dprcies

Ces fonctionnalits dprcies peuvent encore tre utilises, mais doivent tre utilises avec prudence, car elles ne sont pas obligatoirement implmentes par tous les moteurs JavaScript. Vous devez travailler les supprimer de votre code.

Certaines de ces fonctionnalits dprcies sont listes dans la section Annexe B (angl.) de la spcification ECMAScript. Cette section est dcrite comme normative optionnelle c'est--dire que les navigateurs web doivent implmenter ces fonctionnalits, tandis que les htes non web peuvent ne pas le faire. Ces fonctionnalits sont probablement stables, car les supprimer provoque des problmes de compatibilit ascendante et casse les sites web existants. (JavaScript a pour objectif de conception de  ne pas casser le web .) Cependant, elles ne sont pas portables sur toutes les plateformes et peuvent ne pas tre prises en charge par tous les outils d'analyse, il est donc conseill de ne pas les utiliser, comme l'introduction de l'Annexe B l'indique :

Toutes les fonctionnalits et tous les comportements du langage dcrits dans la prsente annexe prsentent une ou plusieurs caractristiques indsirables et, en l'absence d'usage historique, sont supprims de la prsente spcification.

Les programmeureuses ne doivent pas utiliser ou supposer l'existence de ces fonctionnalits et comportements lors de l'criture de nouveau code ECMAScript.

Certaines autres, bien que dans le corps principal de la spcification, sont galement marques comme normatives optionnelles et ne doivent pas tre utilises de manire dpendante.

Commentaires HTML

Le code source JavaScript, s'il est analys comme des scripts, permet des commentaires de type HTML, comme si le script fait partie d'une balise <script>.

Le code suivant est un JavaScript valide lorsqu'il est excut dans un navigateur web (ou Node.js, qui utilise le moteur V8 de Chrome) :

<!-- commentaire
console.log("a"); <!-- un autre commentaire
console.log("b");
--> Plus de commentaires
// Affiche "a" et "b"

<!-- et --> agissent tous deux comme //, c'est--dire comme des commentaires sur une ligne. --> n'est valide qu'au dbut d'une ligne (pour viter toute ambigut avec un dcrment postfix suivi d'un oprateur suprieur), tandis que <!-- peut apparatre n'importe o dans la ligne.

Proprits de RegExp

Les proprits suivantes sont dprcies. Cela n'affecte pas leur utilisation dans les chanes de caractres de remplacement :

$1-$9

Sous-chanes de caractres entre parenthses, si elles existent.

input, $_

La chane de caractres par rapport laquelle une expression rationnelle est compare.

lastMatch, $&

La dernire sous-chane de caractres correspondante.

lastParen, $+

La dernire sous-chane de caractres entre parenthses, si elle existe.

leftContext, $`

La sous-chane de caractres prcdant la correspondance la plus rcente.

rightContext, $'

La sous-chane de caractres suivant la correspondance la plus rcente.

La mthode compile() est dprcie. Il est recommand de crer une nouvelle instance de RegExp la place.

Les syntaxes regex suivantes sont dprcies et ne sont disponibles qu'en mode insensible Unicode. En mode sensible Unicode, elles sont toutes des erreurs de syntaxe :

• Les assertions anticipes peuvent avoir des quantificateurs.
• Les rtro-rfrences qui ne se rfrent pas un groupe capturant existant deviennent des chappements octaux hrits.
• Dans les classes de caractres, les plages de caractres o une limite est une classe de caractres font que le - devient un caractre littral.
• Une squence d'chappement non reconnue devient un  chappement d'identit .
• Les squences d'chappement dans les classes de caractres de la forme \cX o X est un chiffre ou _ sont dcodes de la mme manire que celles avec des lettres ASCII : \c0 est identique \cP lorsqu'on prend le modulo 32. De plus, si la forme \cX est rencontre n'importe o o X n'est pas l'un des caractres reconnus, alors la barre oblique inverse est trait comme un caractre littral.
• La squence \k dans une regex qui n'a pas de groupes capturant nomms est traite comme un chappement d'identit.
• Les caractres de syntaxe ], {, et } peuvent apparatre littralement sans chappement s'ils ne peuvent pas tre interprts comme la fin d'une classe de caractres ou des dlimiteurs de quantificateur.

Proprits de Function

• La proprit caller des fonctions et la proprit arguments.callee sont dprcies et indisponibles en mode strict.
• Au lieu d'accder arguments en tant que proprit d'une fonction, vous devez utiliser l'objet arguments l'intrieur des fermetures de fonction.

Proprits et mthodes de Object

• L'accesseur Object.prototype.__proto__ est dprci. Utilisez Object.getPrototypeOf et Object.setPrototypeOf la place. Cela ne s'applique pas la cl littrale __proto__ dans les littraux d'objet.
• Les mthodes Object.prototype.__defineGetter__, Object.prototype.__defineSetter__, Object.prototype.__lookupGetter__ et Object.prototype.__lookupSetter__ sont dprcies. Utilisez Object.getOwnPropertyDescriptor et Object.defineProperty la place.

Proprits de String

• Les mthodes d'encapsulation HTML comme String.prototype.fontsize et String.prototype.big sont dprcies.
• String.prototype.substr n'est probablement pas supprime de sitt, mais elle est dfinie dans l'annexe B et est donc optionnelle sur le plan normatif.
• String.prototype.trimLeft et String.prototype.trimRight doivent tre remplacs par String.prototype.trimStart et String.prototype.trimEnd.

Mthodes de Date

• Les mthodes getYear() et setYear() sont affectes par le problme de l'an 2000 et ont t remplaces par getFullYear() et setFullYear().
• La mthode toGMTString() est dprcie. Utilisez toUTCString() la place.

Squences d'chappement

• Les squences d'chappement octales (\ suivies d'un, deux ou trois chiffres octaux) sont dprcies dans les littraux de chanes de caractres et d'expressions rationnelles.
• Les fonctions escape() et unescape() sont dprcies. Utilisez encodeURI(), encodeURIComponent(), decodeURI() ou decodeURIComponent() pour encoder et dcoder les squences d'chappement des caractres spciaux.

Instructions

L'instruction with est dprcie et indisponible en mode strict.

Les initialisateurs dans les dclarations var des en-ttes de boucles forin sont dprcis et produisent des erreurs de syntaxe en mode strict. L'expression d'initialisation est value et affecte la variable, mais la valeur est immdiatement raffecte lors de la premire itration de la boucle.

Normalement, le bloc catch d'une instruction trycatch ne peut contenir aucune dclaration de variable portant le mme nom que les variables lies dans le catch(). Une grammaire tendue permet au bloc catch de contenir une variable dclare avec var portant le mme nom que l'identifiant li au catch, mais uniquement si la liaison catch est un identifiant simple, et non un modle de dstructuration. Cependant, l'initialisation et l'affectation de cette variable n'agissent que sur l'identifiant li au catch, au lieu de la variable de porte suprieure, et le comportement peut tre droutant.

var a = 2;
try {
  throw new Error();
} catch (a) {
  var a = 1; // Cette valeur 1 est affecte  `a` qui est attrap, pas au `a` extrieur.
}
console.log(a); // 2

try {
  throw new Error();
  // Note : l'identifiant a t chang en `err` pour viter le conflit
  // avec la dclaration interne de `a`.
} catch (err) {
  var a = 1; // Cette valeur 1 est affecte  `a` de la porte suprieure.
}
console.log(a); // 1

Cela est rpertori dans l'annexe B de la spcification et peut donc ne pas tre implment partout. vitez tout conflit de noms entre l'identifiant li au catch et les variables dclares dans le bloc catch.

Fonctionnalits obsoltes

Ces fonctionnalits obsoltes ont t entirement supprimes de JavaScript et ne peuvent plus tre utilises partir de la version indique de JavaScript.

Proprits de RegExp

Les lments suivants sont dsormais des proprits des instances de RegExp, et non plus du constructeur RegExp :

La mthode valueOf() n'est plus spcialise pour RegExp. Elle utilise Object.prototype.valueOf(), qui retourne elle-mme.

Proprits de Function

• La proprit arity des fonctions est obsolte. Utilisez length la place.

Proprits de Object

Mthodes de String

• Les mthodes gnriques non standard de String comme String.slice(myStr, 0, 12), String.replace(myStr, /\./g, "!"), etc. ont t introduites dans Firefox 1.5 (JavaScript 1.6), dprcies dans Firefox 53 et supprimes dans Firefox 68. Vous pouvez utiliser les mthodes sur String.prototype avec Function.call() la place.
• String.prototype.quote a t supprim dans Firefox 37.
• Le paramtre non standard flags dans String.prototype.search, String.prototype.match, et String.prototype.replace est obsolte.

Mthodes de WeakMap

• WeakMap.prototype.clear() a t ajout dans Firefox 20 et supprim dans Firefox 46. Il n'est pas possible de parcourir toutes les cls dans un WeakMap.

Mthodes de Date

• Date.prototype.toLocaleFormat(), qui utilisait une chane de caractres de format dans le mme format attendu par la fonction strftime() en C, est obsolte. Utilisez toLocaleString() ou Intl.DateTimeFormat la place.

Mthodes de Array

• Les mthodes gnriques non standard de Array comme Array.slice(myArr, 0, 12), Array.forEach(myArr, myFn), etc. ont t introduites dans Firefox 1.5 (JavaScript 1.6), dprcies dans Firefox 68 et supprimes dans Firefox 71. Vous pouvez utiliser les mthodes sur Array.prototype avec Function.call() la place.

Mthodes de Number

• Number.toInteger() est obsolte. Utilisez Math.floor(), Math.round(), ou d'autres mthodes la place.

Mthodes de Proxy

• Proxy.create() et Proxy.createFunction() sont obsoltes. Utilisez le constructeur Proxy() la place.
• Les piges suivants sont obsoltes :
  • hasOwn (bogue 980565 (angl.), Firefox 33).
  • getEnumerablePropertyKeys (bogue 783829 (angl.), Firefox 37)
  • getOwnPropertyNames (bogue 1007334 (angl.), Firefox 33)
  • keys (bogue 1007334 (angl.), Firefox 33)

L'objet ParallelArray

• ParallelArray est obsolte.

Instructions

• for each...in est obsolte. Utilisez for...of la place.
• Les blocs let et les expressions let sont obsoltes.
• Les closures d'expression (function () 1 comme raccourci de function () { return 1; }) sont obsoltes. Utilisez des function rationnelles ou des fonctions flches la place.

Acquisition du texte source

Les mthodes toSource() des tableaux, nombres, chanes de caractres, etc. et la fonction globale uneval() sont obsoltes. Utilisez toString(), ou crivez votre propre mthode de srialisation la place.

Gnrateurs et itrateurs hrits

Les instructions de fonction gnratrice hrite et les expressions de fonction gnratrice hrite sont supprimes. La syntaxe de fonction gnratrice hrite rutilise le mot-cl function, qui devient automatiquement une fonction gnratrice lorsqu'il y a une ou plusieurs expressions yield dans le corps c'est maintenant une erreur de syntaxe. Utilisez les instructions function* et les expressions function* la place.

Les comprhensions de tableau et les comprhensions de gnrateur sont supprimes.

// Comprhensions de tableau hrites
[for (x of iterable) x]
[for (x of iterable) if (condition) x]
[for (x of iterable) for (y of iterable) x + y]

// Comprhensions de gnrateur hrites
(for (x of iterable) x)
(for (x of iterable) if (condition) x)
(for (x of iterable) for (y of iterable) x + y)

Firefox, avant la version 26, a implment un autre protocole d'itrateur similaire au protocole d'itration standard. Un objet est un itrateur hrite lorsqu'il implmente une mthode next(), qui produit une valeur chaque appel et lance un objet StopIteration la fin de l'itration. Ce protocole d'itrateur hrite diffre du protocole d'itrateur standard :

• La valeur tait retourne directement comme valeur de retour des appels next(), au lieu de la proprit value de l'objet IteratorResult.
• La fin de l'itration tait exprime en lanant un objet StopIteration, au lieu d'utiliser la proprit done de l'objet IteratorResult.

Cette fonctionnalit, ainsi que le constructeur global StopIteration, ont t supprims dans Firefox 58+. Pour les utilisations futures, envisagez d'utiliser les boucles forof et le protocole d'itration.

Variables dise

Les variables dise sont obsoltes. Pour crer des structures circulaires, utilisez plutt des variables temporaires.