Diese Seite listet Funktionen von JavaScript auf, die veraltet (d.h. noch verfügbar, aber zur Entfernung vorgesehen) und obsolet sind (d.h. nicht mehr verwendbar).

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 imAnhang 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:

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

<!-- 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 inErsetzungs-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 Methodecompile() ist veraltet. Konstruieren Sie stattdessen eine neueRegExp-Instanz.

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

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

Function

• Diecaller-Eigenschaft von Funktionen und diearguments.callee-Eigenschaft sind veraltet und im strengen Modus nicht verfügbar.
• Anstattarguments als Eigenschaft einer Funktion zuzugreifen, sollten Sie dasarguments-Objekt innerhalb von Funktionsschließungen verwenden.

Object

• DieObject.prototype.__proto__-Zugriffsmethoden sind veraltet. Verwenden Sie stattdessenObject.getPrototypeOf undObject.setPrototypeOf. Dies gilt nicht für den__proto__ literalen Schlüssel in Objektdarstellungen.
• Die MethodenObject.prototype.__defineGetter__,Object.prototype.__defineSetter__,Object.prototype.__lookupGetter__ undObject.prototype.__lookupSetter__ sind veraltet. Verwenden Sie stattdessenObject.getOwnPropertyDescriptor undObject.defineProperty.

String

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

Date

• Die MethodengetYear() undsetYear() sind vom Jahr-2000-Problem betroffen und wurden durchgetFullYear undsetFullYear ersetzt.
• Die MethodetoGMTString() ist veraltet. Verwenden Sie stattdessentoUTCString().

Escape-Sequenzen

• Oktale Escape-Sequenzen (\ gefolgt von einer, zwei oder drei Oktalziffern) sind in String- und regulären Ausdruckliteralen veraltet.
• Die Funktionenescape() undunescape() sind veraltet. Verwenden SieencodeURI(),encodeURIComponent(),decodeURI() oderdecodeURIComponent(), um Escape-Sequenzen für Sonderzeichen zu kodieren und zu dekodieren.

Anweisungen

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

Initialisierer in denvar-Deklarationen von Schleifen-Headernfor...in sind veraltet und erzeugenSyntaxfehler 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 dercatch-Block einertry...catch-Anweisung keine Variablendeklaration mit demselben Namen wie die ancatch() gebundenen Variablen enthalten. Eine erweiterte Grammatik ermöglicht es demcatch-Block, eine mitvar deklarierte Variable mit demselben Namen wie dercatch-gebundene Bezeichner zu enthalten, jedoch nur, wenn diecatch-Bindung ein einfacher Bezeichner ist, keinDestrukturierungsmuster. Die Initialisierung und Zuweisung dieser Variablen würde jedoch nur auf dencatch-gebundenen Bezeichner wirken, anstelle der übergeordneten Variablen, was verwirrend sein könnte.

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); // 2try {  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 Namenskonflikte zwischen demcatch-gebundenen Bezeichner und Variablen, die imcatch-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 vonRegExp-Instanzen, nicht länger desRegExp-Konstruktors:

DievalueOf()-Methode ist nicht mehr speziell fürRegExp. Sie verwendetObject.prototype.valueOf(), welche das Objekt selbst zurückgibt.

Function

• Diearity-Eigenschaft von Funktionen ist obsolet. Verwenden Sie stattdessenlength.

Object

String

• Nicht standardisierte, generische Methoden für Strings wieString.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 aufString.prototype zusammen mitFunction.call verwenden.
• String.prototype.quote wurde in Firefox 37 entfernt.
• Nicht standardisierterflags-Parameter inString.prototype.search,String.prototype.match, undString.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 einerWeakMap zu durchlaufen.

Date

• Date.prototype.toLocaleFormat(), welches ein Format-String verwendete, der im gleichen Format wie diestrftime()-Funktion in C erwartet wurde, ist obsolet. Verwenden SietoLocaleString() oderIntl.DateTimeFormat.

Array

• Nicht standardisierte, generische Methoden für Arrays wieArray.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 aufArray.prototype zusammen mitFunction.call verwenden.

Number

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

Proxy

• Proxy.create undProxy.createFunction sind obsolet. Verwenden Sie denProxy()-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 Siefor...of stattdessen.
• Let-Blöcke und Let-Ausdrücke sind obsolet.
• Ausdrucksabschlüsse (function () 1 als Abkürzung fürfunction () { return 1; }) sind obsolet. Verwenden Sie regulärefunctions oderarrow functions stattdessen.

Erwerb von Quelltext

DietoSource()-Methoden von Arrays, Zahlen, Strings usw. und dieuneval()-globale Funktion sind obsolet. Verwenden SietoString() oder schreiben Sie Ihre eigene Serialisierungsmethode.

Legacy-Generator und -Iterator

Legacy-Generator-Funktionsanweisungen und -Ausdrücke wurden entfernt. Die Syntax der alten Generatorfunktionen nutzt dasfunction-Schlüsselwort, welches automatisch zu einer Generatorfunktion wird, wenn es ein oder mehrereyield-Ausdrücke im Körper gibt — dies ist jetzt ein Syntaxfehler. Verwenden Siefunction*-Anweisungen undfunction*-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, implementierte ein weiteres Iterato-Protokoll, das dem StandardIterator-Protokoll ähnlich ist. Ein Objekt ist ein veralteter Iterator, wenn es einenext()-Methode implementiert, die bei jedem Aufruf einen Wert erzeugt und am Ende der Iteration einStopIteration-Objekt auslöst. Dieses veraltete Iterator-Protokoll unterscheidet sich vom Standard-Iterator-Protokoll:

• Der Wert wurde direkt als Rückgabewert von Aufrufen annext() zurückgegeben, anstatt dervalue-Eigenschaft desIteratorResult-Objekts.
• Die Terminierung der Iteration wurde durch das Werfen einesStopIteration-Objekts ausgedrückt, anstelle durch diedone-Eigenschaft desIteratorResult-Objekts.

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

Sharp-Variablen

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