Veraltete und obsolete Funktionen

Veraltete Funktionen

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

Einige dieser veralteten Funktionen sind im Anhang B der ECMAScript-Spezifikation aufgeführt. Dieser Abschnitt wird als normativ optional beschrieben — das heißt, Hosts von Webbrowsern müssen diese Funktionen implementieren, während Nicht-Web-Hosts dies möglicherweise nicht tun. Diese Funktionen sind wahrscheinlich stabil, da ihre Entfernung Rückwärtskompatibilitätsprobleme verursachen und alte Websites beschädigen würde. (JavaScript hat das Designziel "Das Web nicht zerstören".) Trotzdem sind sie nicht plattformübergreifend portabel und werden möglicherweise nicht von allen Analysetools unterstützt, daher wird Ihnen geraten, sie nicht zu verwenden, wie die Einführung von Anhang B besagt:

… Alle in diesem Anhang spezifizierten Sprachfunktionen und Verhaltensweisen weisen eine oder mehrere unerwünschte Eigenschaften auf und würden ohne die Existenz von Altnutzung aus dieser Spezifikation entfernt werden. …

… Programmierer sollten diese Funktionen und Verhaltensweisen nicht verwenden oder deren Existenz beim Schreiben von neuem ECMAScript-Code annehmen. …

Einige andere, die im Hauptteil der Spezifikation stehen, sind ebenfalls als normativ optional gekennzeichnet und sollten nicht als gegeben vorausgesetzt werden.

HTML-Kommentare

JavaScript-Quellcode, sofern er als Skripte geparst wird, erlaubt HTML-ähnliche Kommentare, als ob das Skript Teil eines <script>-Tags ist.

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

<!-- und --> wirken beide wie //, d.h. als Beginn von Zeilenkommentaren. --> ist nur am Beginn einer Zeile gültig (um Mehrdeutigkeiten mit einem nachfolgenden größer-als-Operator zu vermeiden), während <!-- überall in der Zeile vorkommen kann.

RegExp

Die folgenden Eigenschaften sind veraltet. Dies beeinflusst nicht ihre Verwendung in Ersetzungs-Strings:

$1–$9

Klammerausdrücke, wenn vorhanden.

input, $_

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

lastMatch, $&

Der zuletzt gefundene Teilstring.

lastParen, $+

Der letzte Klammerausdruck, falls vorhanden.

