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

CKTIS / JavaScript

this — um valor determinado pelo contexto da chamada

A palavra-chave `this` lê a vinculação `this` atual. Numa função comum, o seu valor depende da forma como a função é chamada, enquanto uma função seta usa a vinculação do contexto envolvente. Guardar uma função num objeto não a associa permanentemente a esse objeto.

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

this
this.property
this[expression]

this é uma palavra-chave e uma expressão, não uma variável comum nem o nome da função. Lê a vinculação this atual; não é possível atribuir-lhe um valor com this = value. Não tem necessariamente de se referir a um objeto.

Numa função comum não associada, obj.method() fornece obj como valor de this. Depois de const f = obj.method, a chamada f() não mantém esse recetor. Numa função em modo estrito, this passa então a ser undefined; fora do modo estrito, undefined e null são substituídos pelo valor global de this, e os valores primitivos são convertidos em objetos wrapper.

call e apply fornecem um this explícito, enquanto bind cria uma função com this associado para chamadas comuns. Uma função seta não tem uma vinculação this própria: usa a do contexto envolvente, pelo que estes métodos não a podem alterar. Guardar uma função seta como propriedade de um objeto não faz com que esse objeto passe a ser o seu this.

Com new, um construtor comum recebe um novo objeto como this. No construtor de uma classe derivada, não é permitido aceder a this antes de super(). No nível superior de um módulo, this é undefined; num script normal, é o valor global de this. Não aplique automaticamente esta suposição a módulos envolvidos pelo ambiente anfitrião.

O exemplo mostra o recetor de um método, a sua perda quando a função é desligada, a escolha explícita através de call e o this lexical de uma função seta. Usa sintaxe ECMAScript 2015 e não requer APIs do navegador.

Exemplos

"use strict";

const box = {
  value: 7,
  read() {
    return this === undefined ? "no receiver" : this.value;
  },
  makeReader() {
    return () => this.value;
  }
};

const detached = box.read;
const reader = box.makeReader();

console.log(box.read());
console.log(detached());
console.log(detached.call({ value: 9 }));
console.log(reader.call({ value: 99 }));

Resultado

7
no receiver
9
7

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