Veraltete und obsolet gewordene Funktionen

Diese veralteten Funktionen können noch verwendet werden, sollten jedoch mit Vorsicht eingesetzt werden, da sie nicht von jedem JavaScript-Motor implementiert werden müssen. Sie sollten daran arbeiten, deren Verwendung aus Ihrem Code zu entfernen.

Einige dieser veralteten Funktionen sind im Abschnitt Anhang B der ECMAScript-Spezifikation aufgeführt. Dieser Abschnitt wird als normative optional beschrieben — das heißt, Webbrowser-Hosts müssen diese Funktionen implementieren, während nicht-webbasierte Hosts dies möglicherweise nicht tun. Diese Funktionen sind wahrscheinlich stabil, da ihre Entfernung Rückwärtskompatibilitätsprobleme verursachen und alte Websites beeinträchtigen würde. (JavaScript hat das Designziel „das Web nicht brechen“.) Dennoch sind sie nicht plattformübergreifend portabel und möglicherweise nicht von allen Analysetools unterstützt, daher wird empfohlen, sie nicht zu verwenden, wie die Einleitung von Anhang B besagt:

… Alle in diesem Anhang spezifizierten Sprachfunktionen und Verhaltensweisen haben eine oder mehrere unerwünschte Eigenschaften und würden in Ermangelung von Altverwendungen aus dieser Spezifikation entfernt werden. ...

… Programmierer sollten diese Funktionen und Verhaltensweisen nicht verwenden oder ihre Existenz annehmen, wenn sie neuen ECMAScript-Code schreiben. ...

Einige andere, obwohl im Hauptkörper der Spezifikation, sind ebenfalls als normative optional markiert und sollten nicht verwendet werden.

JavaScript-Quellcode, wenn als Skripte geparst, erlaubt HTML-ähnliche Kommentare, als ob das Skript Teil eines <script>-Tags wäre.

Das Folgende ist gültiges JavaScript, wenn es in einem Webbrowser (oder Node.js, das die V8-Engine von Chrome nutzt) ausgeführt wird:

<!-- comment
console.log("a"); <!-- another comment
console.log("b");
--> More comment
// Logs "a" and "b"

<!-- und --> wirken beide wie //, d.h. sie beginnen Zeilenkommentare. --> ist nur am Anfang einer Zeile gültig (um Mehrdeutigkeiten mit einem Postfix-Decrement gefolgt von einem Größer-als-Operator zu vermeiden), während <!-- überall in der Zeile auftreten kann.

Die folgenden Eigenschaften sind veraltet. Dies beeinträchtigt nicht ihre Verwendung in Ersatz-Strings:

$1–$9

Klammerausdrücke-Übereinstimmungen, falls vorhanden.

input, $_

Der String, gegen den ein regulärer Ausdruck abgeglichen wird.

lastMatch, $&

Der zuletzt abgeglichene Teilstring.

lastParen, $+

Der letzte klammernde Teilstring-Abgleich, falls vorhanden.