leftContext, $`

Der Teilstring, der dem jüngsten Match voransteht.

rightContext, $'

Der Teilstring, der dem jüngsten Match folgt.

Die Methode compile() ist veraltet. Konstruieren Sie stattdessen eine neue RegExp-Instanz.

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

• Lookahead-Bedingungen können Quantoren haben.
• Backreferences, die sich nicht auf eine bestehende Fängergruppe beziehen, werden zu veralteten Oktal-Escapes.
• In Zeichenklassen werden Zeichenbereiche, bei denen 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 dieselbe Weise dekodiert wie bei ASCII-Buchstaben: \c0 ist dasselbe wie \cP, wenn es modulo 32 betrachtet wird. Außerdem wird, wenn ein \cX auftritt, bei dem X nicht zu den anerkannten Zeichen gehört, der Backslash als literal angesehen.
• Die Sequenz \k innerhalb eines Regex, das keine benannten Fängergruppen hat, wird als Identitäts-Escape behandelt.
• Die Syntaxzeichen ], { und } können wörtlich ohne Escape erscheinen, wenn sie nicht als Ende von Zeichenklassen- oder Quantifizierungsbegrenzer interpretiert werden können.

Function

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

Object

• Die Object.prototype.__proto__-Zugriffsmethoden sind veraltet. Verwenden Sie stattdessen Object.getPrototypeOf und Object.setPrototypeOf. Dies gilt nicht für den __proto__ literalen Schlüssel in Objektdarstellungen.
• 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.

String

• HTML-Wrapper-Methoden wie String.prototype.fontsize und String.prototype.big.
• String.prototype.substr wird wahrscheinlich nicht bald entfernt, aber sie 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.

Date

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

Escape-Sequenzen

• Oktale Escape-Sequenzen (\ gefolgt von einer, zwei oder drei Oktalziffern) sind in String- und regulären Ausdruckliteralen 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.

Anweisungen

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

Initialisierer in den var-Deklarationen von Schleifen-Headern for...in sind veraltet und erzeugen Syntaxfehler im strengen Modus. Der Initialisierungs-Ausdruck wird ausgewertet und der Variable zugewiesen, aber der Wert würde bei der ersten Iteration der Schleife sofort erneut zugewiesen werden.

Normalerweise kann der catch-Block einer try...catch-Anweisung keine Variablendeklaration mit demselben Namen wie die an catch() gebundenen Variablen enthalten. Eine erweiterte Grammatik ermöglicht es dem catch-Block, eine mit var deklarierte Variable mit demselben Namen wie der catch-gebundene Bezeichner zu enthalten, jedoch nur, wenn die catch-Bindung ein einfacher Bezeichner ist, kein Destrukturierungsmuster. Die Initialisierung und Zuweisung dieser Variablen würde jedoch nur auf den catch-gebundenen Bezeichner wirken, anstelle der übergeordneten Variablen, was verwirrend sein könnte.

Dies ist im Anhang B der Spezifikation aufgeführt und daher möglicherweise nicht überall implementiert. Vermeiden Sie Namenskonflikte zwischen dem catch-gebundenen Bezeichner und Variablen, die im catch-Block deklariert sind.

Obsolete Funktionen

Diese obsoleten Funktionen wurden vollständig aus JavaScript entfernt und können nicht mehr in der angegebenen JavaScript-Version verwendet werden.

RegExp

Die folgenden sind nun Eigenschaften von RegExp-Instanzen, nicht länger des RegExp-Konstruktors:

Eigenschaft Beschreibung

global	Ob der reguläre Ausdruck auf alle möglichen Übereinstimmungen in einem String getestet wird oder nur auf die erste.
ignoreCase	Ob Groß- und Kleinschreibung bei einem Match in einem String ignoriert wird.
lastIndex	Der Index, bei dem das nächste Match startet.
multiline (auch über RegExp.$*)	Ob in Strings über mehrere Zeilen hinweg gesucht wird.
source	Der Text des Musters.

Die valueOf()-Methode ist nicht mehr speziell für RegExp. Sie verwendet Object.prototype.valueOf(), welche das Objekt selbst zurückgibt.

Function

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

Object

Eigenschaft Beschreibung Alternative

__count__	Gibt die Anzahl der aufzählbaren Eigenschaften eines benutzerdefinierten Objekts zurück.	Object.keys()
__parent__	Verweist auf den Kontext eines Objekts.	Kein direkter Ersatz
__iterator__	Wird mit veralteten Iteratoren verwendet.	Symbol.iterator und die neuen Iteration-Standards
__noSuchMethod__	Eine Methode, die aufgerufen wird, wenn eine nicht existente Eigenschaft als Methode aufgerufen wird.	Proxy
Object.prototype.eval()	Bewertet einen String mit JavaScript-Code im Kontext des spezifizierten Objekts.	Kein direkter Ersatz
Object.observe()	Asynchrones Beobachten von Änderungen an einem Objekt.	Proxy
Object.unobserve()	Entfernt Beobachter.	Proxy
Object.getNotifier()	Erstellt ein Benachrichtigungsobjekt, das ermöglicht, eine Änderungsbenachrichtigung mit Object.observe() synthetisch auszulösen.	Kein direkter Ersatz
Object.prototype.watch()	Fügt eine Handler-Funktion an eine Eigenschaft an, die aufgerufen wird, wenn der Eigenschaft ein Wert zugewiesen wird.	Proxy
Object.prototype.unwatch()	Entfernt Überwachungs-Handler von einer Eigenschaft.	Proxy

String

• Nicht standardisierte, generische Methoden für Strings wie String.slice(myStr, 0, 12), String.replace(myStr, /\./g, "!"), usw. wurden in Firefox 1.5 (JavaScript 1.6) eingeführt, in Firefox 53 als veraltet markiert 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 standardisierter flags-Parameter in String.prototype.search, String.prototype.match, und String.prototype.replace sind obsolet.

WeakMap

• 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

• Date.prototype.toLocaleFormat(), welches ein Format-String verwendete, der im gleichen Format wie die strftime()-Funktion in C erwartet wurde, ist obsolet. Verwenden Sie toLocaleString() oder Intl.DateTimeFormat.

Array

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

Eigenschaft Beschreibung Alternative

Array.observe()	Asynchrones Beobachten von Änderungen an Arrays.	Proxy
Array.unobserve()	Entfernt Beobachter.	Proxy

Number

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

Proxy

• Proxy.create und Proxy.createFunction sind obsolet. Verwenden Sie den Proxy()-Konstruktor.
• 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

• ParallelArray ist obsolet.

Anweisungen

• for each...in ist obsolet. Verwenden Sie for...of stattdessen.
• Let-Blöcke und Let-Ausdrücke sind obsolet.
• Ausdrucksabschlüsse (function () 1 als Abkürzung für function () { return 1; }) sind obsolet. Verwenden Sie reguläre functions oder arrow functions stattdessen.

Erwerb von Quelltext

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

Legacy-Generator und -Iterator

Legacy-Generator-Funktionsanweisungen und -Ausdrücke wurden entfernt. Die Syntax der alten Generatorfunktionen nutzt das function-Schlüsselwort, welches 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.

Firefox, vor Version 26, implementierte ein weiteres Iterato-Protokoll, 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 erzeugt und am Ende der Iteration ein StopIteration-Objekt auslöst. Dieses veraltete Iterator-Protokoll unterscheidet sich vom Standard-Iterator-Protokoll:

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

Diese Funktion wurde zusammen mit dem StopIteration-globale Konstruktor in Firefox 58+ entfernt. Für zukunftsgerichtete Verwendungen erwägen Sie, for...of-Schleifen und das Iterator-Protokoll zu verwenden.

Sharp-Variablen

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