Static initialization blocks

Try it

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"

Cú pháp

class ClassWithSIB {
  static {
    // …
  }
}

Mô tả

Nếu không có static initialization block, việc khởi tạo static phức tạp có thể được thực hiện bằng cách gọi một static method sau khai báo class:

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

MyClass.init();

Tuy nhiên, cách tiếp cận này làm lộ chi tiết triển khai (phương thức init()) cho người dùng class. Mặt khác, bất kỳ logic khởi tạo nào được khai báo bên ngoài class đều không có quyền truy cập vào private static field. Static initialization block cho phép logic khởi tạo tùy ý được khai báo trong class và thực thi trong quá trình đánh giá class.

Một class có thể có bất kỳ số lượng khối khởi tạo static {} nào trong thân class. Các khối này được đánh giá, cùng với bất kỳ static field initializer xen kẽ nào, theo thứ tự chúng được khai báo. Bất kỳ khởi tạo static nào của super class được thực hiện trước, trước khởi tạo của các subclass của nó.

Phạm vi của các biến được khai báo bên trong static block là cục bộ với block. Điều này bao gồm khai báo var, function, const, và let. Khai báo var sẽ không được hoist ra ngoài static block.

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'

this bên trong static block đề cập đến đối tượng constructor của class. super.property có thể được sử dụng để truy cập các thuộc tính static của super class. Tuy nhiên, lưu ý rằng đây là lỗi cú pháp khi gọi super() trong static initialization block của class, hoặc sử dụng đối tượng arguments.

Các câu lệnh được đánh giá đồng bộ. Bạn không thể sử dụng await hoặc yield trong block này. (Hãy nghĩ về các câu lệnh khởi tạo như được bao bọc ngầm trong một hàm.)

Phạm vi của static block được lồng trong phạm vi từ vựng của thân class, và có thể truy cập tên private được khai báo trong class mà không gây ra lỗi cú pháp.

Static field initializer và static initialization block được đánh giá lần lượt từng cái một. Khối khởi tạo có thể tham chiếu đến các giá trị field ở trên nó, nhưng không phải ở dưới. Tất cả static method được thêm vào trước và có thể được truy cập, mặc dù việc gọi chúng có thể không hoạt động như mong đợi nếu chúng tham chiếu đến các field ở dưới block hiện tại.

Static initialization block không thể có decorator (bản thân class có thể có).

Ví dụ

Nhiều block

Code dưới đây minh họa một class với các static initialization block và static field initializer xen kẽ. Đầu ra cho thấy các block và field được đánh giá theo thứ tự thực thi.

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'

Lưu ý rằng bất kỳ khởi tạo static nào của super class được thực hiện trước, trước khởi tạo của các subclass.

Sử dụng this và super

this bên trong static block đề cập đến đối tượng constructor của class. Code này cho thấy cách truy cập một public static field.

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

Cú pháp super.property có thể được sử dụng bên trong static block để tham chiếu đến các thuộc tính static của super class.

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

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

Truy cập private element

Ví dụ dưới đây cho thấy cách cấp quyền truy cập vào private instance field của một class từ một đối tượng bên ngoài class (ví dụ từ blog v8.dev):

let getDPrivateField;

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

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

Thông số kỹ thuật

Tương thích trình duyệt

Xem thêm

• Hướng dẫn Using classes
• Classes
• static
• class
• Class static initialization blocks on v8.dev (2021)
• ES2022 feature: class static initialization blocks by Dr. Axel Rauschmayer (2021)