leftContext, $`

Der Teilstring, der dem neuesten Abgleich vorausgeht.

rightContext, $'

Der Teilstring, der dem neuesten Abgleich folgt.

Die Methode compile() ist veraltet. Erstellen Sie stattdessen eine neue Instanz von RegExp.

Die folgenden Regex-Syntaxen sind veraltet und nur im Unicode-unbewussten Modus verfügbar. Im Unicode-bewussten Modus sind sie alle Syntaxfehler:

• Lookahead-Assertions können Quantoren haben.
• Rückverweise, die sich nicht auf eine bestehende Klammergruppe beziehen, werden zu alten oktalen Escapezeichen.
• In Zeichenklassen wird ein Zeichenbereich, bei dem eine Grenze eine Zeichenklasse ist, das - zu einem literalen Zeichen.
• Eine nicht erkannte Escape-Sequenz wird zu einem "Identitäts-Escape".
• Escape-Sequenzen innerhalb von Zeichenklassen der Form \cX, bei denen X eine Zahl oder _ ist, werden auf die gleiche Weise dekodiert wie solche mit ASCII-Buchstaben: \c0 ist dasselbe wie \cP, wenn es modulo 32 genommen wird. Wenn die Form \cX jedoch irgendwo auftritt, wo X nicht zu den anerkannten Zeichen gehört, wird der Backslash als literales Zeichen behandelt.
• Die Sequenz \k innerhalb eines Regex, das keine benannten Klammergruppen hat, wird als Identitäts-Escape behandelt.
• Die Syntaxzeichen ], { und } können buchstäblich erscheinen, ohne dass sie maskiert werden müssen, wenn sie nicht als Ende einer Zeichenklasse oder Quantifizierer-Grenze interpretiert werden können.

• Die caller-Eigenschaft von Funktionen und die arguments.callee-Eigenschaft sind veraltet und im Strikten Modus nicht verfügbar.
• Anstatt auf arguments als Eigenschaft einer Funktion zuzugreifen, sollten Sie das arguments-Objekt innerhalb von Funktionskapselungen verwenden.

• Die Object.prototype.__proto__-Zugriffsmethoden sind veraltet. Verwenden Sie stattdessen Object.getPrototypeOf und Object.setPrototypeOf. Dies gilt nicht für den __proto__-Literal-Schlüssel in Objekt-Literalen.
• Die Methoden Object.prototype.__defineGetter__, Object.prototype.__defineSetter__, Object.prototype.__lookupGetter__, und Object.prototype.__lookupSetter__ sind veraltet. Verwenden Sie stattdessen Object.getOwnPropertyDescriptor und Object.defineProperty.

• HTML-Wrapper-Methoden wie String.prototype.fontsize und String.prototype.big.
• String.prototype.substr wird wahrscheinlich nicht bald entfernt, aber es ist in Anhang B definiert und daher normativ optional.
• String.prototype.trimLeft und String.prototype.trimRight sollten durch String.prototype.trimStart und String.prototype.trimEnd ersetzt werden.

• Die Methoden getYear() und setYear() sind vom Jahr-2000-Problem betroffen und wurden von getFullYear und setFullYear abgelöst.
• Die Methode toGMTString() ist veraltet. Verwenden Sie stattdessen toUTCString().

• Oktale Escape-Sequenzen (\ gefolgt von einer, zwei oder drei oktalen Ziffern) sind in String- und regulären Ausdrucksliteralen veraltet.
• Die Funktionen escape() und unescape() sind veraltet. Verwenden Sie encodeURI(), encodeURIComponent(), decodeURI(), oder decodeURIComponent(), um Escape-Sequenzen für Sonderzeichen zu kodieren und zu dekodieren.

Die with-Anweisung ist veraltet und im Strikten Modus nicht verfügbar.

Initialisierungen in var-Deklarationen von for...in-Schleifen-Headern sind veraltet und erzeugen Syntaxfehler im Strikten Modus. Der Initialisierungsausdruck wird evaluiert und der Variablen zugewiesen, aber der Wert würde sofort bei der ersten Schleifeniteration wieder zugewiesen.

Normalerweise kann der catch-Block einer try...catch-Anweisung keine Variablendeklaration mit demselben Namen enthalten wie die im catch() gebundenen Variablen. Eine Erweiterungsgrammatik erlaubt dem catch-Block, eine var-deklarierte Variable mit demselben Namen wie den catch-gebundenen Bezeichner zu enthalten, aber nur, wenn die catch-Bindung ein einfacher Bezeichner ist, kein Destrukturierungsmuster. Allerdings würde die Initialisierung und Zuweisung dieser Variablen nur auf den catch-gebundenen Bezeichner wirken, anstatt auf die oberhalb befindliche Variablen, und das Verhalten könnte verwirrend sein.

var a = 2;
try {
  throw new Error();
} catch (a) {
  var a = 1; // This 1 is assigned to the caught `a`, not the outer `a`.
}
console.log(a); // 2

try {
  throw new Error();
  // Note: identifier changed to `err` to avoid conflict with
  // the inner declaration of `a`.
} catch (err) {
  var a = 1; // This 1 is assigned to the upper-scope `a`.
}
console.log(a); // 1

Dies ist im Anhang B der Spezifikation aufgeführt und daher möglicherweise nicht überall implementiert. Vermeiden Sie jegliche Namenskonflikte zwischen dem catch-gebundenen Bezeichner und innerhalb des catch-Blocks deklarierten Variablen.

Diese obsoleten Funktionen wurden komplett aus JavaScript entfernt und können ab der angegebenen Version von JavaScript nicht mehr verwendet werden.

Die folgenden sind jetzt Eigenschaften von RegExp-Instanzen, nicht mehr des RegExp-Konstruktors:

Die Methode valueOf() ist nicht mehr speziell für RegExp. Sie verwendet Object.prototype.valueOf(), die sich selbst zurückgibt.

• Die Eigenschaft arity von Funktionen ist obsolet. Verwenden Sie stattdessen length.

• Nicht-standardisierte generische String-Methoden wie String.slice(myStr, 0, 12), String.replace(myStr, /\./g, "!"), usw. wurden in Firefox 1.5 (JavaScript 1.6) eingeführt, in Firefox 53 für veraltet erklärt und in Firefox 68 entfernt. Sie können Methoden auf String.prototype zusammen mit Function.call verwenden.
• String.prototype.quote wurde in Firefox 37 entfernt.
• Nicht-standardisierte flags-Parameter in String.prototype.search, String.prototype.match, und String.prototype.replace sind obsolet.

• WeakMap.prototype.clear() wurde in Firefox 20 hinzugefügt und in Firefox 46 entfernt. Es ist nicht möglich, alle Schlüssel in einer WeakMap zu durchlaufen.

• Date.prototype.toLocaleFormat(), das ein Formatstring im gleichen Format wie die von der C-Funktion strftime() erwarteten verwendete, ist obsolet. Verwenden Sie toLocaleString() oder Intl.DateTimeFormat stattdessen.

• Nicht-standardisierte generische Array-Methoden wie Array.slice(myArr, 0, 12), Array.forEach(myArr, myFn), usw. wurden in Firefox 1.5 (JavaScript 1.6) eingeführt, in Firefox 68 für veraltet erklärt und in Firefox 71 entfernt. Sie können Methoden auf Array.prototype zusammen mit Function.call verwenden.

• Number.toInteger() ist obsolet. Verwenden Sie stattdessen Math.floor, Math.round oder andere Methoden.

• Proxy.create und Proxy.createFunction sind obsolet. Verwenden Sie den Proxy()-Konstruktor stattdessen.
• Die folgenden Traps sind obsolet:
  • hasOwn (Bug 980565, Firefox 33).
  • getEnumerablePropertyKeys (Bug 783829, Firefox 37)
  • getOwnPropertyNames (Bug 1007334, Firefox 33)
  • keys (Bug 1007334, Firefox 33)

• ParallelArray ist obsolet.

• for each...in ist obsolet. Verwenden Sie for...of stattdessen.
• let-Blöcke und let-Ausdrücke sind obsolet.
• Ausdrucksverschlüsse (function () 1 als Kurzform für function () { return 1; }) sind obsolet. Verwenden Sie reguläre Funktionen oder Pfeilfunktionen stattdessen.

Die toSource()-Methoden von Arrays, Zahlen, Strings, etc. und die globale Funktion uneval() sind obsolet. Verwenden Sie toString(), oder schreiben Sie Ihre eigene Serialisierungs-Methode.

Veraltete Generatorfunktionsdeklarationen und veraltete Generatorfunktionsausdrücke sind entfernt. Die veraltete Generatorfunktionssyntax verwendet das Schlüsselwort function, das automatisch zu einer Generatorfunktion wird, wenn es ein oder mehrere yield-Ausdrücke im Körper gibt — dies ist jetzt ein Syntaxfehler. Verwenden Sie function*-Anweisungen und function*-Ausdrücke stattdessen.

Array-Komprehensionen und Generator-Komprehensionen sind entfernt.

// Legacy array comprehensions
[for (x of iterable) x]
[for (x of iterable) if (condition) x]
[for (x of iterable) for (y of iterable) x + y]

// Legacy generator comprehensions
(for (x of iterable) x)
(for (x of iterable) if (condition) x)
(for (x of iterable) for (y of iterable) x + y)

Firefox, vor Version 26, implementiert ein weiteres Iterationsprotokoll, das dem Standard-|iterator-Protokoll ähnlich ist. Ein Objekt ist ein veralteter Iterator, wenn es eine next()-Methode implementiert, die bei jedem Aufruf einen Wert produziert und bei Beendigung der Iteration ein StopIteration-Objekt wirft. Dieses veraltete Iteratorprotokoll unterscheidet sich vom Standard-Iteratorprotokoll:

• Der Wert wurde direkt als Rückgabewert von Aufrufen an next() zurückgegeben, anstatt als value-Eigenschaft des IteratorResult-Objekts.
• Iterationsbeendigung wurde durch das Werfen eines StopIteration-Objekts ausgedrückt, anstatt durch die done-Eigenschaft des IteratorResult-Objekts.

Diese Funktion, zusammen mit dem globalen Konstruktor StopIteration, wurde in Firefox 58+ entfernt. Für zukunftsgewandte Anwendungen ziehen Sie in Betracht, Schleifen mit for...of und das Iteratorprotokoll zu verwenden.

Scharfe Variablen sind obsolet. Um zirkuläre Strukturen zu erstellen, verwenden Sie stattdessen temporäre Variablen.