Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / JavaScript

static — elementos estáticos de classe

`static` define campos, métodos e acessores que pertencem à própria classe, e não às suas instâncias. Um bloco `static { ... }` realiza a inicialização quando a classe é criada, sem chamar `new`.

Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaxe

class Name {
  static field = value;
  static method() { /* ... */ }
  static get property() { /* ... */ }
  static set property(value) { /* ... */ }
  static { /* initialization */ }
}

static antes de um campo, método ou acessor (get ou set) define um elemento no objeto construtor da classe, e não no seu protótipo nem nas instâncias. Usa Counter.next(), não new Counter().next(). static não significa constante: um campo estático gravável pode ser alterado. Os elementos estáticos também podem ser privados, com um nome iniciado por #.

Os inicializadores de campos estáticos e os blocos static { ... } são executados pela ordem do código durante a avaliação da definição da classe, e não em cada new. Dentro desse inicializador ou bloco, this refere-se à classe que está a ser definida. O bloco tem o seu próprio âmbito e não pode usar diretamente await nem yield.

Os elementos estáticos públicos são herdados pelas subclasses através da cadeia de protótipos dos construtores. Num método chamado como Child.method(), this é Child. Os elementos estáticos privados não são instalados nas subclasses; por isso, um método herdado que leia this.#field pode lançar um TypeError.

Em modo estrito, static não pode ser usado como identificador de variável, mas pode ser um nome de propriedade. Numa classe, static() {} declara um método de instância chamado static, não um método estático. Os métodos estáticos existem desde ECMAScript 2015; os campos estáticos e os blocos de inicialização, desde ECMAScript 2022. O suporte num determinado navegador tem de ser verificado separadamente; a versão de Node usada num repositório não o comprova.

Exemplos

class Counter {
  static value = 2;

  static {
    this.value *= 3;
  }

  static next() {
    return ++this.value;
  }
}

console.log(Counter.value);
console.log(Counter.next());
console.log(typeof new Counter().next);

Resultado

6
7
undefined

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes