Statische Initialisierungsblöcke

Probieren Sie es aus

class ClassWithStaticInitializationBlock {
  static staticProperty1 = "Property 1";
  static staticProperty2;
  static {
    this.staticProperty2 = "Property 2";
  }
}

console.log(ClassWithStaticInitializationBlock.staticProperty1);
// Expected output: "Property 1"
console.log(ClassWithStaticInitializationBlock.staticProperty2);
// Expected output: "Property 2"

Syntax

class ClassWithSIB {
  static {
    // …
  }
}

Beschreibung

Ohne statische Initialisierungsblöcke könnte eine komplexe statische Initialisierung durch den Aufruf einer statischen Methode nach der Klassendeklaration erreicht werden:

class MyClass {
  static init() {
    // Access to private static fields is allowed here
  }
}

MyClass.init();

Jedoch offenbart dieser Ansatz ein Implementierungsdetail (die init()-Methode) dem Nutzer der Klasse. Andererseits hat jede außerhalb der Klasse deklarierte Initialisierungslogik keinen Zugriff auf private statische Felder. Statische Initialisierungsblöcke erlauben es, beliebige Initialisierungslogik innerhalb der Klasse zu deklarieren und auszuführen, während die Klasse ausgewertet wird.

Eine Klasse kann beliebig viele static {}-Initialisierungsblöcke in ihrem Klassenkörper haben. Diese werden zusammen mit allen dazwischenliegenden statischen Feldinitialisierern in der Reihenfolge ausgewertet, in der sie deklariert sind. Jede statische Initialisierung einer Superklasse wird zuerst durchgeführt, vor der ihrer Unterklassen.

Der Gültigkeitsbereich der innerhalb des statischen Blocks deklarierten Variablen ist lokal für den Block. Dies schließt var, function, const und let Deklarationen ein. var Deklarationen werden nicht aus dem statischen Block herausgehoben.

var y = "Outer y";

class A {
  static field = "Inner y";
  static {
    // var y only hoisted inside block
    console.log(y); // undefined <-- not 'Outer y'

    var y = this.field;
  }
}

// var y defined in static block is not hoisted
// outside the block
console.log(y); // 'Outer y'

Das this innerhalb eines statischen Blocks bezieht sich auf das Konstruktorobjekt der Klasse. super.property kann verwendet werden, um auf statische Eigenschaften der Superklasse zuzugreifen. Es ist jedoch ein Syntaxfehler, super() in einem statischen Initialisierungsblock einer Klasse zu rufen oder das arguments-Objekt zu verwenden.

Die Anweisungen werden synchron ausgewertet. Sie können await oder yield in diesem Block nicht verwenden. (Stellen Sie sich die Initialisierungsanweisungen als implizit in eine Funktion eingerahmt vor.)

Der Gültigkeitsbereich des statischen Blocks ist innerhalb des lexikalischen Gültigkeitsbereichs des Klassenkörpers verschachtelt und kann auf private Namen zugreifen, die innerhalb der Klasse deklariert sind, ohne dass ein Syntaxfehler entsteht.

Statische Felder-Initialisierer und statische Initialisierungsblöcke werden nacheinander ausgewertet. Der Initialisierungsblock kann auf Feldwerte über ihm, aber nicht unter ihm verweisen. Alle statischen Methoden werden vorher hinzugefügt und können aufgerufen werden, obwohl ihr Verhalten möglicherweise nicht wie erwartet ist, wenn sie auf Felder unterhalb des aktuellen Blocks verweisen.

Ein statischer Initialisierungsblock darf keine Dekoratoren haben (die Klasse selbst darf).

Beispiele

Mehrere Blöcke

Der folgende Code demonstriert eine Klasse mit statischen Initialisierungsblöcken und dazwischenliegenden statischen Feldinitialisierern. Die Ausgabe zeigt, dass die Blöcke und Felder in Ausführungsreihenfolge ausgewertet werden.

class MyClass {
  static field1 = console.log("static field1");
  static {
    console.log("static block1");
  }
  static field2 = console.log("static field2");
  static {
    console.log("static block2");
  }
}
// 'static field1'
// 'static block1'
// 'static field2'
// 'static block2'

Beachten Sie, dass jede statische Initialisierung einer Superklasse zuerst durchgeführt wird, bevor die ihrer Unterklassen erfolgt.

Verwendung von this und super

Das this innerhalb eines statischen Blocks bezieht sich auf das Konstruktorobjekt der Klasse. Dieser Code zeigt, wie auf ein öffentliches statisches Feld zugegriffen werden kann.

class A {
  static field = "static field";
  static {
    console.log(this.field);
  }
}
// 'static field'

Die super.property-Syntax kann innerhalb eines static-Blocks verwendet werden, um auf statische Eigenschaften einer Superklasse zu verweisen.

class A {
  static field = "static field";
}

class B extends A {
  static {
    console.log(super.field);
  }
}
// 'static field'

Zugang zu privaten Elementen

Das untenstehende Beispiel zeigt, wie der Zugriff auf ein privates Instanzfeld einer Klasse aus einem Objekt außerhalb der Klasse gewährt werden kann (Beispiel vom v8.dev blog):

let getDPrivateField;

class D {
  #privateField;
  constructor(v) {
    this.#privateField = v;
  }
  static {
    getDPrivateField = (d) => d.#privateField;
  }
}

console.log(getDPrivateField(new D("private"))); // 'private'

Spezifikationen

Browser-Kompatibilität

Siehe auch

• Verwendung von Klassen Leitfaden
• Klassen
• static
• class
• Klassenstatische Initialisierungsblöcke auf v8.dev (2021)
• ES2022 Feature: Klassenstatische Initialisierungsblöcke von Dr. Axel Rauschmayer (2021)